Web search
exa/searchSearch the web and get ranked results, optionally with page content.
- call
- $0.014
- Exa
- 5 min
Overview
Takes a natural-language or keyword query and returns ranked web results, each with a URL, title, publication date, author, and a stable document id. Results can be narrowed by domain allow and deny lists, publication date, and a content category such as news or research. Asking for contents folds retrieval into the same call, so one request returns extracted page text, query-relevant highlights, and summaries instead of a fetch per result.
A result list, each entry carrying a title, URL, document id, publication date, and any content that was requested.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | What to search for, in plain language or keywords. |
| numResults | integer | No | How many results to return. |
| type | string | No | How hard to search, from an instant lookup to a deep research pass. |
| category | string | No | Restrict results to one kind of page. |
| includeDomains | array | No | Only return results from these domains. |
| contents | object | No | Return page content with each result: text, highlights, and summaries. |
Requests up to 1 MB.
Example
A call that works, with your own key.
curl https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-d '{"provider":"exa","endpoint":"search","input":{"query":"agent gateways","numResults":5,"contents":{"text":{"maxCharacters":1000}}}}'Pricing
$0.014 per call on the default plan. Every run carries its price in the response.