AI SERP API
AI Mode API
Extract AI Overviews (SGE) via API. Automatically aggregate multi-source web information and references synthesized by generative AI search engines.
API Description
The AI Mode API returns responses based on user prompts, seamlessly embedding them at the top of standard search results. Leveraging generative AI, it automatically extracts and aggregates information from multiple web sources. This empowers sellers to quickly grasp market sentiment, gain insights into market trends, and facilitate precise product selection.
🤖 Pulling this data to power an AI Agent? Instead of writing custom parsing code, leverage our MCP Server to grant your AI workspace native, real-time access with zero integration friction.
Request URL
Request Headers
| Parameters | Parameter value | Type | Description |
|---|---|---|---|
| Content-Type | application/json | string | Data format |
| Authorization | Bearer xxx | string | Authorization Token |
Request Parameters
| Parameters | Required | Type | Description |
|---|---|---|---|
| url | Yes | string | Target web page URL. Note: The URL must NOT contain the first-turn prompt (e.g. the q parameter). All prompts are passed via the param array. |
| parserName | Yes | string | Parser name |
| param | Yes | string[] | Multi-turn conversation prompts. Each entry corresponds to one conversation turn. (Performance drops when the array length exceeds five.) |
| screenshot | No | boolean | Do you need a page screenshot? |
Response value
| Return value | Type | Description |
|---|---|---|
| code | int | Status Code |
| message | string | Message |
| data | object | Returned data |
Return parameter data description
| Return value | Type | Description |
|---|---|---|
| json | object | Return JSON data (see the json description below) |
| url | string | Task URL |
| screenshot | string | The storage location of the page screenshot |
Return parameter json description
| Return value | Type | Description |
|---|---|---|
| type | string | Result type |
| finalUrl | string | The URL of the conversation. You can open this URL to continue viewing the conversation later. |
| turns | object[] | Conversation turns. Each element represents one turn of the conversation. |
| turns[].prompt | string | The prompt of this turn. It corresponds one-to-one with its answer (overview). |
| turns[].overview | object | The AI Overview answer for this turn, including items (content) and references. |
Request example
Return example
Credit Consumption
- Average response time:
30s - Credit Consumption:
| Credits Consumption | |
|---|---|
| Obtain complete AI Overview information | 2 Credits/Per Request |

