SERP 概览
API + MCPGET/v3/serp-overview/serp-overview
查询参数
selectstring必填
要返回的列的逗号分隔列表。有效的列标识符请参见响应 Schema。
top_positionsinteger
要返回的自然 SERP 前 N 个排名位置数量。如未指定，将返回所有可用位置。
datestring
用于返回最近一次可用 SERP 概览的时间戳，格式为 YYYY-MM-DDThh:mm:ss。如未指定，将返回最新的 SERP 概览。
countrystring必填
两个字母的国家代码（ISO 3166-1 alpha-2）。
允许的值:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
keywordstring必填
要返回 SERP 概览的关键词。
outputstring
输出格式。
允许的值:jsoncsvxmlphp
响应
positionsarray<object>
ahrefs_rankinteger or null
目标的反向链接概况强度，通过与数据库中其他网站对比得出，排名第一代表最强。
backlinksinteger or null
指向搜索结果的其他网站链接总数。
domain_ratingnumber 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 特性。
Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
update_datestring
检查搜索引擎搜索关键词结果的日期。
urlstring or null
排名页面的 URL。
url_ratingnumber or null
以 100 点对数刻度衡量的页面反向链接配置文件强度。
valueinteger or null
(10 units) 页面每月自然搜索流量的预估价值，以美元分计。
errorstring
errorstring
errorstring
errorstring
errorstring