主题
Gemini LLM Scraper 概述
Gemini LLM Scraper 用于根据及参数,获取 Gemini 返回的结构化结果。通过本接口,您可以分析 Gemini 对特定搜索查询的回答,识别引用的信息来源、提及的品牌及回答结构。
本组接口支持实时获取和异步任务获取两种模式,涉及的主要路径:
- 实时高级结果:
/v3/ai_optimization/gemini/llm_scraper/live/advanced/ - 实时 HTML 结果:
/v3/ai_optimization/gemini/llm_scraper/live/html/ - 异步任务创建:
/v3/ai_optimization/gemini/llm_scraper/task_post/ - 已完成任务列表:
/v3/ai_optimization/gemini/llm_scraper/tasks_ready/ - 异步任务结果获取:
/v3/ai_optimization/gemini/llm_scraper/task_get/advanced/
接口能力
Gemini LLM Scraper Advanced
/v3/ai_optimization/gemini/llm_scraper/live/advanced/
返回 Gemini 针对指定和参数生成的结构化结果。适用于提取回答、引用来源、品牌提及及可分析字段。
Gemini LLM Scraper HTML
/v3/ai_optimization/gemini/llm_scraper/live/html/
返回指定、搜索引擎和地区对应的 Gemini 原始 HTML 页面。适用于需要保留页面原始结构、进行自定义解析或存档的场景。
数据获取方式
本接口提供 Live(实时)和 Standard(标准异步)两类数据获取方式。
Live 实时模式
Live 模式适用于需要立即获得结果的业务。请求提交后,本接口会在同一次调用中返回处理结果,无需分别创建任务和查询任务结果。
- 适用接口:
/v3/ai_optimization/gemini/llm_scraper/live/advanced/ - 任务最长执行时间:120 秒
- 特点:实时返回、调用流程简单、费用相对较高
Standard 标准异步模式
Standard 模式适用于无需实时获取结果、希望降低成本的场景。该模式需要创建任务,再在任务完成后获取结果。
标准流程如下:
- 通过
POST /v3/ai_optimization/gemini/llm_scraper/task_post/创建任务。 - 等平台完成数据采集。
- 调用
/v3/ai_optimization/gemini/llm_scraper/tasks_ready/获取已完成任务的 ID 列表。 - 使用
/v3/ai_optimization/gemini/llm_scraper/task_get/advanced/获取单个任务的详细结果。
创建任务时,还可设置以下回调参数:
| 参数 | 说明 |
|---|---|
pingback_url | 任务完成后,平台向指定地址发送完成通知。 |
postback_url | 任务完成后,平台将任务结果主动发送至指定地址。 |
执行优级与计费
Live 模式提供实时结果,因此通常最高的调用成本。
Standard 模式支持以下执行优级:
| 优级 | 说明 |
|---|---|
| Normal priority | 常规执行速度,适用于对时效要求不高的批量任务。 |
| High priority | 更高执行速度,适用于需要更快完成异步任务的场景。 |
不同获取方式和执行优级的扣费不同。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
您也可以通过 /v3/appendix/user_data/?php 查询账户用量与消费数据,并通过 /v3/appendix/sandbox/ 在测试环境中验证接口调用流程。
调用限制
平台限流以认证说明中的 30/60/120 次/分钟规则为准**。
- Live 模式任务执行时长:最长 120 秒。
- 如需提高调用频率限制,请联系平台支持团队。
实用场景
- 监测品牌提及:定期查询行业核心,识别 Gemini 回答中是否提及自身品牌及竞品,为品牌可见性优化提供依据。
- 分析引用来源:提取 Gemini 回答引用的网站和来源,筛选高频被引用域名,制定合作与外链建设策略。
- 评估 AI 搜索表现:对目标批量获取 Gemini 回答,评估品牌、产品或在生成式搜索结果中的。
- 挖掘选题:分析 Gemini 对用户问题的回答结构、覆盖主题和引用,发现现有缺口及可扩展的 SEO 选题。
- 构建竞品报看板:持续采集竞品的 Gemini 结果,追踪竞品被提及频率、语境和引用来源变化。