Search API - APIs | Desearch Docs

The Search API answers a natural-language prompt from sources you choose: web, X, Reddit, Wikipedia, YouTube, Hacker News, Arxiv. It returns results your agent can cite, optionally with a final summary.

Search with a summary

text

POST https://api.desearch.ai/desearch/ai/search

bash

curl --request POST 'https://api.desearch.ai/desearch/ai/search' \
  --header "Authorization: $DESEARCH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "best recent research on AI search benchmarks",
    "tools": ["web", "reddit", "arxiv"],
    "date_filter": "PAST_WEEK",
    "result_type": "LINKS_WITH_FINAL_SUMMARY",
    "count": 10,
    "streaming": false
  }'

The response contains search (results with title, link, snippet, highlights, published_date) and completion (the summary, when requested). Set "streaming": true to receive the summary as server-sent events.

Parameters

Parameter	Type	Notes
`prompt`	string	The question. Required.
`tools`	string[]	Sources to search: `web`, `twitter`, `reddit`, `wikipedia`, `youtube`, `hackernews`, `arxiv`.
`date_filter`	string	`PAST_24_HOURS`, `PAST_WEEK`, `PAST_MONTH`, and similar windows.
`result_type`	string	Links only, or `LINKS_WITH_FINAL_SUMMARY`.
`count`	int	Results per source.
`streaming`	bool	Stream the summary as it is written.

Links only, no summary

When you want sources without paying for a completion:

text

POST https://api.desearch.ai/desearch/ai/search/links/web
POST https://api.desearch.ai/desearch/ai/search/links/twitter

Same request shape, minus result_type and streaming.

Plain web results

A keyword query against the web, no AI involved. Use it for result pages, enrichment, and rank tracking:

text

GET https://api.desearch.ai/web?query=latest%20AI%20search%20news&num=10&start=0

Full schemas for all four endpoints are in the API Reference.