Google Trends API
Google Trends는 검색어에 대한 검색 관심도가 시간에 따라 어떻게 변하는지 보여줍니다. interest_over_time은 키워드를 최대 5개까지 비교하며, 시점마다 키워드별 0~100 관심도 값이 담긴 행을 하나씩 반환합니다.
값은 상대적입니다. 100은 쿼리에 포함된 모든 키워드 중 가장 높은 지점이므로, 키워드를 추가하거나 제거하면 결과가 바뀝니다. 검색량이 적은 검색어는 0으로 표시됩니다. 데이터 포인트는 1년이면 주 단위, 30일이나 90일이면 일 단위, 하루나 일주일이면 시간 또는 분 단위이며, time에 정확한 시작 시점이 담깁니다. 마지막 포인트는 아직 집계 중인 경우가 많습니다(partial).
플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Google Trends 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
시간 흐름에 따른 검색 관심도interest_over_time | keywords 1~5개에 대한 Google 검색 관심도를 시간 흐름에 따라 비교합니다. | 요청 1,000개당 $8.81 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Google Trends 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
interest_over_time시간 흐름에 따른 검색 관심도
| keywords | country, language, search_type, time_window | Sync 응답 | — | 요청 1,000개당 $8.81 | time · date_from · date_to · values · period_averages · partial · platform |
Google Trends interest_over_time 파라미터는 각각 무엇을 의미하나요?
keywords 1~5개에 대한 Google 검색 관심도를 시간 흐름에 따라 비교합니다. 각 행은 하나의 시점이며, 키워드별로 쿼리 내 최고점을 기준으로 한 0~100 값을 가집니다. country, 1일부터 5년까지의 time_window, 뉴스나 YouTube 같은 search_type을 선택하세요. 값은 검색 횟수가 아닌 상대적 관심도입니다.
keywords필수- 비교할 검색어 1~5개의 목록입니다(예:
["openai", "anthropic"]). 각 검색어는 최대 80자, 10단어입니다.Google 트렌드 도움말: Google 트렌드 데이터 FAQ — Google 트렌드 도움말에 따르면 데이터는 실제 검색의 표본에서 나오며, 각 데이터 포인트는 해당 지역과 기간의 전체 검색량으로 나눈 뒤 0~100으로 환산되고, 검색량이 적은 검색어는 0으로 표시됩니다. 이 자료는 `values`의 의미를 뒷받침합니다. 이 API의 `country`, `time_window`, `search_type` 필터는 EveryInfra가 정의한 것이며, 이 자료는 결과를 보증하지 않습니다. · 확인일 country선택- 관심도를 측정할 지역의 두 글자 국가 코드입니다(예:
us,gb,jp). 생략하면 전 세계를 기준으로 합니다. language선택- 두 글자 언어 코드입니다(예:
en,ja). 보통은 필요하지 않습니다. search_type선택- 측정할 Google 검색 유형으로,
web(기본값),news,youtube,images,shopping중 하나입니다. time_window선택- 조회 기간으로,
day,week,month(30일),quarter(90일),year(12개월, 기본값),five_years중 하나입니다.
Google Trends API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_trends","action":"interest_over_time","params":{"keywords":"<keywords>"}}'
Google Trends API 자주 묻는 질문
Google Trends API로 무엇을 가져올 수 있나요?
platform을 google_trends 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 시간 흐름에 따른 검색 관심도입니다. 각 액션 이름은 서로 다른 Google Trends 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Google Trends interest_over_time 요청에는 어떤 입력이 필요한가요?
비교할 검색어 1~5개의 목록입니다(예: ["openai", "anthropic"]). 각 검색어는 최대 80자, 10단어입니다. params 안의 keywords 필드로 전달하세요.
Google Trends interest_over_time 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 time, date_from, date_to 및 values입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Google Trends 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.