排名追踪器 API

简介

当您需要管理数百个网站、数千个关键词，或者处理需要自动更新的SEO报告时，排名跟踪就会变成一个截然不同的难题。

对于小型项目，登录仪表盘并手动导出数据或许可行。但当规模扩大时，这很快就会成为瓶颈。

正因如此，我们开发了 Ranktracker API。

Ranktracker API 现已上线，为开发者、SEO 团队、代理机构、SaaS 公司和数据团队提供了通过编程方式访问其 Ranktracker 数据的途径。

您可以使用该 API 来：

获取前 100 个关键词排名
访问搜索结果页面（SERP）数据
检测 AI 概览及其他 SERP 功能
创建和管理已监控的域名
添加和管理关键词
跟踪竞争对手
查看排名历史
计算市场声量份额
使用标签整理关键词
监控账户使用情况和配额
构建自动化SEO报告流程
将排名数据连接到内部应用程序和仪表盘

无需手动在不同平台之间传输 SEO 数据，Ranktracker API 可让您的软件直接与 Ranktracker 背后的排名基础设施进行交互。

创建或管理您的 API 密钥： https://app.ranktracker.com/account/api

阅读 API 文档： https://developers.ranktracker.com/

什么是 Ranktracker API？

该 Ranktracker API 是一个 REST API，可让您通过编程方式访问您的 Ranktracker 账户。

您无需每次都需要排名信息时都打开 Ranktracker，您的应用程序可以自动请求数据。

该 API 的结构基于 Ranktracker 全局通用的核心资源：

账户
域名
关键词
竞争对手
排名历史
搜索结果页面数据
声量份额
标签
使用情况和配额

这使开发者既能检索 Ranktracker 数据，又能管理 Ranktracker 的追踪对象。

例如，当新客户进入 SEO 代理机构的 CRM 系统时，该机构可以自动创建一个 Ranktracker 项目，添加该客户的关键词和竞争对手，然后将排名数据导入内部报告仪表盘。

SaaS 平台可以利用相同的 API，直接在其自身产品中展示排名数据。

数据团队可以自动将每日排名数据发送至 BigQuery、Snowflake、PostgreSQL、Google 表格或其他数据仓库，以便进行进一步分析。

有关这些资源如何相互配合的概述，请参阅 《Ranktracker API 核心概念指南》。

默认的“前 100 名”排名

Ranktracker API 的最大优势之一在于其排名数据的深度。

每次关键词检查默认都会包含Google 搜索结果的前 100 条。

这意味着您可以分析全部 10 页的搜索结果，而不仅仅是查看当前排名在第一页的内容。

这一点至关重要，因为SEO的进展通常在关键词进入前十名之前很久就已经开始了。

一个关键词的排名可能经历以下变化：

第 91 位 → 第 63 位 → 第 37 位 → 第 18 位 → 第 9 位

这代表了显著的SEO进展。

如果您的排名数据仅止于前10个结果，那么整个排名提升过程几乎都处于隐形状态。

前100名追踪功能可让您监控：

新进入谷歌前100名的排名
跻身第一页的关键词
排名大幅上升与下降
竞争对手的排名变动
长尾搜索可见度
新内容表现
程序化SEO活动
大型关键词组合

这使得该 API 既适用于高层次的 SEO 报告，也适用于详细的排名分析。

了解有关该 API 的更多信息：

https://developers.ranktracker.com/

跨 107,000 多个地点追踪排名

搜索结果会因搜索所在位置的不同而存在显著差异。

Ranktracker 支持107,000 多个地点，使团队能够通过该 API 跟踪本地、全国及国际范围内的搜索可见度。

关键词跟踪可围绕以下因素进行配置：

搜索引擎
位置
语言
设备

例如，同一关键词可针对以下方面分别进行监控：

美国 — 桌面端
美国 — 移动端
英国 — 桌面端
德国 — 移动端
波兰 — 桌面端

每项配置均可视为一个独立的受监控关键词。

这对于以下情况特别有用：

国际SEO
多地点企业
本地SEO机构
电子商务企业
在不同市场运营的内容发布商
面向多个国家的SaaS公司
企业级SEO团队

与其将一个关键词视为仅有一个通用的排名位置，您不妨分析其在不同市场和设备上的可见度变化情况。

桌面端与移动端排名跟踪

桌面端和移动端的搜索结果可能有所不同。

因此，Ranktracker 支持按设备对关键词追踪进行细分。

这意味着集成系统可以分别分析：

桌面端排名
移动端排名

例如，某页面在桌面端可能排名靠前，但在移动端的表现却可能因搜索结果页面（SERP）布局、本地搜索结果或其他搜索功能的差异而有所不同。

将这些数据集分开管理，能让 SEO 团队更清晰地了解用户在搜索中实际接触其网站的情况。

在使用“市场份额”（Share of Voice）等功能时，该API同样支持按设备进行细分。

搜索结果页面（SERP）功能与 AI 概览检测

现代谷歌搜索结果包含的内容远不止传统的自然搜索结果。

搜索结果页面（SERP）可能包含：

AI概览
精选摘要
地图
本地搜索结果
视频
购物结果
用户常问
其他搜索功能

Ranktracker API 除了关键词数据外，还包含搜索结果页面（SERP）功能信息和 AI 概览检测功能。

这意味着您的集成不仅可以分析网站的排名位置，还能分析该网站在谷歌搜索结果中的周边内容。

例如，您可以识别：

触发AI概览的关键词
包含精选摘要的搜索结果页面
视频结果占主导地位的搜索查询
会产生本地或地图结果的关键词
搜索结果页面（SERP）构成随时间的变化

这一点变得越来越重要，因为仅凭自然搜索排名往往无法全面反映情况。

在传统搜索结果页面（SERP）上排名第三的页面，与在AI概览、地图包、视频和“人们还问”下方排名第三的页面，其曝光度可能截然不同。

该 API 使这些差异能够成为您 SEO 分析的一部分。

查看完整的 API 文档：

https://developers.ranktracker.com/

访问完整的搜索结果页面（SERP）数据

Ranktracker 提供的远不止一个排名数字。

对于被追踪的关键词，该 API 可展示最新的搜索结果以及相关的 SERP 信息。

API 资源结构包括：

最新的搜索结果页面（SERP）数据
排名信息
搜索结果页面（SERP）功能
缓存的搜索结果页面HTML

这意味着开发者可以围绕实际搜索结果构建工作流，而不是仅仅存储诸如：

排名：12

对于高级 SEO 团队而言，这提供了更大的灵活性。

您可以利用 SERP 信息来：

分析竞争对手的URL
调查意外的排名变化
识别搜索结果布局的变化
构建内部搜索结果页面分析工具
存储历史搜索结果页面信息
将搜索结果信息输入到其他模型或分析系统中

完整的端点参考请参见此处：

https://developers.ranktracker.com/rest-api/

通过 API 管理域名

域名是 Ranktracker API 的核心资源之一。

REST API 允许您：

创建域名
检索域名
更新域名
删除域名

一个域名代表 Ranktracker 中正在被追踪的一个网站。

每个域名可包含以下内容：

关键词
竞争对手
排名历史
声量份额数据

这使得自动化入职成为可能。

例如，一家代理机构可以创建以下工作流：

新客户注册
        ↓
创建 Ranktracker 域名
        ↓
添加客户关键词
        ↓
添加竞争对手
        ↓
开始排名跟踪
        ↓
将数据发送至报告仪表盘

团队成员无需手动配置每个新项目。

完整的操作指南可在 《添加域名和跟踪关键词》教程中。

通过编程方式添加和管理关键词

域名创建后，即可通过 API 管理关键词。

您可以使用 API 添加要跟踪的关键词，同时指定与其关联的搜索配置。

被追踪的关键词数据可包含以下因素：

词
搜索引擎
位置
语言
设备
排名结果

您还可以管理现有关键词的跟踪生命周期。

这包括以下功能：

检索关键词
查看其排名信息
暂停追踪
恢复跟踪
停止跟踪
访问搜索结果页面（SERP）信息
分配标签

这使得您的应用程序能够控制 Ranktracker 监控哪些关键词。

批量关键词跟踪

大型 SEO 账户不应为每个关键词都发出一个 API 请求。

Ranktracker 支持批量关键词操作。

关键词创建端点支持“关键词 × 搜索引擎”的配置，允许通过一次请求创建大量要追踪的关键词组合。

例如，假设您想要跟踪：

100个关键词
美国桌面端
美国移动端

这些配置可生成 200 组受追踪的关键词组合，而无需进行 200 次单独的设置请求。

批量操作特别适用于：

代理机构
企业SEO
大型电商平台
程序化SEO
SaaS SEO平台
大型内容发布商

Ranktracker 还支持批量关键词标记。

阅读完整的批量操作指南：

https://developers.ranktracker.com/guides/bulk-operations/

追踪 SEO 竞争对手

当排名数据包含竞争背景时，其参考价值将大大提高。

Ranktracker API 允许针对已跟踪的域名管理竞争对手。

这使得您可以自动分析自身与竞争对手网站的搜索表现。

您可以利用竞争对手数据来监控：

哪些竞争对手正在提升曝光度
哪些网站正在超越您的域名
共享关键词组的变化
竞争对手的排名趋势
相对搜索可见度
市场声量份额的变化

对于代理机构而言，这可以成为自动化客户报告系统的一部分。

无需每月手动将客户与竞争对手进行对比，相关数据可直接集成到报告流程中。

访问历史排名数据

当前排名仅反映当前状况。

历史排名数据反映了SEO表现的发展趋势。

Ranktracker 通过 API 提供域名排名历史数据，使开发人员能够分析其随时间推移的可见度变化。

历史数据可帮助识别：

排名提升
排名下降
可见度趋势
关键词波动
SEO活动后的变化
谷歌算法更新的影响
长期推广表现

您还可以利用排名历史数据创建自定义图表和仪表盘。

例如：

Ranktracker API
       ↓
每日排名提取
       ↓
数据仓库
       ↓
历史 SEO 数据集
       ↓
仪表盘 / 警报 / 分析

Ranktracker 提供了一份专门的教程，演示如何将每日排名数据导入数据仓库：

https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

将 Ranktracker 数据发送至数据仓库

最实用的 API 工作流之一，就是将 Ranktracker 数据自动存储到您自己的数据库或数据仓库中。

例如，排名数据可导入：

BigQuery
Snowflake
PostgreSQL
MySQL
Google 表格
内部分析数据库

随后，这些信息可与其他业务数据进行整合。

例如：

Ranktracker
     ↓
Ranktracker API
     ↓
数据仓库
     ↓
Google Search Console
Analytics
转化数据
收入
CRM 数据
     ↓
商业智能仪表盘

这能呈现出更全面的 SEO 表现全景。

您不再只是简单地知道某个关键词从第 8 位上升到第 3 位，还可以分析这一变化是否还带来了：

更多自然点击
更多潜在客户
更高的转化率
收入增加

《 《从排名到数据仓库》教程 提供了一个构建此类数据流的示例。

构建市场份额报告

Ranktracker API 还提供了“声量份额”数据。

“声量份额”提供了一种更广泛的衡量标准，用于评估某个域名在受追踪关键词集中的可见度。

与其询问：

我们在该关键词的排名如何？

您可以这样查询：

我们在整个搜索市场中的可见度如何？

当纳入竞争对手数据时，这一功能将变得尤为强大。

“声量份额”API 可用于分析：

您的整体可见度
竞争对手的可见度
可见度随时间变化
相对市场地位
桌面端可见度
移动端可见度

该接口支持日期范围和设备细分，因此可将“声量份额”数据整合到自定义 SEO 报告中。

完整的实现示例请参见此处：

https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

使用标签整理关键词

如果缺乏组织，庞大的关键词组合将难以管理。

Ranktracker 提供了账户级标签，可将其附加到被追踪的关键词上。

您可以创建以下类型的标签：

产品类别
搜索意图
位置
内容类型
广告系列
客户
营销漏斗阶段
业务部门
SEO 团队

例如：

“购买跑鞋” → 商业类
“最佳跑鞋” → 比较类
“如何清洁跑鞋” → 信息类

相同的标签可在不同域名和关键词组之间重复使用。

Ranktracker 还提供批量标记功能，因此无需逐个操作即可对大量关键词进行整理。

监控账户使用情况和配额

自动化系统也需要了解其可用的账户资源。

Ranktracker API 提供以下接口：

GET /v1/account/usage

此端点报告账户使用情况和限制。

当前使用情况信息可能包括：

API 访问状态
关键词
数据行
按需使用
SERP Analyser 使用情况

每个配额可提供如下数值：

使用情况
限制
剩余

这使应用程序能够在启动大规模操作之前检查可用容量。

例如，在导入数千个关键词之前，您的系统可以查询账户使用情况，并确定剩余容量有多少。

阅读完整指南：

https://developers.ranktracker.com/guides/usage-and-quota/

Ranktracker API 身份验证原理

Ranktracker REST API 请求通过 API 密钥进行身份验证。

您可以在 Ranktracker 内直接创建和管理 API 密钥：

https://app.ranktracker.com/account/api

请务必将您的 API 密钥视为密码来处理。

生产环境的 API 基础 URL 为：

https://api.ranktracker.com

API 资源位于/v1路径下。

例如：

https://api.ranktracker.com/v1/domains

API 密钥直接包含在Authorization头部中。

标准 REST API 请求中不使用 Bearer前缀。

示例：

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_your_api_key_here"

Ranktracker API 密钥应保存在服务器端，切勿通过以下方式泄露：

浏览器 JavaScript
前端源代码
公开仓库
移动应用代码
公开配置文件

如需了解更多信息，请参阅：

快速入门： https://developers.ranktracker.com/guides/quickstart/

身份验证： https://developers.ranktracker.com/guides/authentication/

创建/管理 API 密钥： https://app.ranktracker.com/account/api

API 资源结构

Ranktracker 使用 UUID 来标识资源。

其中包括以下资源：

域名
关键词
竞争对手
标签

简化表示如下：

账户
│
├── 使用情况
├── 标签
│
└── 域名
    │
    ├── 排名历史
    ├── 市场份额
    ├── 竞争对手
    │
    └── 关键词
        │
        ├── 搜索结果页面 (SERP)
        ├── 搜索结果页面 HTML 缓存
        └── 标签

这使得 API 结构易于预测。

一个域名包含关键词和竞争对手。

每个关键词都属于一个被追踪的域名，并关联相应的搜索结果页面（SERP）和排名信息。

标签存在于账户级别，并可关联到关键词。

阅读更多：

https://developers.ranktracker.com/guides/concepts/

JSON API 响应

Ranktracker 的响应采用统一的 JSON:API 风格封装。

资源存储在data 下，其字段则存储在attributes 下。

例如：

{
  "data": {
    "id": "DOMAIN_UUID",
    "type": "domain",
    "attributes": {
      "host": "www.example.com",
      "projectName": "Example",
      "matchType": "any"
    }
  }
}

开发人员还应注意一项重要的命名约定：

API 响应采用驼峰式命名法
写入请求正文使用snake_case

例如，响应中可能包含：

projectName

而写入请求则使用：

project_name

此约定适用于整个 API。

参见：

https://developers.ranktracker.com/guides/concepts/

分页

列表端点支持分页，以便应用程序能够高效处理大型 Ranktracker 账户。

分页功能适用于以下资源：

域名
关键词
竞争对手
标签

两个主要参数为：

page
每页

per_page支持每页最多1,000 条记录。

分页信息通过响应头返回，包括：

X-总计
X-总页数
X-每页
X-当前页

因此，对于大规模导出，应用程序可以持续请求各页数据，直至获取完整的数据集。

阅读分页指南：

https://developers.ranktracker.com/guides/pagination/

错误处理与速率限制

Ranktracker API 使用标准的 HTTP 状态码，以便通过编程方式更轻松地处理错误。

常见的响应包括：

状态	含义	示例
`400`	请求错误	缺少必填参数或参数格式错误
`402`	配额已满	所请求的操作将超出账户配额限制
`403`	禁止	请求未获授权或 API 不可用
`404`	未找到	该资源在该账户中不存在
`422`	验证错误	该请求为有效的 JSON，但包含无效数据
`429`	请求次数过多	该集成已达到速率限制

当出现429响应时，集成程序应在重试前遵守返回的Retry-After信息。

这使得生产环境中的应用程序能够处理临时限流，而不会直接报错。

完整的错误和速率限制文档可在此处查阅：

https://developers.ranktracker.com/guides/errors-and-rate-limits/

Ranktracker REST API 与 MCP 的对比

REST API 并不是将外部软件连接到 Ranktracker 的唯一方式。

Ranktracker 还提供了一个托管的MCP 服务器。

MCP 代表“模型上下文协议”（Model Context Protocol），它允许兼容的 AI 应用程序和代理直接处理 Ranktracker 数据。

这包括以下兼容客户端：

ChatGPT
Claude
光标
其他兼容MCP的AI应用程序

REST 和 MCP 虽然都与相同的底层 Ranktracker 数据进行交互，但它们的设计目的是满足不同的工作流程。

	Ranktracker REST API	Ranktracker MCP
最适合	应用程序、仪表盘、数据仓库和定时任务	AI 助手和智能代理
调用方	您的后端或 HTTP 客户端	ChatGPT、Claude、Cursor 或其他 MCP 客户端
接口	REST 端点	MCP 工具
REST 路径	`/v1/...`	`/mcp`
典型用法	自动迁移和管理SEO数据	以对话方式探索SEO数据

例如，如果您希望：

每晚导出排名
更新BI仪表盘
自动创建SEO项目
从您的应用程序中添加关键词
将排名数据与数据库同步

MCP 则更适合处理以下类型的问题：

本周我追踪的关键词中，哪个排名跌幅最大？

或者：

哪些竞争对手的曝光度提升最多？

AI 客户端可以选择合适的 Ranktracker 工具并查询相关数据。

许多高级 SEO 团队可以同时使用这两种工具。

REST 负责基础设施和自动化处理。MCP 则使 Ranktracker 数据可供 AI 代理使用。

了解更多：

MCP 概述： https://developers.ranktracker.com/mcp/

连接 MCP 客户端： https://developers.ranktracker.com/mcp/connect/

MCP 工具参考： https://developers.ranktracker.com/mcp/tools/

您可以使用 Ranktracker API 构建什么？

Ranktracker API 的用途远不止于显示关键词排名。

以下是一些最实用的应用示例。

自动化 SEO 报告

代理机构可以自动将排名信息导入其自身的报告平台。

无需再：

打开 Ranktracker
↓
导出 CSV
↓
编辑电子表格
↓
上传报告
↓
发送给客户

您可以构建：

Ranktracker API
↓
报告平台
↓
自动更新的客户报告

这对管理大量客户的代理机构而言尤为宝贵。

自定义 SEO 仪表盘

贵公司可能已经在使用内部报告或商业智能平台。

通过该 API，Ranktracker 数据可成为该环境中的另一个数据源。

您可以构建展示以下内容的仪表盘：

关键词排名
排名变化
前3名关键词
前10个关键词
前100个关键词
市场声量
竞争对手可见度
搜索结果页面（SERP）功能
AI概览展示次数

生成的仪表盘可根据贵公司的具体报告需求进行定制。

自动化客户入职流程

SEO 机构可将 Ranktracker 集成到其客户入职流程中。

例如：

客户购买SEO套餐
↓
CRM系统创建客户记录
↓
Ranktracker API创建域名
↓
添加关键词
↓
添加竞争对手
↓
开始跟踪

这消除了重复的手动项目设置工作。

SEO 数据仓库

当排名数据与其他营销及业务数据相结合时，其价值将进一步提升。

Ranktracker 的信息可与以下数据结合使用：

Google 搜索控制台
分析
CRM数据
转化数据
电子商务收入
潜在客户数据
内容表现

这有助于解答比单纯查看排名更为重要的问题。

例如：

哪些排名提升带来了最多的收入？

或者：

哪些关键词组虽然提高了曝光度，却未能带来转化？

排名提醒

历史排名数据还可以为自定义警报系统提供支持。

通过集成，系统可以自动检测以下情况：

某个关键词跌出前三名
某页面进入前10名
某个关键词进入前100名
一个主要关键词从前100名中消失
竞争对手超越了您的网站
搜索可见度急剧下降

随后，警报可发送至您的邮箱、Slack、内部仪表盘或监控系统。

竞争情报

结合：

排名
竞争对手追踪
排名历史
市场声量

为自动化竞争性 SEO 监控系统奠定了基础。

无需每隔几个月才评估一次竞争对手，他们的搜索可见度可以成为一个持续监控的指标。

程序化SEO监控

程序化SEO可以生成数千甚至数十万个着陆页。

手动监控这些项目是不现实的。

Ranktracker API 允许开发人员构建排名工作流，这些工作流能够处理大型关键词数据集，并将生成的信息自动推送至内部分析系统。

基于 AI 的 SEO 分析

Ranktracker 的 REST API 和 MCP 服务器也可成为 AI 驱动的 SEO 工作流的一部分。

例如，AI 系统可以提供以下帮助：

识别排名下滑
汇总排名变化
查找快速提升的关键词
比较竞争对手的曝光度
分析搜索结果页面（SERP）的变化
确定SEO机会的优先级
生成内部分报
调查异常的排名波动

API 提供结构化数据，而 AI 则可协助解读这些数据。

Ranktracker API 适合哪些用户？

Ranktracker API 特别适用于：

SEO机构
企业SEO团队
SaaS企业
SEO软件公司
开发人员
数据工程师
商业智能（BI）团队
电子商务企业
联盟营销人员
发布商
多地点企业
程序化SEO团队
AI自动化团队

如果需要自动检索、转移、分析或管理排名数据，API 通常比手动导出更具可扩展性。

为何选择 Ranktracker 而不是自行构建排名跟踪基础设施？

大规模收集搜索排名远非仅仅进行一次谷歌搜索那么简单。

一个正式投入使用的排名跟踪系统需要考虑以下方面：

地点
语言
设备
前100名搜索结果集合
搜索结果页面（SERP）功能
AI 概览
关键词配置
历史排名数据
竞争对手
排程
搜索结果变化
数据存储
报告

在内部构建和维护所有这些基础设施可能会消耗大量的开发资源。

Ranktracker 负责处理排名跟踪基础设施，并通过结构化 API 提供生成的数据。

因此，您的开发人员可以专注于构建业务真正需要的应用程序、仪表盘、工作流或分析功能。

如何开始使用 Ranktracker API

只需几个步骤即可开始使用。

1. 打开您的 API 设置

直接访问：

https://app.ranktracker.com/account/api

创建一个 API 密钥并妥善保管。

2. 阅读快速入门指南

请按照官方快速入门指南操作：

https://developers.ranktracker.com/guides/quickstart/

3. 发送您的第一个请求

例如：

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_your_api_key_here"

4. 探索 API 参考文档

完整的 REST API 参考文档请参见此处：

https://developers.ranktracker.com/rest-api/

5. 开始构建

在此基础上，您可以开始将 Ranktracker 连接到：

您的应用程序
您的报表架构
您的数据仓库
您的客户关系管理（CRM）系统
您的内部工具
您的人工智能工作流

Ranktracker API 文档

完整的开发者文档请参见：

开发者文档： https://developers.ranktracker.com/

创建和管理 API 密钥： https://app.ranktracker.com/account/api

快速入门： https://developers.ranktracker.com/guides/quickstart/

身份验证： https://developers.ranktracker.com/guides/authentication/

核心概念： https://developers.ranktracker.com/guides/concepts/

分页： https://developers.ranktracker.com/guides/pagination/

错误与速率限制： https://developers.ranktracker.com/guides/errors-and-rate-limits/

使用方法与配额： https://developers.ranktracker.com/guides/usage-and-quota/

批量操作： https://developers.ranktracker.com/guides/bulk-operations/

跟踪域名的教程： https://developers.ranktracker.com/guides/tutorials/track-a-domain/

将排名数据导入数据仓库教程： https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

市场份额教程： https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

批量标记教程： https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

REST API 参考文档： https://developers.ranktracker.com/rest-api/

MCP 服务器： https://developers.ranktracker.com/mcp/