AI Search
Learn the common fields for AI Search PDP endpoints and example providers.
AI Search PDP Cache agents take a natural-language query and return an AI-generated text answer. Instead of scraping a single detail page, they call an AI provider (with optional web search) and return the answer as Markdown text. They are suitable for research, product lookups, or general knowledge questions.
Common Response Fields
The AI Search PDP Cache agents return the following top-level fields:
| Field | Type | Description |
|---|---|---|
success | boolean | Whether the request completed successfully |
message | string | Status message (e.g. Successfully scraped) |
data | object | string | The generated answer. Shape depends on the provider (see below) |
tokenUsage | number | Number of tokens consumed by the run |
The data field differs by provider:
-
Gemini returns an object with
queryandtext:Field Type Description data.querystring The original query that was submitted data.textstring AI-generated answer in Markdown -
GPT returns the answer directly as a string (Markdown). When web search is used, sources are appended as inline Markdown reference links (e.g.
[1]: https://...).
Example Providers
AI Search PDP agents are typically available for major AI providers, for example:
- Gemini — Ask a query to Gemini and receive an AI-generated text answer.
- GPT — Performs a web search using GPT and returns an AI-generated text answer with sources.
Check the Marketplace for the full list of supported AI Search providers.