跳转到主要内容
使用 /batches 加上 GEO/AEO(生成引擎优化 / 答案引擎优化)解析器来大规模查询 AI 搜索引擎,并获取结构化的 JSON:包括答案、引用和商业展示面,如广告、购物卡和产品模块。 本页面介绍如何调用 /v1/batches 以及你所获得的 JSON 的简要概览。

引擎

每个引擎需要其自己的解析器 ID 和 URL 模板。在批次级别传递解析器一次。将查询编码在 URL 中。 所有六个引擎都支持通过批次 country 参数(ISO 3166-1 alpha-2)进行地理定位。国家覆盖范围因解析器而异——获取实时列表而不是硬编码:
当你关心引用时,使用信息提示(what is mitochondria)。当你需要广告、购物卡或产品模块时,使用商业提示(best wireless headphones under $200)——这些展示面是根据意图检测的,当引擎未呈现它们时会被省略。

定价

这是我们为自助服务客户提供的公开定价。我们为企业客户提供更好的价格和批量折扣。我们还为专用平台和 LLM 引擎提供定制连接器。通过 email 或 Slack 联系我们。

1. 创建批次

custom_id 在批次内必须唯一。country 应用于每个项目。
要定位不同的引擎,保持相同的 items 结构并更换 parser.id 和每个 URL 中的主机。一个批次 = 一个解析器。
处理时间大致恒定,无论批次大小(通常为 5-8 分钟)。在创建时传递 webhook 以获取 batch.completed 而不是轮询。新账户限制为每批次 100 个项目——联系 info@olostep.com 提高限制。

2. 等待完成

轮询 GET /v1/batches/{batch_id} 直到 status 为 completed,或处理 webhook。
Python 和 Node SDK 可以为你等待:迭代 batch.items() / for await (const item of batch.items()),它们会阻塞直到批次完成。

3. 检索 json_content

列出项目,然后为每个 retrieve_id 检索 JSON。GEO 负载是 json_content 内的解析对象(一个 JSON 字符串——解析它)。
失败的项目会单独列出——在 GET /v1/batches/{batch_id}/items 上传递 status=failed。托管的 JSON 也可以在检索负载的 json_hosted_url 上获取,大约保留 7 天。

你得到的内容

每个解析器返回 answer_markdown。大多数还返回 prompt。其余部分是引擎特定的。下面的简要概览来自实时 country=US 批次。
这里列出的引擎是公共的 GEO 解析器。我们还支持内部的其他解析器和连接器,以及特定网站的自定义解析器——根据请求共享。发送邮件至 info@olostep.com 或通过 Slack 联系我们。
引用在 sources 中(当内联引用时 cited: true)。结构化部分在 text_blocks 中(text,heading,list,table)。当 Google 显示时,赞助卡在 ads 中——一个实时的耳机查询返回了来源和比较表,但省略了 ads。空字段被剥离,不作为 [] 返回。

相关内容