Thunderbit Open API home page
SupportAPI Console
Search

Search and Distill

POST
/search
Search and Distill

Run a Google web search for the supplied query and Distill each result with the requested formats. Each result reports its own success flag.

Authorization

YOUR_API_KEY
AuthorizationBearer <token>

Enter your API key from the Thunderbit Dashboard. The header format will be: Authorization: Bearer YOUR_API_KEY

In: header

Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*stringrequired

Search query (max 500 characters).

Example:best web scraping tools 2026
limitintegerdefault:5

Number of results to return (1–10, default 5).

Required range:1 <= x <= 10
Example:
5
sitestring

Restrict the search to a single domain.

Example:techcrunch.com
formatsany[]

Output formats applied to each result page (same shape as the Distill formats array).

Example:
[
  "markdown",
  {
    "type": "summary"
  }
]
timeoutintegerdefault:30000

Per-result Distill timeout in milliseconds (default 30000, max 60000).

Required range:5000 <= x <= 60000

Response

application/json

Search succeeded. Per-result Distill outcomes are reported individually in `data.results[].success`.

successboolean
Example:
true
dataobject
Show child attributes
querystring

Echo of the input query.

totalinteger

Number of results returned.

successfulinteger

Number of results whose Distill stage succeeded.

credits_usedinteger

Total credits charged for this request.

resultsobject[]
Show child attributes
urlstring

Result URL.

titlestring

Search result title.

snippetstring

Search result snippet from Google.

positioninteger

1-based rank in the search results.

successboolean

Whether per-result Distill succeeded.

markdownstring

Distilled Markdown for this result (when requested).

summarystring

Result summary (when requested).

answerstring

Answer to the question format (when requested).

highlightsstring[]

Highlighted passages (when requested).

linksobject[]

Links extracted from the result page (when requested).

Show child attributes
textstring

Visible link text.

Example:Read more
hrefstring

Resolved absolute URL.

Example:https://example.com/article
imagesobject[]

Images extracted from the result page (when requested).

Show child attributes
srcstring

Image source URL.

Example:https://example.com/hero.png
altstring

Image alt text.

Example:Hero banner
widthinteger

Image width in pixels.

heightinteger

Image height in pixels.

errorstring

Distill error message for this result (only when success=false).