Agentic AI-powered search that reasons over multiple search results to answer complex queries.
AI Search goes beyond a single search query. It runs multiple searches, analyses the results, and synthesises a comprehensive answer. Ideal for research questions, comparisons, and multi-faceted topics.
How multi-step reasoning works:
This process is similar to how a human researcher would tackle a complex question — gathering information from multiple sources, cross-referencing facts, and synthesising a well-informed answer.
| Name | Type | Description |
|---|---|---|
qrequired | string | The search query or question. 1-1000 characters. Can be a complex research question, comparison, or multi-part query. |
model | string | AI model to use for reasoning. Default: `auto` (selects the best available model based on query complexity). Options: `auto`, `fast`, `detailed`. |
AI Search costs 8 credits per request. This covers:
The cost is fixed at 8 credits regardless of how many sub-queries or searches are performed internally. Credits are deducted upfront — if the AI search fails after deduction, credits are refunded.
Successful AI search response:
AI Search using each SDK:
This endpoint can return the following errors:
| Name | Type | Description |
|---|---|---|
INVALID_QUERY | 400 | Missing or empty `q` field, or query exceeds 1000 characters. |
INSUFFICIENT_CREDITS | 402 | Not enough credits. AI Search costs 8 credits per request. |
USER_RATE_LIMITED | 429 | You've exceeded your plan's per-minute rate limit. |
ENGINE_ERROR | 502 | One of the underlying search or scrape operations failed. Credits are refunded. |