AI Search

Agentic AI-powered search that reasons over multiple search results to answer complex queries.

POST /v1/ai/search

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:

  1. 1Query analysis — the AI breaks down your question into sub-queries and identifies what information is needed
  2. 2Multi-engine search — it runs searches across multiple engines (Bing, Google, DuckDuckGo) to get diverse perspectives
  3. 3Content extraction — the top results are scraped and parsed for relevant information
  4. 4Reasoning and synthesis — the AI analyses all gathered information, identifies patterns, contradictions, and key facts
  5. 5Answer generation — a comprehensive answer is generated with inline source citations

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.

Request Body

NameTypeDescription
qrequired
stringThe search query or question. 1-1000 characters. Can be a complex research question, comparison, or multi-part query.
model
stringAI model to use for reasoning. Default: `auto` (selects the best available model based on query complexity). Options: `auto`, `fast`, `detailed`.

Credit Cost

AI Search costs 8 credits per request. This covers:

  • Multiple underlying search calls (2-5 searches across different engines)
  • Content extraction from top results (scrape calls)
  • AI reasoning and synthesis
  • Source citation generation

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.

Response

Successful AI search response:

json

SDK Examples

AI Search using each SDK:

python
javascript
go

Error Codes

This endpoint can return the following errors:

Errors

NameTypeDescription
INVALID_QUERY
400Missing or empty `q` field, or query exceeds 1000 characters.
INSUFFICIENT_CREDITS
402Not enough credits. AI Search costs 8 credits per request.
USER_RATE_LIMITED
429You've exceeded your plan's per-minute rate limit.
ENGINE_ERROR
502One of the underlying search or scrape operations failed. Credits are refunded.

Need help?

Check our error codes or reach out to the team.