跳转到主要内容
POST
Gemini 采集 API
使用 AdsCrawl Gemini Scraper 采集回答及可获取的来源信息,用于品牌研究、引用分析或自己的 GEO 工作流。您可以先在 AI Search Insights 中设置请求,再打开 API integration,复制与当前设置对应的 API 请求。

身份认证

在 x-api-key 请求头中传入 AdsCrawl API Key,并发送 JSON 请求体。以下示例从应用的 ADSCRAWL_API_KEY 环境变量读取密钥,请先设置该变量,并将密钥保存在服务端。
string
必填
您的 AdsCrawl API Key,可在 API keys 中获取。
string
必填
使用 application/json。

请求参数

string
使用 gemini 调用 Gemini 采集能力。Gemini、Google AI Mode 与 Google AI Overview 是三个独立的采集目标,请按需选择。
string
要提交的问题。控制台最多接受 500 个字符,并保留换行与原始措辞。如果需要以特定语言回答,请在问题中明确说明。
string
代理地区。GLOBAL 表示从支持的地区中随机选择出口。需要指定地区时,请在控制台选择支持的地区,并复制其生成的 API 请求。
string
浏览器语言,例如 en-US。控制台选择 Automatic (proxy region) 时会省略此字段。浏览器语言不决定回答使用的语言。
number
总体采集超时,单位为毫秒。示例使用 120000,即 120 秒。控制台提供 10 至 120 秒的超时设置;HTTP 客户端等待时间应长于采集超时。

请求示例

以下示例使用 Global 代理出口和英语浏览器环境。采集超时设为 120 秒,客户端等待时间设为 140 秒。

返回字段

回答取决于问题和采集时可获取的内容,来源与广告可能不存在。将来源、广告或网络信息中的嵌套字段接入应用前,请先检查实际返回数据。

地区、语言与分析

请求通过住宅动态代理路由。选择地区本身不保证目标平台一定可访问或返回特定回答。比较多次采集结果时,请保留问题、地区、语言和实际出口网络信息。例如,需要德语回答时,应在 query 中明确要求使用德语,同时可单独设置浏览器语言。 您可以将回答和来源数据用于自己的品牌提及、引用或可见性分析。重复采集、定时调度和评分由接入此 API 的业务流程完成。

AI Scrapers 支持的平台

AI Search Insights 已可选择以下四个平台,均使用 POST /ai-search。每个平台分别发送一次请求。 跨平台比较时,尽量保持问题、代理地区和浏览器语言一致,并保留每次采集的日期、任务 ID 与实际出口网络。平台可选不代表每个问题都一定有回答、来源或广告。