1. ZH
  2. API &整合
  3. 入门指南

网站 DigitalRank API

Toggle navigation

使用 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。

 

这篇文章有帮助吗？
68 人中有 50 人觉得有帮助