Google 已排名（实时）

POST /v3/dataforseo_labs/google/ranked_keywords/live

接口说明

该接口用于查询任意域名、子域名或网页 URL 当前在 Google 中有排名的列表。除本身外，响应还会返回对应的 SERP素、排名位置、月搜索量，以及与和排名的扩展数据。

数据更新频率：每周
最新更新时间可通过 /v3/dataforseo_labs/status/ 查询
请求方式：POST
接口地址：https://api.seermartech.cn/v3/dataforseo_labs/google/ranked_keywords/live

计费与限流

本接口按请求计费
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准
当启用 include_clickstream_data=true 时，请求费用翻倍
频率限制：最多 2000 次 API 调用/分钟
并发限制：最多 30 个同时进行中的请求

请求体格式

所有 POST 数据使用 UTF-8 编码的 JSON。请求体为 JSON 数组，格式如下：

json

[
 {
 "target": "example.com",
 "language_name": "English",
 "location_code": 2840,
 "limit": 10
 }
]

请求参数

顶层参数

字段名	类型	说明
`target`	string	填。目标域名、子域名或网页 URL。域名填写时不要带 `https://` 或 `www.`；子域名填写时不要带 `https://`；网页 URL须 `https://` 或 `www.`。注意：如果网页 URL 未带 `https://` 或 `www.`，系统会按整个域名处理，而不是按单页处理。
`location_name`	string	可选。地区名。使用该字段时无需再传 `location_code`。可通过 `/v3/dataforseo_labs/locations_and_languages` 获取支持的地区列表。忽略该字段表示返回所有可用地区的数据。示例：`United Kingdom`
`location_code`	integer	可选。地区编码。使用该字段时无需再传 `location_name`。可通过 `/v3/dataforseo_labs/locations_and_languages` 获取支持的地区列表。忽略该字段表示返回所有可用地区的数据。示例：`2840`
`language_name`	string	可选。语言名。使用该字段时无需再传 `language_code`。可通过 `/v3/dataforseo_labs/locations_and_languages` 获取支持的语言列表。忽略该字段表示返回所有可用语言的数据。示例：`English`
`language_code`	string	可选。语言代码。使用该字段时无需再传 `language_name`。可通过 `/v3/dataforseo_labs/locations_and_languages` 获取支持的语言列表。忽略该字段表示返回所有可用语言的数据。示例：`en`
`ignore_synonyms`	boolean	可选。是否忽略高度相似。设为 `true` 时返回核心，高相似词会被排除。默认值：`false`
`item_types`	array	可选。指定返回的搜索结果类型。注意：如果数组中除 `organic` 之外的类型，结果会数组中的第一个类型排序；且只能对响应中的结果类型进行筛选和排序。默认值为空。
`include_clickstream_data`	boolean	可选。是否返回基于点击流的指标。设为 `true` 时，响应中会 `clickstream_keyword_info`、`clickstream_etv`、`clickstream_gender_distribution`、`clickstream_age_distribution`、`keyword_info_normalized_with_clickstream`、`keyword_info_normalized_with_bing` 等字段。默认值：`false`。启用后费用翻倍。
`limit`	integer	可选。返回的最大数。默认值：`100`；最大值：`1000`
`offset`	integer	可选。结果偏移量。默认值：`0`。例如设为 `10` 时，将跳过前 10 个，从第 11 个开始返回。
`load_rank_absolute`	boolean	可选。是否返回按 `rank_absolute` 统计的排名分布。默认值：`false`。设为 `true` 后，响应中会返回 `metrics_absolute` 字段。
`historical_serp_mode`	string	可选。数据模式，可用于过滤状态。可选值：`live`、`lost`、`all`。`live` 表示当前仍有排名；`lost` 表示历史有排名但最近一次检查已无排名；`all` 表示两都返回。默认值：`live`
`filters`	array	可选。结果过滤条件数组，最多支持 8 个过滤条件。条件之间需使用逻辑运算符 `and` / `or`。支持操作符：`regex`、`not_regex`、`<`、`<=`、`>`、`>=`、`=`、`<>`、`in`、`not_in`、`match`、`not_match`、`ilike`、`not_ilike`、`like`、`not_like`。`like` / `not_like` / `ilike` / `not_ilike` 支持 `%` 通符。若要查询某个页面的排名，除了直接传 `target` 页面 URL，也可以基于 `ranked_serp_element.serp_item.relative_url` 过滤。
`order_by`	array	可选。结果排序规则。可使用与 `filters` 相同的字段路径。排序方式：`asc` 升序，`desc` 降序。单次请求最多设置 3 条排序规则。
`tag`	string	可选。用户自定义任务标识，最长 255 字符。可用于请求与响应，响应中会在 `data` 对象返回该值。

`item_types` 可用值

文档原文未完整展开默认值与候选值说明。结合响应字段，本接口返回明细数据的核心类型：

organic
paid
featured_snippet
local_pack
ai_overview_reference

过滤与排序示例

过滤示例：只看搜索量大于 10，且不是付费结果的

json

[
 {
 "target": "example.com",
 "location_code": 2840,
 "language_name": "English",
 "filters": [
 ["keyword_data.keyword_info.search_volume", ">", 10],
 "and",
 [
 ["ranked_serp_element.serp_item.type", "<>", "paid"],
 "or",
 ["ranked_serp_element.serp_item.is_paid", "=", false]
 ]
 ],
 "limit": 3
 }
]

排序示例

json

[
 {
 "target": "example.com",
 "order_by": [
 ["keyword_data.keyword_info.search_volume", "desc"],
 ["ranked_serp_element.serp_item.rank_absolute", "asc"]
 ]
 }
]

请求示例

cURL

bash

curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/google/ranked_keywords/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "target": "example.com",
 "location_code": 2840,
 "language_name": "English",
 "filters": [
 ["keyword_data.keyword_info.search_volume", ">", 10],
 "and",
 [
 ["ranked_serp_element.serp_item.type", "<>", "paid"],
 "or",
 ["ranked_serp_element.serp_item.is_paid", "=", false]
 ]
 ],
 "limit": 3
 }
]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/google/ranked_keywords/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "target": "example.com",
 "location_name": "United States",
 "language_name": "English",
 "filters": [
 ["keyword_data.keyword_info.search_volume", ">", 10],
 "and",
 [
 ["ranked_serp_element.serp_item.type", "<>", "paid"],
 "or",
 ["ranked_serp_element.serp_item.is_paid", "=", False]
 ]
 ],
 "limit": 3
 }
]

response = requests.post(url, headers=headers, json=data)
print(response.json)

TypeScript

typescript

import axios from "axios";

const postData = [
 {
 target: "example.com",
 language_name: "English",
 location_code: 2840,
 filters: [
 ["keyword_data.keyword_info.search_volume", ">", 10],
 "and",
 [
 ["ranked_serp_element.serp_item.type", "<>", "paid"],
 "or",
 ["ranked_serp_element.serp_item.is_paid", "=", false]
 ]
 ],
 limit: 3
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/google/ranked_keywords/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: postData
})
 .then((response) => {
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应结构

接口返回 JSON 数据，顶层 tasks 数组。

顶层响应字段

字段名	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	通用状态码，完整错误码见 `/v3/appendix/errors`
`status_message`	string	通用状态信息
`time`	string	执行耗时，单位秒
`cost`	float	本次所有任务总费用，单位 USD
`tasks_count`	integer	`tasks` 数组中的任务数
`tasks_error`	integer	返回错误的任务数
`tasks`	array	任务数组

`tasks[]` 字段

字段名	类型	说明
`id`	string	任务唯一标识，UUID 格式
`status_code`	integer	任务状态码
`status_message`	string	任务状态信息
`time`	string	任务执行耗时
`cost`	float	该任务费用，单位 USD
`result_count`	integer	`result` 数组数量
`path`	array	URL 路径
`data`	object	与请求中提交的参数一致
`result`	array	获取结果数组

`result[]` 字段说明

字段名	类型	说明
`se_type`	string	搜索引擎类型
`target`	string	请求中的目标域名或页面
`location_code`	integer	请求中的地区编码；无数据时为 `null`
`language_code`	string	请求中的语言代码；无数据时为 `null`
`total_count`	integer	数据库中与请求匹的总结果数
`items_count`	integer	本次 `items` 返回的结果数
`metrics`	object	按 `rank_group` 统计的排名数据
`metrics_absolute`	object	按 `rank_absolute` 统计的排名数据当 `load_rank_absolute=true` 时返回
`items`	array	排名及详细数据

`metrics` / `metrics_absolute` 结构

metrics 按 rank_group 统计，表示在相同类型 SERP素中比较位置。 metrics_absolute 按 rank_absolute 统计，表示在 SERP素中的绝对位置。

下可以下对象：

organic
paid
featured_snippet
local_pack
ai_overview_reference

这些对象字段结构基本一致，常见字段：

字段名	类型	说明
`pos_1`	integer	排名第 1 的数量
`pos_2_3`	integer	排名第 2–3 的数量
`pos_4_10`	integer	排名第 4–10 的数量
`pos_11_20`	integer	排名第 11–20 的数量
`pos_21_30`	integer	排名第 21–30 的数量
`pos_31_40`	integer	排名第 31–40 的数量
`pos_41_50`	integer	排名第 41–50 的数量
`pos_51_60`	integer	排名第 51–60 的数量
`pos_61_70`	integer	排名第 61–70 的数量
`pos_71_80`	integer	排名第 71–80 的数量
`pos_81_90`	integer	排名第 81–90 的数量
`pos_91_100`	integer	排名第 91–100 的数量
`etv`	float	预估流量
`count`	integer	该类型 SERP 中目标的总数
`estimated_paid_traffic_cost`	float	将对应自然/该类流量换算为付费流量的预估成本
`is_new`	integer	新增排名数量
`is_up`	integer	排名上升的数量
`is_down`	integer	排名下降的数量
`is_lost`	integer	丢失排名的数量
`clickstream_etv`	integer	基于点击流估算的流量；需开启 `include_clickstream_data=true`
`clickstream_gender_distribution`	object	点击流性别分布；需开启点击流数据
`clickstream_age_distribution`	object	点击流年龄分布；需开启点击流数据

性别分布字段

字段名	类型	说明
`female`	integer	女性用户数量
`male`	integer	男性用户数量

年龄分布字段

字段名	类型	说明
`18-24`	integer	18–24 岁用户数
`25-34`	integer	25–34 岁用户数
`35-44`	integer	35–44 岁用户数
`45-54`	integer	45–54 岁用户数
`55-64`	integer	55–64 岁用户数

`items[]` 字段说明

每个 items[]素表示一个已排名及对应 SERP素。

`items[].keyword_data`

字段名	类型	说明
`se_type`	string	搜索引擎类型
`keyword`	string	返回的
`location_code`	integer	地区编码
`language_code`	string	语言代码
`keyword_info`	object	基础数据
`keyword_info_normalized_with_bing`	object	使用 Bing 搜索量归一化后的数据
`keyword_info_normalized_with_clickstream`	object	使用点击流数据归一化后的数据
`clickstream_keyword_info`	object	点击流数据，需开启 `include_clickstream_data=true`
`keyword_properties`	object	附加属性
`serp_info`	object	该的 SERP 信息
`avg_backlinks_info`	object	排名前 10 自然结果的平均外链信息
`search_intent_info`	object	搜索意图信息

`keyword_info`

字段名	类型	说明
`last_updated_time`	string	数据更新时间，UTC
`competition`	float	竞争度，范围 0–1
`competition_level`	string	付费搜索竞争等级：`LOW`、`MEDIUM`、`HIGH`，未知时为 `null`
`cpc`	float	平均点击成本，单位 USD
`search_volume`	integer	平均月搜索量
`low_top_of_page_bid`	float	首屏顶部广告的较低出价参考值
`high_top_of_page_bid`	float	首屏顶部广告的较高出价参考值
`categories`	array	产品与服务分类；无数据时为 `null`
`monthly_searches`	array	过去 12 个月的月度搜索量
`search_volume_trend`	object	搜索量趋势变化

`monthly_searches[]`

字段名	类型	说明
`year`	integer	年份
`month`	integer	月份
`search_volume`	integer	当月搜索量

`search_volume_trend`

字段名	类型	说明
`monthly`	integer	相比上月的百分比变化
`quarterly`	integer	相比上季度的百分比变化
`yearly`	integer	相比上年的百分比变化

`keyword_info_normalized_with_bing` / `keyword_info_normalized_with_clickstream`

字段名	类型	说明
`last_updated_time`	string	数据集更新时间，UTC
`search_volume`	integer	当前搜索量
`is_normalized`	boolean	是否为归一化结果
`monthly_searches`	array	各月份搜索量数组

`clickstream_keyword_info`

字段名	类型	说明
`search_volume`	integer	基于点击流的月均搜索量
`last_updated_time`	string	点击流数据更新时间
`gender_distribution`	object	性别分布
`age_distribution`	object	年龄分布
`monthly_searches`	array	月度点击流搜索量

`keyword_properties`

字段名	类型	说明
`core_keyword`	string	组中的核心词；若无同义聚类则为 `null`
`synonym_clustering_algorithm`	string	同义词识别算法：`keyword_metrics` 或 `text_processing`；无数据时为 `null`
`keyword_difficulty`	integer	难度，0–100
`detected_language`	string	系统识别出的语言
`is_another_language`	boolean	识别语言是否与请求设置语言不同

`serp_info`

字段名	类型	说明
`check_url`	string	搜索引擎结果直达链接，可用于人工核验
`serp_item_types`	array	该 SERP 中出现的结果类型
`se_results_count`	integer	搜索结果总数
`last_updated_time`	string	最近一次 SERP 数据更新时间
`previous_updated_time`	string	上一次 SERP 数据更新时间

serp_item_types 可能：

answer_box、app、carousel、multi_carousel、featured_snippet、google_flights、google_reviews、third_party_reviews、google_posts、images、jobs、knowledge_graph、local_pack、hotels_pack、map、organic、paid、people_also_ask、related_searches、people_also_search、shopping、top_stories、twitter、video、events、mention_carousel、recipes、top_sights、scholarly_articles、popular_products、podcasts、questions_and_answers、find_results_on、stocks_box、visual_stories、commercial_units、local_services、google_hotels、math_solver、currency_box、product_considerations、found_on_web、short_videos、refine_products、explore_brands、perspectives、discussions_and_forums、compare_sites、courses、ai_overview

注意：本接口返回详细排名数据的类型主要是 organic、paid、featured_snippet、local_pack、ai_overview_reference。

`avg_backlinks_info`

字段名	类型	说明
`backlinks`	float	平均外链数
`dofollow`	float	平均 dofollow 外链数
`referring_pages`	float	平均引荐页面数
`referring_domains`	float	平均引荐域名数
`referring_main_domains`	float	平均主域名数
`rank`	float	平均页面 rank
`main_domain_rank`	float	平均主域名 rank
`last_updated_time`	string	外链数据更新时间

`search_intent_info`

字段名	类型	说明
`main_intent`	string	主搜索意图：`informational`、`navigational`、`commercial`、`transactional`
`foreign_intent`	array	补搜索意图
`last_updated_time`	string	搜索意图数据更新时间

`ranked_serp_element` 字段说明

表示该目标域名/页面在当前下命中的 SERP素。

字段名	类型	说明
`se_type`	string	搜索引擎类型
`serp_item`	object	命中的 SERP素
`check_url`	string	SERP 核验链接
`serp_item_types`	array	当前 SERP 中的结果类型
`se_results_count`	string/integer	搜索结果总数
`keyword_difficulty`	integer	难度
`is_lost`	boolean	当前结果是否已从 SERP 消失
`last_updated_time`	string	最近更新时间
`previous_updated_time`	string	上一次更新时间

`serp_item` 支持的类型

1) `organic`

字段名	类型	说明
`type`	string	固定为 `organic`
`rank_group`	integer	同类型结果中的位置
`rank_absolute`	integer	所有 SERP素中的绝对位置
`position`	string	页面区域，可能为 `left` 或 `right`
`xpath`	string	素 XPath
`domain`	string	SERP 中的子域名
`title`	string	标题
`url`	string	URL
`breadcrumb`	string	面屑
`website_name`	string	网站名称
`is_image`	boolean	是否含图片
`is_video`	boolean	是否含视频
`is_featured_snippet`	boolean	是否为精选摘要
`is_malicious`	boolean	是否被标记为恶意
`description`	string	描述
`pre_snippet`	string	描述前附加信息
`extended_snippet`	string	描述后附加信息
`amp_version`	boolean	是否有 AMP 版本
`rating`	object	评分信息
`highlighted`	array	描述中高亮词
`links`	array	sitelinks，无则为 `null`
`about_this_result`	object	“此结果”面板信息
`main_domain`	string	主域名
`relative_url`	string	不含协议和域名的相对路径
`etv`	float	预估自然流量
`estimated_paid_traffic_cost`	float	将该自然流量换算为付费流量的预估成本
`clickstream_etv`	integer	点击流预估流量
`rank_changes`	object	排名变化信息
`backlinks_info`	object	该 URL 的外链信息
`rank_info`	object	页面及主域 rank 信息

2) `paid`

与 organic 类似，差异字段：

字段名	类型	说明
`type`	string	固定为 `paid`
`extra.ad_aclk`	string	广告标识
`description_rows`	array	扩展描述
`links`	array	广告附加链接

3) `local_pack`

额外常见字段：

字段名	类型	说明
`type`	string	固定为 `local_pack`
`phone`	string	电话号码
`is_paid`	boolean	是否为广告
`rating`	object	评分数据

4) `featured_snippet`

额外常见字段：

字段名	类型	说明
`type`	string	固定为 `featured_snippet`
`featured_title`	string	摘要来源页标题
`table`	object	表格结果，无则为 `null`
`table.table_header`	array	表头
`table.table_content`	array	表格

5) `ai_overview_reference`

额外常见字段：

字段名	类型	说明
`type`	string	固定为 `ai_overview_reference`
`source`	string	引用来源名称或标题
`domain`	string	引用来源域名
`title`	string	引用页面标题
`url`	string	引用页面 URL
`text`	string	被 AI Overview 引用的文本片段

通用嵌套对象说明

`rank_changes`

字段名	类型	说明
`previous_rank_absolute`	integer	上次绝对排名；若为新结果则可能为 `null`
`is_new`	boolean	是否为新出现结果
`is_up`	boolean	排名是否上升
`is_down`	boolean	排名是否下降

`backlinks_info`

字段名	类型	说明
`referring_domains`	integer	引荐域名数
`referring_main_domains`	integer	引荐主域名数
`referring_pages`	integer	引荐页面数
`dofollow`	integer	dofollow 外链数
`backlinks`	integer	总外链数
`time_update`	string	外链数据更新时间

`rank_info`

字段名	类型	说明
`page_rank`	integer	页面 rank
`main_domain_rank`	integer	主域名 rank

`rating`

字段名	类型	说明
`rating_type`	string	评分类型：`Max5`、`Percents`、`CustomMax`
`value`	integer	评分值
`votes_count`	integer	评价数量
`rating_max`	integer	评分上限

`about_this_result`

字段名	类型	说明
`type`	string	固定为 `about_this_result_element`
`url`	string	结果 URL
`source`	string	信息来源
`source_info`	string	来源补说明
`source_url`	string	来源链接
`language`	string	结果语言
`location`	string	结果适用地区
`search_terms`	array	命中的搜索词
`related_terms`	array	词

响应示例

json

{
 "version": "0.1.20250526",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "1.3363 sec.",
 "cost": 0.011,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "ranked_keywords",
 "se_type": "google",
 "target": "example.com",
 "language_name": "English",
 "location_name": "United States",
 "load_rank_absolute": true,
 "limit": 10,
 "item_types": []
 },
 "result": [
 {
 "items": [
 {
 "se_type": "google",
 "keyword_data": {
 "se_type": "google",
 "keyword": "api seo tools",
 "location_code": 2840,
 "language_code": "en",
 "keyword_info": {
 "se_type": "google",
 "last_updated_time": "2025-06-15 07:14:53 +00:00",
 "competition_level": "LOW",
 "search_volume": 50,
 "monthly_searches": [],
 "search_volume_trend": {
 "monthly": -21,
 "quarterly": 0,
 "yearly": 267
 }
 },
 "keyword_properties": {
 "se_type": "google",
 "core_keyword": "seo tool api",
 "synonym_clustering_algorithm": "text_processing",
 "keyword_difficulty": 25,
 "detected_language": "id",
 "is_another_language": true
 },
 "serp_info": {
 "se_type": "google",
 "check_url": "https://www.google.com/search?q=api%20seo%20tools&num=100&hl=en&gl=US",
 "serp_item_types": [],
 "se_results_count": 167000000,
 "last_updated_time": "2025-06-06 22:54:21 +00:00",
 "previous_updated_time": "2025-04-25 04:58:05 +00:00"
 }
 },
 "ranked_serp_element": {
 "se_type": "google",
 "serp_item": {
 "se_type": "google",
 "type": "organic",
 "rank_group": 1,
 "rank_absolute": 1,
 "position": "left",
 "domain": "example.com",
 "title": "Powerful API Stack For Data-Driven SEO Tools",
 "url": "https://example.com/",
 "main_domain": "example.com",
 "relative_url": "/",
 "etv": 15.199999809265137,
 "rank_changes": {
 "previous_rank_absolute": 2,
 "is_new": false,
 "is_up": true,
 "is_down": false
 },
 "rank_info": {
 "page_rank": 384,
 "main_domain_rank": 392
 }
 },
 "check_url": "https://www.google.com/search?q=api%20seo%20tools&num=100&hl=en&gl=US",
 "serp_item_types": [],
 "se_results_count": 167000000,
 "keyword_difficulty": 25,
 "is_lost": false,
 "last_updated_time": "2025-06-06 22:54:21 +00:00",
 "previous_updated_time": "2025-04-25 04:58:05 +00:00"
 }
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

顶层 status_code 表示整次请求状态
tasks[].status_code 表示单个任务状态
建议同时检查：
HTTP 状态码
顶层 status_code
tasks_error
每个任务的 status_code

常见成功状态：

状态码	含义
`20000`	请求成功

完整错误码与状态说明请参考 /v3/appendix/errors。生产环境中建议为网络异常、时、参数错误、限流和空结果分别设计处理逻辑。

使用要点

查域名时不要带协议

正确：example.com
错误：https://example.com

查单页时带协议或 www.

正确：https://example.com/page
否则可能按整个域名返回结果

需要绝对排名分布时启用 load_rank_absolute=true

适用于分析目标在 SERP素中的真实位置

需要人群与点击流维度时启用 include_clickstream_data=true

会返回更多字段，但费用翻倍

可以合 filters 与 order_by 做精细化筛选

例如只看高搜索量、非广告、特定页面路径、或 AI Overview 引用结果

实用场景

盘点域名自然流量词库：批量拉取某站点当前有排名的，快速评估 SEO 覆盖面与可见度。
定位单页获词能力：针对页面 URL 查询排名词，判断页面主题是否晰、是否吃到目标流量。
监控排名流失词：将 historical_serp_mode 设为 lost，找出最近掉出 SERP 的，及时排查、索引或竞争变化。
筛选高价值优化机会：结合 search_volume、keyword_difficulty、rank_absolute 过滤出“有量、难度适中、接近首页”的，优优化资源。
追踪 AI Overview 引用机会：通过 item_types 或结果类型识别 ai_overview_reference，分析站点是否被 AI 概览引用，新型搜索策略。

Google 已排名（实时） ​

接口说明 ​

计费与限流 ​

请求体格式 ​

请求参数 ​

顶层参数 ​

item_types 可用值 ​

过滤与排序示例 ​

过滤示例：只看搜索量大于 10，且不是付费结果的 ​

排序示例 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应结构 ​

顶层响应字段 ​

tasks[] 字段 ​

result[] 字段说明 ​

metrics / metrics_absolute 结构 ​

性别分布字段 ​

年龄分布字段 ​

items[] 字段说明 ​

items[].keyword_data ​

keyword_info ​

monthly_searches[] ​

search_volume_trend ​

keyword_info_normalized_with_bing / keyword_info_normalized_with_clickstream ​

clickstream_keyword_info ​

keyword_properties ​

serp_info ​

avg_backlinks_info ​

search_intent_info ​

Google 已排名（实时）

接口说明

计费与限流

请求体格式

请求参数

顶层参数

`item_types` 可用值

过滤与排序示例

过滤示例：只看搜索量大于 10，且不是付费结果的

排序示例

请求示例

cURL

Python

TypeScript

响应结构

顶层响应字段

`tasks[]` 字段

`result[]` 字段说明

`metrics` / `metrics_absolute` 结构

性别分布字段

年龄分布字段

`items[]` 字段说明

`items[].keyword_data`

`keyword_info`

`monthly_searches[]`

`search_volume_trend`

`keyword_info_normalized_with_bing` / `keyword_info_normalized_with_clickstream`

`clickstream_keyword_info`

`keyword_properties`

`serp_info`

`avg_backlinks_info`

`search_intent_info`