ChatGPT LLM Scraper：概览

本接口提供 ChatGPT 搜索结果的结构化数据。通过指定及参数，您可以获取 ChatGPT Search 模式下的搜索结果，分析对特定查询的回答方式，并了解回答中引用的来源、网站和品牌。

接口能力

本页涉及以下接口，均通过 POST 请求提交 JSON 数组格式的任务：

ChatGPT LLM Scraper 结构化结果接口
POST /v3/ai_optimization/chat_gpt/llm_scraper/live/advanced/
根据指定及参数，实时返回 ChatGPT 搜索结果。
ChatGPT LLM Scraper HTML 接口
POST /v3/ai_optimization/chat_gpt/llm_scraper/live/html/
根据指定、搜索引擎和地理位置，返回 ChatGPT 搜索结果页面的原始 HTML。

如需了解 AI 优化接口的常见问题及高效使用方式，请参考帮助中心文档。

数据获取方式

本平台提供两种任务结果获取方式：Live 实时方式和Standard 标准方式。

Live 实时方式

Live 方式适用于需要即时获得结果的场景。提交请求后，接口会直接返回任务结果，无需额外调用任务查询接口。

ChatGPT LLM Scraper 实时接口的任务执行时间目前最长约为 120 秒。

适用接口：

POST /v3/ai_optimization/chat_gpt/llm_scraper/live/advanced/
POST /v3/ai_optimization/chat_gpt/llm_scraper/live/html/

Standard 标准方式

Standard 方式适用于不要求实时返回结果的场景。该方式通常需要分两步完成：

通过任务提交接口创建任务；
通过任务查询接口获取已完成任务的结果。

Standard 方式的成本通常低于 Live 方式。提交任务时，也可以设置以下回调参数：

pingback_url：任务完成后通知指定地址；
postback_url：任务完成后将结果发送到指定地址。

当需要批量提交任务时，可以调用 Tasks Ready 接口获取已完成任务的 ID 列表，再通过 Task GET 接口分别获取任务结果。

接口路径：

POST /v3/ai_optimization/chat_gpt/llm_responses/task_post/
POST /v3/ai_optimization/chat_gpt/llm_responses/tasks_ready/
POST /v3/ai_optimization/chat_gpt/llm_responses/task_get/

请求格式

所有 POST 请求体均使用 JSON 数组，即使只提交一个任务，也需要将任务对象放数组中。

请求示例

bash

curl --request POST \
  --url https://api.seermartech.cn/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced/ \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "best project management software"
    }
  ]'

> 以上示例展示接口调用格式。完整参数及响应字段请以对应接口文档为准。

调用限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准**。

如需提高调用频率上限，请联系本平台技术支持。
Live ChatGPT LLM Scraper 接口的任务执行时间目前最长约为 120 秒。

优级与计费

Live 方式会实时处理并返回结果，因此请求成本通常最高。

Standard 方式支持两种任务优级，不同优级代表不同的相对执行速度，并对应不同的计费标准：

Normal：普通优级；
High：高优级。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。费用取决于所选接口、任务获取方式和执行优级。

您可以通过以下方式查看任务消耗：

查看账户控制台中的消费记录；
调用用户数据接口查询账户信息： POST /v3/appendix/user_data/

测试环境

您可以使用本平台提供的 Sandbox 测试 ChatGPT LLM Scraper 接口。测试环境用于验证请求格式、参数和响应结构，可用范围以 Sandbox置为准。

Sandbox 接口路径：

POST /v3/appendix/sandbox/

调用接口时，请在认证信息中使用本平台 API 密钥：

http

Authorization: Bearer smt_live_YOUR_KEY

实用场景

监测品牌在 ChatGPT 搜索回答中的出现：统计品牌被引用、推荐或提及的频率，评估品牌在生成式搜索中的可见度。
分析竞争对手的引用来源：提取 ChatGPT 回答中引用的网站和页面，发现竞争对手重点覆盖的来源。
评估对应的 AI 搜索结果：批量提交目标，比较不同查询下 ChatGPT 的回答、来源和推荐对象。
采集 ChatGPT 搜索结果原始 HTML：获取指定和地区下的页面原始，用于页面结构分析、调试和归档。
构建生成式搜索监测报表：结合 Standard 方式、任务回调和批量结果查询，定期追踪排名、品牌提及及引用变化。

ChatGPT LLM Scraper：概览 ​

接口能力 ​

数据获取方式 ​

Live 实时方式 ​

Standard 标准方式 ​

请求格式 ​

请求示例 ​

调用限制 ​

优级与计费 ​

测试环境 ​

实用场景 ​