使用 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。
评论
文章评论已关闭。