跳转到主要内容
POST
ChatGPT 采集 API
使用 AdsCrawl ChatGPT 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
使用 chatgpt 调用当前已上线的 ChatGPT 采集能力。
string
要提交的问题。如果需要以特定语言回答,请在问题中明确说明。
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 当前仅可选择 ChatGPT 执行采集。即将上线的条目尚未提供可调用的平台参数值。