Docs
搜索文档...⌘K

SERP 概览

API + MCP
GET/v3/rank-tracker/serp-overview

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

查询参数

top_positionsinteger

要返回的自然 SERP 前 N 个排名位置数量。如未指定,将返回所有可用位置。

devicestring必填

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

允许的值:desktopmobile
datestring

用于返回最近一次可用 SERP 概览的时间戳,格式为 YYYY-MM-DDThh:mm:ss。如未指定,将返回最新的 SERP 概览。

location_idinteger

已跟踪关键词的位置 ID。您可以使用 management/project-keywords 端点获取已跟踪关键词的国家/地区代码、语言代码和位置 ID。

countrystring必填

两个字母的国家代码(ISO 3166-1 alpha-2)。

允许的值:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
language_codestring

已跟踪关键词的语言代码。您可以使用 management/project-keywords 端点获取已跟踪关键词的国家/地区代码、语言代码和位置 ID。

keywordstring必填

要返回 SERP 概览的关键词。

project_idinteger必填

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

outputstring

输出格式。

允许的值:jsoncsvxmlphp

响应

positionsarray<object>
ahrefs_rankinteger or null

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

backlinksinteger or null

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

domain_ratingnumber 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_overviewai_overview_sitelinkdiscussionimageimage_thknowledge_cardknowledge_panellocal_packorganicorganic_shoppingpaid_toppaid_bottompaid_rightquestionsitelinksnippettop_storytweetvideovideo_th

update_datestring

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

urlstring or null

排名页面的 URL。

url_ratingnumber or null

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

valueinteger or null

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