网站 DigitalRank API

使用 Similarweb 的免费 DigitalRank API 获取您的网站以及竞争对手网站的全球网站排名数据。

 

如何使用网站排名 API

查看各大网站的可视化表现、了解您的网站在竞争对手和行业中的排名可能并非易事。Similarweb 提供多种 API 解决方案,包括全新的 Similarweb 网站 DigitalRank API。

网站 DigitalRank API 为您免费*提供全球网站排名数据,方便您

  • 将自己的网站与竞争对手对标
  • 识别新的增长机会
  • 证明您的网站运营成功
  • 发现潜在的合作伙伴

Similarweb 利用我们 10 多年来收集的 100 亿个日常数字信号生成数字排名和流量数据。这个庞大的信号网络提供了规模效应和准确性,让 Similarweb 成为数字智能领域的领导者。

DigitalRank API 基于简单的 REST 原则,采用标准的 HTTP 响应码和身份验证。

162271ca73a57b.png

目录:

> DigitalRank API 新手入门

> 技术文档和说明

> 常见问题和错误代码

> Similarweb 数据的外部使用准则

162271ca73a57b.png

网站 DigitalRank API 新手入门

首先,您需要创建一个免费的 Similarweb 账号并生成个人 API 密钥。请按照以下 5 个步骤操作:

  1. 创建免费 Similarweb 账号
  2. 点击设置图标,选择账号
  3. API 页面中,点击“生成新 API 密钥”。
  4. 为密钥输入名称,例如“MySimilarwebAPIKey”,然后点击“创建”。您的 API 密钥将显示在“已生成的密钥”表格中。
  5. 请参考以下文档,开始提取全球排名数据。

注意:使用 Similarweb API,即表示您同意使用条款隐私政策,以及下方的外部使用准则

* 每月最多可免费获得 5000 个数据点。如需更多数据或功能,请联系销售代表

 

技术文档

Similarweb DigitalRank API 有三种可调用的 API 端点:

162271ca73a57b.png

热门 SimilarRank 网站

调用此端点可了解全球排名靠前的网站:

URL 输入:

https://api.similarweb.com/v1/similar-rank/top-sites?api_key={{similarweb_api_key}}&limit={{50}}

 

输入参数:


similarweb_api_key”:输入您的个人 API 密钥(请删除大括号)

limit”:输入所需结果的数量,默认值为 10(请删除大括号)

响应示例:

162271ca73bae3.png

扣除点数:每条结果扣除 1 个数据点。在响应示例中,限值设置为 3,这意味着将扣除 3 个数据点。

注:

  • 最大结果数 = 5000
  • 数据基于上个月的流量和参与度数据,PC 端和移动设备数据均包含在内。
  • 响应头中列出了本次查询所消耗的数据点数量(请见“sw-datapoint-charged”)

162271ca73a57b.png

网站 SimilarRank

了解特定网站的全球排名:

URL 输入:

https://api.similarweb.com/v1/similar-rank/{{domain.com}}/rank?api_key={{similarweb_api_key}}

输入参数:

domain.com”:输入域名(请删除大括号)

similarweb_api_key”:输入您的个人 API 密钥(请删除大括号)

 

响应示例:

162271c2a615ab.png

扣除点数:每条结果扣除 1 个数据点。

注:

  • 数据基于上个月的流量和参与度数据,PC 端和移动设备数据均包含在内。
  • 响应头中列出了本次查询所消耗的数据点数量(请见“sw-datapoint-charged”)

162271ca73a57b.png

获取订阅状态

查看您的 SimilarRank 账号每月 5000 个限定数据点的剩余数量。

URL 输入:

https://api.similarweb.com/user-capabilities?api_key={{similarweb_api_key}}

输入参数:

similarweb_api_key”:输入您的个人 API 密钥(请删除大括号)

响应示例:

162271ca73e41c.png

扣除点数:使用此端点不消耗数据点。

注:月数据点在每月 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

 

这篇文章有帮助吗?
17 人中有 14 人觉得有帮助