Docs
搜索文档...⌘K

SERP 概览

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

查询参数

selectstring必填

要返回的列（逗号分隔）。有效的列标识符请参见响应 Schema。

keywordstring必填

要返回 SERP 概览的关键词。

countrystring必填

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

允许的值:adaeafagaialamaoarasatauawazba…
comparison_countriesstring

用于返回目标 SERP 中 URL 排名的其他国家/地区。选择 country 以区分各行。不可用的 SERP 会被省略。

允许的值:adaeafagaialamaoarasatauawazba…
datestring (date-time)

用于返回最后一个可用 SERP 概览的时间戳，格式为 YYYY-MM-DDThh:mm:ss。如果未指定，则返回最新的 SERP 概览。

top_positionsinteger

要返回的自然搜索 SERP 顶部排名数量。如果未指定，则会返回所有可用排名。

typestring

用于筛选的 SERP 特性类型列表（以逗号分隔）。只返回其 type 至少包含一个给定值的位置。如果未指定，则返回所有类型的位置。

允许的值:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
outputstring

输出格式。

允许的值:jsonphpxml

响应

positionsarray<object>
ahrefs_rankinteger or null

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

backlinksinteger or null

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

countrystring

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

允许的值:ADAEAFAGAIALAMAOAQARASATAUAWAX…
domain_ratingnumber (float) or null

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

keywordsinteger or null

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

page_typestring or null

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

positioninteger

搜索结果在 SERP 中的位置。

refdomainsinteger or null

(5 units) 链接到搜索结果的唯一域名总数。

titlestring or null

排名页面的标题。

top_keywordstring or null

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

top_keyword_volumeinteger or null

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

trafficinteger or null

(10 units) 估算结果从其所有排名关键词中获得的每月自然搜索流量。

typearray<string>

排名类型：自然、付费或 SERP 特性。

允许的值:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
update_datestring (date-time)

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

urlstring or null

排名页面的 URL。

url_ratingnumber (float) or null

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

valueinteger or null

(10 units) 页面每月自然搜索流量的预估价值，以美元分计。