使用 Similarweb 的免费 DigitalRank API 获取您的网站以及竞争对手网站的全球网站排名数据。
如何使用网站排名 API
查看各大网站的可视化表现、了解您的网站在竞争对手和行业中的排名可能并非易事。Similarweb 提供多种 API 解决方案,包括全新的 Similarweb 网站 DigitalRank API。
网站 DigitalRank API 为您免费*提供全球网站排名数据,方便您
- 将自己的网站与竞争对手对标
- 识别新的增长机会
- 证明您的网站运营成功
- 发现潜在的合作伙伴
Similarweb 利用我们 10 多年来收集的 100 亿个日常数字信号生成数字排名和流量数据。这个庞大的信号网络提供了规模效应和准确性,让 Similarweb 成为数字智能领域的领导者。
DigitalRank API 基于简单的 REST 原则,采用标准的 HTTP 响应码和身份验证。
目录:
> 技术文档和说明 |
网站 DigitalRank API 新手入门
首先,您需要创建一个免费的 Similarweb 账号并生成个人 API 密钥。请按照以下 5 个步骤操作:
- 创建免费 Similarweb 账号。
- 点击设置图标,选择账号。
- 在 API 页面中,点击“生成新 API 密钥”。
- 为密钥输入名称,例如“MySimilarwebAPIKey”,然后点击“创建”。您的 API 密钥将显示在“已生成的密钥”表格中。
- 请参考以下文档,开始提取全球排名数据。
注意:使用 Similarweb API,即表示您同意使用条款、隐私政策,以及下方的外部使用准则。
* 每月最多可免费获得 5000 个数据点。如需更多数据或功能,请联系销售代表。
技术文档
Similarweb DigitalRank API 有三种可调用的 API 端点:
- 热门 SimilarRank 网站:发现全球排名靠前的网站。
- 网站 SimilarRank:了解特定网站的全球排名。
- 获取订阅状态:查看您的 SimilarRank 账号每月 5000 个限定数据点的剩余数量。
热门 SimilarRank 网站
调用此端点可了解全球排名靠前的网站:
URL 输入: |
https://api.similarweb.com/v1/similar-rank/top-sites?api_key={{similarweb_api_key}}&limit={{50}} |
输入参数: |
|
响应示例:
扣除点数:每条结果扣除 1 个数据点。在响应示例中,限值设置为 3,这意味着将扣除 3 个数据点。
注:
- 最大结果数 = 5000
- 数据基于上个月的流量和参与度数据,PC 端和移动设备数据均包含在内。
- 响应头中列出了本次查询所消耗的数据点数量(请见“sw-datapoint-charged”)
网站 SimilarRank
了解特定网站的全球排名:
URL 输入: |
https://api.similarweb.com/v1/similar-rank/{{domain.com}}/rank?api_key={{similarweb_api_key}} |
输入参数: |
|
响应示例:
扣除点数:每条结果扣除 1 个数据点。
注:
- 数据基于上个月的流量和参与度数据,PC 端和移动设备数据均包含在内。
- 响应头中列出了本次查询所消耗的数据点数量(请见“sw-datapoint-charged”)
获取订阅状态
查看您的 SimilarRank 账号每月 5000 个限定数据点的剩余数量。
URL 输入: |
https://api.similarweb.com/user-capabilities?api_key={{similarweb_api_key}} |
输入参数: |
“similarweb_api_key”:输入您的个人 API 密钥(请删除大括号) |
响应示例: |
![]() |
扣除点数:使用此端点不消耗数据点。
注:月数据点在每月 1 日刷新。
常见问题和错误代码
问:我在哪里可以获得用于 DigitalRank API 的 Similarweb API 密钥? |
答:请在此注册,我们将通过电子邮件向您发送 API 密钥(请等待几个工作日)。 |
问:Similarweb 如何计算 DigitalRank API 的数据点消耗? |
答:一条域名排名结果计为一个数据点。 |
问:我会获得多少个 API 数据点? |
答:每月月初,您的密钥将刷新 5000 个数据点。未使用的数据点将不会累积到下一个月。 |
您可以通过“获取订阅状态”端点查询每月的剩余数据点数(请参阅上面的文档)。 |
问:我没有剩余的 API 数据点了。如何获得更多点数? |
答:DigitalRank API 用户的每月数据点上限为 5000 个。如果您需要更多数据或功能,请联系销售代表。 |
问:如果我目前拥有 Similarweb 高级账号的 API 密钥,我可以使用 DigitalRank API 端点吗? |
答:可以。您可以通过现有的 Similarweb API 密钥访问 DigitalRank API 端点。请注意,这将扣除您的高级 API 点击次数。 |
问:我可以在哪里详细了解 Similarweb 的数据测量方法? |
答:您可以在此详细阅读我们使用的方法。 |
问:全球排名是如何计算的? |
答:Similarweb 的专有全球排名计算方法基于网站的独立访问者数量和网页浏览量。请访问词汇表以了解更多信息。 |
问:全球排名数据的刷新频率如何? |
答:全球排名数据每月刷新一次。数据在次月 10 号前发布(大多数情况下会提前发布)。更新后,数据在一个月内保持不变。 |
问:我弄错了。数据点还可以退吗? |
答:很遗憾,数据点目前无法退还。我们将在每月初为您的 API 密钥分配 5000 个新数据点。 |
错误代码
403:已达到每月数据点上限。请联系销售代表,了解我们的高级计划。
401:这是一个 Similarweb 高级端点。请联系销售代表了解详情。
400:超出限值。限值字段中的数字必须介于 1 和 5000 之间。
404:未找到数据。此网站可能还没有全球排名。
429:短时间内的请求次数过多。如果您每秒发出 10 个以上请求,就可能会出现这种情况。
Similarweb 数据的外部使用准则
您可以使用 DigitalRank API 提取数据并在内部使用,以及/或者在您的平台产品中提供这些数据。如果您要在您的平台上展示这些数据,您(以及使用数据和/或运营平台的所有人)必须遵守以下条款:
- 您仅可展示 Similarweb DigitalRank API 端点中可用的指标。
- 如果 Similarweb 出于监测本准则履行情况的目的提出要求,您应向 Similarweb 授予免费、完整的平台访问许可。
- 每当您在平台上使用 Similarweb 数据时,您都应在使用数据的每个页面清晰、显著地标明 Similarweb 的品牌和重要信息,至少应包括 Similarweb 的名称和徽标、“DigitalRank by Similarweb”字样,以及 www.similarweb.com 链接;所有这些标识都应符合 Similarweb 的品牌准则,准则内容见以下链接:https://company-212865.frontify.com/d/N8HWGuVHeoVg/brand-guidelines
- 您不得将这些数据用于与 Similarweb 竞争。
- 您必须确保,显示在您平台上的数据不会有任何部分因任何保密条款、使用条款或其他与平台使用相关的限制要求而被剔除。
- 您不得通过平台用户或其他第三方可访问的任何 API 产品提供任何 Similarweb 数据或 Similarweb API 端点,包括但不限于通过 DigitalRank API 获取的数据,除非此类数据已与其他数据集合,因此不再可认定为 Similarweb 提供的数据。
了解详情
进一步了解 Similarweb API。
评论
文章评论已关闭。