Search API

Search the web using 70+ engines in a single API call. Optionally scrape full content from results.

Search

POST /api/v1/search/

Headers

Header	Required	Description
`X-API-Key`	Yes	Your API key
`Content-Type`	Yes	`application/json`

Body Parameters

Parameter	Type	Default	Description
`query`	string	required	Search query
`engines`	string[]	`["google", "bing", "duckduckgo"]`	Search engines to use
`max_results`	integer	`10`	Max results (1-100)
`scrape_content`	boolean	`true`	Extract full page content
`output_format`	string	`"json"`	`"json"` or `"markdown"`
`language`	string	`"en"`	Language code
`safe_search`	string	`"moderate"`	`"strict"`, `"moderate"`, or `"off"`
`cache_ttl`	integer	`3600`	Cache time-to-live in seconds
`js_mode`	boolean	`false`	Enable JavaScript rendering
`relevance_filter`	boolean	`true`	Filter low-relevance results
`min_relevance_score`	number	`0.15`	Minimum relevance score (0-1)
`include_images`	boolean	`true`	Include images from results
`include_links`	boolean	`true`	Include links from results
`timeout`	integer	`30`	Request timeout in seconds
`async_mode`	boolean	`false`	Run asynchronously
`webhook_url`	string	—	Webhook for async results

Example Request

curl -X POST 'https://api.unsearch.dev/api/v1/search/' \
  -H 'X-API-Key: sk_live_xxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "latest AI frameworks 2025",
    "engines": ["google", "bing", "duckduckgo"],
    "max_results": 10,
    "scrape_content": true
  }'

Response

{
  "search_metadata": {
    "query": "latest AI frameworks 2025",
    "engines_used": ["google", "bing", "duckduckgo"],
    "engines_succeeded": ["google", "bing", "duckduckgo"],
    "engines_failed": [],
    "total_results_found": 30,
    "results_returned": 10,
    "search_time_ms": 287,
    "timestamp": "2025-03-01T12:00:00Z",
    "relevance_filtered": true
  },
  "results": [
    {
      "rank": 1,
      "title": "Top AI Frameworks for 2025",
      "url": "https://example.com/ai-frameworks",
      "snippet": "A comprehensive guide to the best AI frameworks...",
      "engine": "google",
      "score": 0.95,
      "scraped_content": {
        "url": "https://example.com/ai-frameworks",
        "title": "Top AI Frameworks for 2025",
        "text": "Full page content here...",
        "images": [],
        "links": [],
        "word_count": 1234,
        "extraction_success": true,
        "extraction_time_ms": 450,
        "content_quality_score": 0.87
      }
    }
  ],
  "processing_time_ms": 1250,
  "cached": false,
  "total_results": 10,
  "request_id": "req_abc123"
}

Batch Search

POST /api/v1/search/batch

Search multiple queries in parallel.

Body Parameters

Parameter	Type	Default	Description
`queries`	string[]	required	List of queries (1-100)
`engines`	string[]	`["google"]`	Engines to use
`max_results_per_query`	integer	`10`	Max results per query
`scrape_content`	boolean	`false`	Scrape content
`parallel_requests`	integer	`5`	Parallel request limit

Response

{
  "batch_id": "batch_xyz789",
  "queries_processed": 3,
  "queries_failed": 0,
  "results": {
    "query 1": [{ "title": "...", "url": "...", "snippet": "..." }],
    "query 2": [{ "title": "...", "url": "...", "snippet": "..." }]
  },
  "processing_time_ms": 2100,
  "errors": {}
}

List Engines

GET /api/v1/search/engines

Returns all available search engines with their capabilities.

Response

{
  "engines": {
    "google": {
      "name": "Google",
      "enabled": true,
      "categories": ["general", "web"],
      "supported_languages": ["en", "es", "fr", "de", "..."],
      "safe_search_support": true,
      "time_range_support": true,
      "paging_support": true
    }
  },
  "total_engines": 70,
  "enabled_engines": 65
}

Available Engines

General: Google, Bing, DuckDuckGo, Brave, Yahoo, Yandex, Qwant, Startpage, Mojeek, Presearch, Searx

Academic: Google Scholar, arXiv, PubMed, Semantic Scholar, BASE, CORE

News: Google News, Bing News, Yahoo News

Images: Google Images, Bing Images, Brave Images

Video: YouTube, Dailymotion, Vimeo

And 50+ more specialized engines.

Search API

On this page