--- title: "Explore" description: "在 Google Trends 上比较最多五个搜索词：随时间和按地区的热度，以及相关主题和查询。" --- > Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt) ```http GET | POST /v1/google-trends/explore ``` 参数可以用 `GET` 的查询字符串发送，也可以用 `POST` 的 JSON 请求体发送，两者等价。 ## 请求 ```bash tab="cURL" curl "https://gateway.apinoa.com/v1/google-trends/explore?terms=chatgpt,gemini&country=US&timeRange=month" \ -H "x-api-key: $APINOA_API_KEY" ``` ```js tab="JavaScript" const params = new URLSearchParams({ terms: "chatgpt,gemini", country: "US", timeRange: "month" }); const res = await fetch(`https://gateway.apinoa.com/v1/google-trends/explore?${params}`, { headers: { "x-api-key": process.env.APINOA_API_KEY }, }); const { success, data, error } = await res.json(); ``` ```python tab="Python" import os import requests res = requests.get( "https://gateway.apinoa.com/v1/google-trends/explore", params={"terms": "chatgpt,gemini", "country": "US", "timeRange": "month"}, headers={"x-api-key": os.environ["APINOA_API_KEY"]}, ) body = res.json() ``` ## 参数 | Parameter | Type | Required | Notes | |---|---|---|---| | `terms` | string | yes | Up to five search terms to compare, separated by commas. | | `category` | integer ≥ 0 | | A Trends category id, to measure the terms within it (0 = all categories). | | `country` | enum | | The country, as an ISO 3166 code. Absent: worldwide. `AD` `AE` `AF` `AG` `AI` `AL` `AM` `AO` `AQ` `AR` `AS` `AT` `AU` `AW` `AX` `AZ` `BA` `BB` `BD` `BE` `BF` `BG` `BH` `BI` `BJ` `BL` `BM` `BN` `BO` `BQ` `BR` `BS` `BT` `BV` `BW` `BY` `BZ` `CA` `CC` `CD` `CF` `CG` `CH` `CI` `CK` `CL` `CM` `CN` `CO` `CR` `CU` `CV` `CW` `CX` `CY` `CZ` `DE` `DJ` `DK` `DM` `DO` `DZ` `EC` `EE` `EG` `EH` `ER` `ES` `ET` `FI` `FJ` `FK` `FM` `FO` `FR` `GA` `GB` `GD` `GE` `GF` `GG` `GH` `GI` `GL` `GM` `GN` `GP` `GQ` `GR` `GS` `GT` `GU` `GW` `GY` `HK` `HM` `HN` `HR` `HT` `HU` `ID` `IE` `IL` `IM` `IN` `IO` `IQ` `IR` `IS` `IT` `JE` `JM` `JO` `JP` `KE` `KG` `KH` `KI` `KM` `KN` `KP` `KR` `KW` `KY` `KZ` `LA` `LB` `LC` `LI` `LK` `LR` `LS` `LT` `LU` `LV` `LY` `MA` `MC` `MD` `ME` `MF` `MG` `MH` `MK` `ML` `MM` `MN` `MO` `MP` `MQ` `MR` `MS` `MT` `MU` `MV` `MW` `MX` `MY` `MZ` `NA` `NC` `NE` `NF` `NG` `NI` `NL` `NO` `NP` `NR` `NU` `NZ` `OM` `PA` `PE` `PF` `PG` `PH` `PK` `PL` `PM` `PN` `PR` `PS` `PT` `PW` `PY` `QA` `RE` `RO` `RS` `RU` `RW` `SA` `SB` `SC` `SD` `SE` `SG` `SH` `SI` `SJ` `SK` `SL` `SM` `SN` `SO` `SR` `SS` `ST` `SV` `SX` `SY` `SZ` `TC` `TD` `TF` `TG` `TH` `TJ` `TK` `TL` `TM` `TN` `TO` `TR` `TT` `TV` `TW` `TZ` `UA` `UG` `UM` `US` `UY` `UZ` `VA` `VC` `VE` `VG` `VI` `VN` `VU` `WF` `WS` `XK` `YE` `YT` `ZA` `ZM` `ZW` | | `from` | string | | A custom period's first day (`YYYY-MM-DD`), or hour within the past week (`YYYY-MM-DDTHH`), with `to`. | | `lang` | string | | Interface language: the language of topic names and labels (`en`, `pt-BR`). | | `lowVolume` | enum \| boolean | | Include regions with low search volume in interest by region. | | `property` | enum | | Which Google search: web (default), images, news, shopping or youtube. `web` `images` `news` `shopping` `youtube` | | `resolution` | enum | | Interest by region by country, region, metro (US only) or city. Default: the next level below the place asked. `country` `region` `metro` `city` | | `subregion` | string | | A state, province or US metro inside `country` (`US-CA`, `US-CA-807`), instead of the whole country. | | `timeRange` | enum | | The period: the past hour, 4 hours, day, week (7 days), month, quarter (3 months), year (12 months, the default), 5 years, or `all` (since 2004). `hour` `4hours` `day` `week` `month` `quarter` `year` `5years` `all` | | `to` | string | | A custom period's last day (`YYYY-MM-DD`) or hour (`YYYY-MM-DDTHH`), with `from`. | The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json ## 响应 在 `data` 中返回 [`TrendsExplore`](/docs/api-reference/serp/response-schema#trendsexplore)。 真实响应的节选：数组只保留前几项，长文本已截断。 ```json { "success": true, "data": { "engine": "google-trends", "terms": ["chatgpt", "gemini"], "country": "US", "timeRange": "month", "interestOverTime": { "points": [{"date": "2026-09-30", "values": [90]}, {"date": "2026-10-01", "values": [87]}], "averages": [82, 36] }, "interestByRegion": { "resolution": "region", "measure": "share", "regions": [ {"code": "US-CA", "name": "California", "values": [69]}, {"code": "US-NJ", "name": "New Jersey", "values": [71]} ] }, "related": [ { "term": "chatgpt", "queries": { "top": [ { "title": "what is chatgpt", "url": "https://trends.google.com/trends/explore?q=what+is+chatgpt&date=today+1-m&geo=US", "value": 100 } ], "rising": [ { "title": "david rosenthal chatgpt complaint", "url": "https://trends.google.com/trends/explore?q=david+rosenthal+chatgpt+complaint&date=today+1-m&geo=US", "growth": "+1,150%", "growthValue": 1150 } ] } }, { "term": "gemini", "queries": { "top": [ { "title": "gemini google", "url": "https://trends.google.com/trends/explore?q=gemini+google&date=today+1-m&geo=US", "value": 100 } ], "rising": [ { "title": "gemini 4 argon", "url": "https://trends.google.com/trends/explore?q=gemini+4+argon&date=today+1-m&geo=US", "growth": "Breakout", "growthValue": 23100 } ] } } ], "fetchedAt": "2026-10-30T01:04:54.914Z", "ext": { "keywords": [ {"term": "chatgpt", "name": "chatgpt", "type": "Search term"}, {"term": "gemini", "name": "gemini", "type": "Search term"} ], "period": {"from": "2026-09-30", "to": "2026-10-30"}, "periodLabel": "Past 30 days", "interval": "day", "risingComparedWith": {"from": "2026-08-30", "to": "2026-09-29"} } } } ``` ## 错误 | 状态 | 代码 | 含义 | |---|---|---| | 400 | `INVALID_PARAMS` | 参数缺失、未知、超出范围，或该引擎不接受。消息中会指出是哪一个。 | | 401 | `UNAUTHORIZED` | 缺少 `x-api-key` 请求头，或密钥已吊销或未知。 | | 402 | `INSUFFICIENT_BALANCE` | 余额不足以支付本次调用。请在控制台充值。 | | 429 | `MARKETPLACE_SATURATED` | 并发调用过多。请等待 `Retry-After` 秒后重试。 | | 502 | `UPSTREAM_ERROR` | 引擎返回了无法使用的内容。请退避后重试。 | | 503 | `SERVICE_UNAVAILABLE` | 临时故障。请退避后重试。 | 全部错误代码见 [Errors](/docs/errors)。失败的调用不计费。 ## 价格 **Price** $0.0012 per call. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day. ## 说明 - 数值是相对热度（0–100），以本次请求中最热的时间点为基准。`0` 也是 Trends 给出的值。 - 如需自定义时段，用 `from` 和 `to` 代替 `timeRange`。