Search

Search API

Search the web and return ranked pages, each with the passage that best matches the query.

Billing metadata: responses include cost_usd, usage_count, service, and currency fields in the JSON body.

post/search

Request

  • Base URL: https://api.desearch.ai
  • URL: https://api.desearch.ai/search
  • Auth: API key in header Authorization

Request body

querystring required

Search query.

mode'fast' | 'balanced'

fast returns results sooner. balanced favors relevance.

countinteger

Number of results to return: 10, 15 or 20.

start_datestring date nullable

Only return pages published on or after this date (YYYY-MM-DD).

end_datestring date nullable

Only return pages published on or before this date (YYYY-MM-DD).

highlightsboolean

Include the passage that best matches the query.

page_textboolean

Include the full page text.

Example request

{
  "query": "Who won the 2024 Nobel Prize in Physics?",
  "start_date": "2026-01-01",
  "end_date": "2026-09-17"
}

Response

Ranked results and the cost of the request.

cost_usdnumber required

Cost charged for this request in USD.

usage_countinteger required

Billable usage units for this request.

servicestring required

Pricing service used for the charge.

currencystring required

Currency of cost_usd.

Changes

No recorded changes to this operation across all 1 revision of this API.