API

此 API 作为 SEO 工具箱订阅的 Business 套餐附加功能提供。 标准 API 选项包含 Analytics 和 Projects API。 升级到 Business 套餐后，您将有机会购买 API 单元并生成 API 密钥。

请注意，升级到 Business 套餐后，单元数量仍然为零。 您应根据自身需求购买合适数量的 API 单元——这些单元有 2,000,000, 5,000,000, 10,000,000 或 20,000,000 的可扩展套餐可供选择。 已购买的单元包含在您的循环订阅中，并会在与您的套餐相同的日期续订。 未使用的单元将在到期后失效，不会加入续订后的数量中。

当单元用完时，您可以在 订阅信息页面购买更多单元，或联系我们。 

了解如何获取 API，请参见此处。

• Analytics API 可让您提取 Analytics 报告中的数据，包括：

  • 域名分析 
  • 关键词分析 
  • 反向链接

• Projects API 可以从在 Projects 中创建的排名跟踪和网站检测活动中提取数据。 您还可以借助 Projects API 管理您的项目（例如创建，更新或删除项目）。

可以通过 API 获取子文件夹，子域名和 URL 数据。 请查看 API 文档中的 子域名，子文件夹或 URL 部分，了解您可以从哪些报告中提取数据。

Analytics 和 Projects API 调用各自都会产生 API 单元成本。 您需要消耗的单元总数取决于请求类型或报告中的确切行数。



您可以在 订阅信息选项卡中，或通过免费的 API 请求（API 单元余额）查看您的 API 单元余额。

请点击此处查看 API 可提取的 Semrush 报告完整列表。 您可以在 订阅信息 页面上找到您的 API 密钥。   

Trends API（流量与市场工具箱数据）仅对付费 Semrush 用户开放，并提供 2 种套餐：

• Trends Basic API：提供广泛的流量摘要，包括网站流量指标和用户行为数据
• Trends Premium API：除 Trends Basic API 包含的所有内容外，还提供 16 种额外的数据类型，帮助您更深入地了解市场动态，竞争对手策略和网站流量走势 

Trends Basic API

Trends Basic API 可提供网站流量和访客行为的估算数据。 这些数据包括每月访问次数，独立访问次数，每次访问页数，平均访问时长，移动设备与桌面流量百分比，跳出率以及域名类别。

您可以使用摘要报告在单次请求中提取最多 200 个域名的流量数据。 这些数据可让您快速概览网站与其访客之间的整体互动水平。

Trends Basic API 调用适用于根域名，子域名和子文件夹，但流量排名，受众洞察和数据准确性除外。

Trends Premium API

Trends Premium API（完整详情请参见API 文档）除 Trends Basic API 的流量概览数据外，还提供 16 个不同的报告：

• 每日流量：按天跟踪的网站访客数量。
• 每周流量：按周跟踪的网站访客数量。
• 购买转化：完成所需操作的访客所占百分比，例如购买。
• 行业类别：网站访客来源的各类行业领域。
• 流量来源：按直接访问，引荐，自然搜索，付费搜索，自然社交，付费社交，电子邮件和展示广告划分的网站流量。
• 流量去向：用户在访问您正在查看的域名后会去往哪里。
• 子域名流量：获取流量最多的网站子域名。
• 子文件夹流量：获取最多流量的网站子文件夹。
• 地理分布：网站获取最多访客的国家，地区或次大陆。
• 主要页面：基于流量，最多可显示网站流量排名前 1000 个页面的唯一身份网页浏览量，唯一身份访问量，入口和流量来源。
• 流量排名：按流量对目标地区在目标时间段内的热门网站进行排序。
• 受众洞察：您输入的域名的其他访问域名，唯一受众，共享受众百分比和共享受众。
• 年龄和性别分布：男性和女性用户的人数及占比，以及其按年龄的分布。
• 家庭规模，收入，教育程度和就业状况分布：
  • 家庭规模分布：按家庭规模划分的域名受众细分。
  • 收入分布：低收入，中等收入或高收入用户的数量和占比。
  • 教育程度分布：拥有研究生学历，大学/学院学历，学校教育，或未完成教育的用户数量和占比。
  • 就业状况分布：按就业状况划分的域名受众。
• 受众兴趣：基于访问过的域名类别得出的目标受众关键兴趣。
• 社交媒体偏好：市场受众最常访问的社交媒体平台。

默认月度限制为 10,000 次请求。 Trends API 单元将在您订阅的付款日每月刷新。 此 API 不会使用 SEO 工具箱订阅 Business 套餐标准 Semrush API 选项关联的任何 API 单元。

如果您对 Trends API 感兴趣，可通过 订阅信息页面访问。

或者，您也可以通过此表单联系我们的销售团队，我们将为您提供符合需求的报价。

要购买 Trends API，您需要拥有付费的 Semrush 账户。 您可以自行购买 API 访问权限，也可以通过我们的销售代表购买，然后通过电子邮件获取您的 API 密钥。

下面的API 文档页面将是使用 API 的关键，因为其中会逐一拆解并说明每个调用。 系统还会显示正确的格式，方便您正确构建 API 调用。 您可以将 API 调用粘贴到网页浏览器中来执行这些调用。

请使用以下文档链接查找有关 API 的帮助：

• API 简介

• Semrush API 入门

• 用例

• Analytics API （域名分析，关键词分析，反向链接等）
• Projects API（排名跟踪，网站检测）
• API 单元余额
• Trends API 文档
• API 使用条款

请注意，在我们的服务条款第 2.3 节中，我们要求您不要通过我们的 API 每秒发起超过 10 次查询：

如果您订阅了 Semrush API，除上述限制外，您还同意：(i) 不从一个唯一 IP 地址每 1 秒转发超过 10 次查询，或从 1 个用户同时发起超过 10 次查询；以及 (ii) 未经 Semrush 明确书面同意，不得将从服务收到的信息缓存超过（1）个月。 如果根据您居住所在国家或访问，使用本服务所在国家/地区的法律，您在法律上被禁止接收或使用本服务，则您不得使用本服务。