Google Trends Explore API

在 Google Trends 上比较最多五个搜索词：随时间和按地区的热度，以及相关主题和查询。

GET | POST /v1/google-trends/explore

参数可以用 GET 的查询字符串发送，也可以用 POST 的 JSON 请求体发送，两者等价。

请求

curl "https://gateway.apinoa.com/v1/google-trends/explore?terms=chatgpt,gemini&country=US&timeRange=month" \
  -H "x-api-key: $APINOA_API_KEY"

参数

参数	类型	必填	说明
`terms`	string	是	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`.

这些参数及所有响应类型也写在OpenAPI 文档中。

响应

在 data 中返回 TrendsExplore。真实响应的节选：数组只保留前几项，长文本已截断。

{
  "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。失败的调用不计费。

价格

价格每次调用 $0.0012。标价；单日调用超过 1,000 次后单价下调。

说明

数值是相对热度（0–100），以本次请求中最热的时间点为基准。0 也是 Trends 给出的值。
如需自定义时段，用 from 和 to 代替 timeRange。

Explore

请求

参数

响应

错误

价格

说明

本页内容