SERP 概览

API + MCP

GET/v3/rank-tracker/serp-overview

对此端点的请求免费，不会消耗任何 API 单位。

查询参数

project_idinteger必填

项目的唯一标识符。你可以在 Ahrefs 中你的 Rank Tracker 项目的 URL 中找到它：https://app.ahrefs.com/rank-tracker/overview/#project_id#

keywordstring必填

The keyword to return SERP Overview for.

language_codestring

The language code of a tracked keyword.You can use the management/project-keywords endpoint to get country codes, language codes and location IDs for your tracked keywords.

countrystring必填

由两个字母组成的国家/地区代码（ISO 3166-1 alpha-2）。

允许的值:adaeafagaialamaoarasatauawazba…

location_idinteger

The location ID of a tracked keyword.You can use the management/project-keywords endpoint to get country codes, language codes and location IDs for your tracked keywords.

datestring (date-time)

A timestamp on which the last available SERP Overview is returned in YYYY-MM-DDThh:mm:ss format. If it is not specified, the most recent SERP Overview is returned.

devicestring必填

在移动端和桌面端排名之间选择。

允许的值:desktopmobile

top_positionsinteger

The number of top organic SERP positions to return. If not specified, all available positions will be returned.

outputstring

输出格式。

允许的值:jsoncsvxmlphp

响应

positionsarray<object>

ahrefs_rankinteger or null

目标的反向链接概况强度，通过与数据库中其他网站对比得出，排名第一代表最强。

backlinksinteger or null

指向搜索结果的其他网站链接总数。

domain_ratingnumber (float) or null

以 100 分制衡量，与我们数据库中其他网站相比，该域名反向链接配置文件的强度。

keywordsinteger or null

搜索结果在前100个自然排名中排名的关键词总数。

nr_wordsinteger or null

HTML网页中的单词总数。

page_typestring or null

针对排名页面的 AI 预测分层页面类型路径的逗号分隔列表。每个值均为以斜杠开头的路径（例如 /Article/How_to）。

positioninteger

搜索结果在 SERP 中的位置。

refdomainsinteger or null

链接到搜索结果的唯一域名的总数。

titlestring or null

排名页面的标题。

top_keywordstring or null

为搜索结果带来最多自然流量的关键词。

top_keyword_volumeinteger or null

基于过去 12 个月的已知数据估算出的热门关键词平均每月搜索量。

trafficinteger or null

对某一结果从其所有排名关键词中获得的每月自然搜索流量的估算值。

typearray<string>

排名位置的类型：自然、付费或 SERP 特性。允许的取值：ai_overview、ai_overview_sitelink、discussion、image、image_th、knowledge_card、knowledge_panel、local_pack、organic、organic_shopping、paid_top、paid_bottom、paid_right、question、sitelink、snippet、top_story、tweet、video、video_th。

update_datestring (date)

检查搜索引擎搜索关键词结果的日期。

urlstring (url) or null

排名页面的 URL。

url_ratingnumber (float) or null

以 100 点对数刻度衡量的页面反向链接配置文件强度。

valueinteger or null

页面每月自然搜索流量的估算价值，以美分计。