Exa Search
exa_searchWeb search by meaning, not just keywords. Returns title, URL, published date and author per result; optionally page text, highlights, or one structured answer synthesised from the results. Search types: 'auto' (default, balanced), 'lite' (cheapest, fastest, no output_schema), 'deep-lite' and 'deep' (multi-step research). Categories: company, publication, news, personal site, financial report, people. max_age_hours controls freshness (0 = fetch live, -1 = cache only); historical snapshots are not available on this gateway's Exa plan. Billing note: results beyond 10 cost extra upstream. Example: exa_search({ query: "startups building AI agents for customer support", num_results: 10, type: "auto", category: "company" })
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"type": "auto",
"query": "recent research on protein folding with diffusion models",
"num_results": 10
},
"name": "exa_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Search type: 'auto' (balanced, default), 'lite' (low cost and latency), 'deep-lite' (light multi-step research), 'deep' (comprehensive multi-step research). Legacy neural/keyword/fast/instant/deep-reasoning are still accepted and mapped to the nearest current type with a warning. | |
| query | Yes | The search query, describe what you want by meaning, e.g. "recent research on protein folding with diffusion models" | |
| _apiKey | No | Optional, your own Exa API key for higher limits; omit to use the shared Pipeworx key. | |
| category | No | Optional focus category. Documented values: company, publication, news, 'personal site', 'financial report', people. Other strings are sent to the vendor as hints with a warning; 'tweet' is retired and refused. 'research paper' maps to publication. | |
| num_results | No | Number of results to return (default 10, max 100). Results beyond 10 cost extra upstream. | |
| include_text | No | If true, include the clean parsed page text (up to 2000 chars) for each result. Default false. | |
| max_age_hours | No | Maximum age of page content in hours, an integer from -1 to 720. 0 fetches live content (last 60 seconds); -1 uses only the cache. Omit for the vendor default (cache). | |
| output_schema | No | Optional JSON schema (root type 'text' or 'object', at most 10 properties and 2 levels deep, every array with items). Returns one synthesised answer in `output` grounded in the results. Not supported with type 'lite'; adds about 2 seconds. | |
| include_highlights | No | If true, include the most query-relevant excerpts of each page. Default false (switched on automatically when max_age_hours is set without include_text). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| output | No | Synthesised answer when output_schema was given: a string or an object matching the schema | |
| results | Yes | Matching pages | |
| warnings | No | Legacy or undocumented argument values that were mapped or passed as hints | |
| costDollars | No | Upstream cost breakdown in USD as reported by the vendor | |
| search_type | Yes | Search type actually used: auto, lite, deep-lite or deep | |
| autopromptString | No | Query rewrite, when the vendor returns one | |
| upstream_warnings | No | Warnings returned by the vendor |