Google Trends Explore API

Google Trends에서 검색어를 5개까지 비교합니다. 시간별·지역별 관심도와 관련 주제·검색어가 나옵니다.

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회를 넘으면 단가가 내려갑니다.

참고

값은 요청 안에서 가장 많이 검색된 시점을 100으로 둔 상대 관심도(0–100)입니다. 0도 Trends가 밝힌 값입니다.
기간을 직접 정하려면 timeRange 대신 from과 to를 넘깁니다.

Explore

요청

파라미터

응답

에러

가격

참고

이 페이지 내용