Skip to main content
搜索词是 Topify.ai 每天在所有 AI 服务商上跟踪的 AI 搜索查询。每个搜索词会生成回复,并被分析以衡量品牌可见度、情感分析、引用和竞争对手提及情况。 API 支持创建、更新和获取搜索词。公共 API 有意不提供删除搜索词的端点。API 密钥由团队管理员签发。

列出搜索词

返回项目中的所有搜索词,按创建日期排序。

路径参数

响应

搜索词字段


获取搜索词

返回单个搜索词。字段与列表相同。

路径参数


创建搜索词

向项目中添加一个或多个搜索词。每个搜索词会立即开始跟踪 —— Topify.ai 将在后台开始收集 AI 回复并计算指标。
API 密钥由管理员创建,目前对整个团队拥有完整权限。创建搜索词前请确认项目和搜索词文本。

路径参数

请求体

响应

错误响应


更新搜索词

更新现有搜索词的内容、国家、主题或类型。
API 密钥由管理员创建,目前对整个团队拥有完整权限。更新搜索词前请确认项目和字段。

路径参数

请求体

所有字段均为可选。仅包含您想要修改的字段。

响应

返回更新后的搜索词及其全部字段(与 获取搜索词 形状相同)。

错误响应


搜索词分析

返回按日期和 AI 服务商分组的可见度、位置和情感分析时间序列数据。

查询参数

响应

响应字段

ProviderMetric:

单个 Prompt 的竞品指标

返回某一个 Prompt 下所有 active 竞品的指标。这个接口适合导出单个 Prompt 里的各品牌 visibility、sentiment、position 和 share of voice,不需要在控制台里逐个打开 Prompt 详情页。 结果会根据所选 Prompt 和时间范围内的原始 AI 回复实时计算。

路径参数

查询参数

响应

PromptCompetitorsResponse 字段

PromptCompetitorMetricItem 字段

aggregate_over_time=true 时,datenull,每一行代表整个 period 的聚合结果。当 aggregate_over_time=false 时,items 会包含每个日期、每个竞品各一行。如果该日期或周期内有 Prompt 回复但某竞品未被提及,visibility0.0;如果该日期或周期内没有 Prompt 回复,visibilitynullsentimentpositionsov 在没有可用观测或分母时为 null

AI 回复(chats)

返回原始 AI 回复,包括品牌提及、情感分析、位置和引用。

查询参数

搜索词分析 相同。

响应

ChatItem 字段

BrandMention: ReferenceItem:

域名

返回域名级别的引用细分,按引用次数降序排列。

查询参数

搜索词分析 相同。

响应

DomainItem 字段

BrandInfo:

URL

返回 URL 级别的引用数据,按提及次数降序排列。

查询参数

搜索词分析 相同。

响应

UrlItem 字段


生成建议搜索词

立即创建占位搜索词,并通过后台 Semrush、DataForSEO 和 LLM 流程填充内容。生成通常需要 30-90 秒。

请求体

此生成端点当前使用 camelCase 请求和响应字段。

响应

轮询 GET /projects/{project_id}/prompts,并筛选 promptType=Suggested 以观察占位内容填充进度。

生成 URL 推荐

为一到五个目标 URL 创建搜索词推荐。返回占位搜索词后,现有匹配检查和新候选生成会继续在后台运行。

请求体

响应

轮询搜索词列表并筛选 promptType=UrlRecommended。公共 API 有意不提供搜索词删除和占位清理操作。