Search the web

Run a web search and return ranked results (url, title, description). Pass a non-empty `formats` array to also scrape each result and return the requested formats inline. Costs 1 credit per search, plus 1 credit per scraped result.

Run a web search and return ranked results (url, title, description). Pass a non-empty formats array to also scrape each result and return the requested formats inline. Costs 1 credit per search, plus 1 credit per scraped result.

Authorization

bearerAuth

AuthorizationBearer <token>

Secret API key (sr_ prefix). Pass as Authorization: Bearer sr_...

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*string

Length1 <= length

limit?integer

Max number of results (1–100). Defaults to 10.

Range1 <= value <= 100

tbs?string

Time-based filter: d=past day, w=past week, m=past month, y=past year.

Value in"d" | "w" | "m" | "y"

filter?string

Search modifier appended to the query (e.g. site:github.com).

lang?string

country?string

location?string

Backend-specific locale (e.g. DDG kl value like fr-fr).

timeout?integer

Per-backend request timeout in ms.

Range1 <= value <= 60000

formats?array<>

When non-empty, each result is scraped through the Parsew pipeline and the requested formats are returned inline. Each scraped result costs 1 additional credit.

Itemsitems <= 3

scrapeOptions?

Response Body

`application/json`

curl -X POST "https://api.parsew.com/v1/search" \  -H "Content-Type: application/json" \  -d '{    "query": "best web scraping APIs"  }'

{
  "results": [
    {
      "url": "string",
      "title": "string",
      "description": "string",
      "markdown": "string",
      "html": "string",
      "links": [
        "string"
      ],
      "warning": "string",
      "error": "string"
    }
  ],
  "creditsUsed": 0,
  "warning": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`