Performs a web search and returns unified results from SearXNG, TinyFish or Brave Search.

GET

https://api.scrapingduck.com/v1/web/search

Last modified:2026-10-04 11:19:25

SearXNG is used as the primary search provider. If SearXNG is unavailable or returns
no results, TinyFish Search is tried next (when configured), then Brave Search.
Each search costs 1 credit.

Example Request:
GET /v1/web/search?q=hello+world&count=10&safesearch=strict

Possible error codes:

400 (validation_error): Missing or invalid query parameter.

401 (unauthorized): The API key is missing or invalid.

402 (payment_required): Insufficient credits.

502 (upstream_error): All search providers failed.

Request

Authorization

API Key

Add parameter in query

apiKey

Example:

apiKey: ********************

Query Params

Responses

🟢200

application/json

Body

🟠400

🟠401

🟠402

🔴502

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.scrapingduck.com/v1/web/search?Q=&Country=&Language=&Count=&Offset=&Safesearch=&Freshness=&apiKey=%3Capi-key%3E'

Response Example

200 - Example 1

{
    "query": "string",
    "provider": "string",
    "results": [
        {
            "title": "string",
            "url": "string",
            "description": "string",
            "publishedDate": "string",
            "thumbnail": "string"
        }
    ],
    "suggestions": [
        "string"
    ],
    "moreResultsAvailable": true
}

Modified at 2026-10-04 11:19:25

Estimates the credit cost of a batch scrape without reserving credits.

Opens a new interactive browser session. Creating a session is free; each step is billed.