关键词
API + MCPGET/v3/gsc/keywords
对此端点的请求免费，不会消耗任何 API 单位。
查询参数
project_idinteger
项目 ID。当未提供 portfolio_id 时必填。
portfolio_idinteger
Portfolio ID。提供后，将汇总该 Portfolio 中所有已连接 GSC 的项目数据。
date_fromstring (date)必填
历史时间段的开始日期，格式为 YYYY-MM-DD。
date_tostring (date)
历史时间段的结束日期，格式为 YYYY-MM-DD。
search_typestring
要返回的搜索结果类型（网页、图片、视频、新闻）。
允许的值:webimagevideonews
默认:web
countrystring
由两个字母组成的国家/地区代码（ISO 3166-1 alpha-2）。
允许的值:adaeafagaialamaoarasatauawazba…
devicestring
按设备类型筛选（DESKTOP、MOBILE、TABLET）。如未指定，则包含所有设备。
允许的值:desktopmobiletablet
limitinteger
要返回的结果数量。
默认:1000
wherestring
支持以下字段：
keyword_list_idinteger
要显示其指标的现有关键词列表 ID。
keyword_listsstring
关键字列表筛选条件（JSON 字符串）。支持包含（is）、排除（is_not）、空（empty，不在任何列表中）和非空（not_empty，在任一列表中）。
outputstring
输出格式。
允许的值:jsonphpxml
响应
keywordsarray<object>
clicksinteger or null
ctrnumber (float) or null
impressionsinteger or null
keywordstring
keyword_list_labelsarray<string>
positionnumber (float) or null
平均排名（小数，例如 4.7）
top_urlstring (url) or null
urls_countinteger
errorstring
errorstring
errorstring
errorstring
errorstring