관심도 시계열
5 크레딧/v1/google_trends/explore키워드 1-5개를 CSV로 비교합니다. 키워드별 날짜 단위 0-100 점수 시계열과 평균을 반환합니다. location, timeframe, category로 범위를 지정합니다. 값은 요청 집합 안에서 상대적입니다.
keywords (1-5 CSV), location, timeframe, category
Google Trends 엔드포인트
공개 Trends 신호 읽기 엔드포인트는 2개입니다. 최대 5개 키워드의 관심도 시계열과 단일 키워드의 급상승·상위 관련 검색어를 제공합니다. 데이터 API만 지원하며 Trends UI 세션과 비공식 스크래퍼 스택은 없습니다.
급상승 관련 검색어
5 크레딧/v1/google_trends/rising키워드 1개에 대해 급상승(breakout)과 상위 관련 검색어를 반환합니다. 급상승 행에는 growth 비율이 있고 상위 행에는 0-100 상대 값이 있습니다. explore와 함께 쓰면 규모와 동인을 같이 볼 수 있습니다.
keyword, location, timeframe
Google Trends API2개 엔드포인트 지원
문서 보기Google 트렌드의 시간별 관심도를 돌려줍니다. 키워드를 다섯 개까지 받아 0에서 100까지 점수가 매겨진 날짜별 값과 기간 평균을 각각 담습니다.
검색어 규모를 재거나 여러 단어를 같은 기간, 지역, 카테고리에서 맞붙일 때 사용하세요.
GET/v1/google_trends/explore?keywords=uv+index&timeframe=past_90_days
keywords · 1-5 comma-separated keywords (e.g. 'reverse audio,voice changer'). With multiple keywords the 0-100 values are normalised across the set for direct comparison.
$ curl https://www.socialcrawl.dev/v1/google_trends/explore?keywords=uv+index&timeframe=past_90_days \
-H "x-api-key: sc_YOUR_API_KEY"— · 대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Google Trends API 동작
Google Trends도 다른 SocialCrawl 엔드포인트와 같습니다. API 키로 GET /v1/google_trends/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 별도 Trends 벤더 키와 OAuth는 없습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 소셜 읽기, Universal Search, Tavily를 포함한 카탈로그 전 구간에 같은 키를 사용합니다.
GET과 쿼리 파라미터
두 라우트 모두 GET입니다. explore에는 keywords(1-5 CSV), rising에는 단일 keyword를 전달합니다. location, timeframe, category(explore)는 과금 전에 검증합니다.
크레딧 과금
라이브 미스는 호출당 5 크레딧(고급 티어)입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다. 잘못된 파라미터는 400이며 과금하지 않습니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. explore와 rising은 data 아래 Analytics 페이로드로 내려갑니다.
연동 순서
대부분 제품은 먼저 키워드 집합을 비교한 뒤 승자 키워드의 급상승을 보고, 지역·기간을 좁혀 explore를 다시 호출합니다.
01키워드 비교
GET /v1/google_trends/explore?keywords=…키워드 1-5개의 series[]와 averages[]입니다.
상대 0-100 점수로 창 안에서 어떤 용어가 앞서는지를 확인합니다.
02급상승 확인
GET /v1/google_trends/rising?keyword=…단일 키워드의 rising[] growth와 top[] 관련 검색어입니다.
관심도 곡선 옆에서 동인과 인접 표현을 찾습니다.
03지역 범위
GET /v1/google_trends/explore?keywords=…&location=…location(및 선택 timeframe)으로 필터한 동일한 explore 형태입니다.
전 세계 창에서 가려진 국가·지역 수요를 분리합니다.
요청
GET /v1/google_trends/explore
?keywords=chatgpt,claude
&timeframe=past_12_months
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/google_trends/rising?keyword=electric+vehicles응답 봉투
{
"success": true,
"data": {
"series": [],
"averages": []
},
"credits_used": 5,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
두 엔드포인트 모두 Analytics 원형을 사용합니다. 필드 이름이 안정적이라 대시보드와 에이전트가 Trends 전용 스키마를 다시 배우지 않습니다.
Analytics (explore)explore
키워드별 series[]와 날짜 점수 { date, value }; 창 평균 averages[]
Analytics (rising)rising
growth 비율이 있는 rising[] 급상승 검색어; 0-100 상대 값의 top[] 관련 검색어
게이트웨이
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Google Trends 전용 사이드카가 아닙니다.
- 01
엣지 수신
Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 분당 600회 한도와 키당 동시 50건을 적용합니다.
- 02
검증 후 차감
레지스트리에서 google_trends/explore 또는 rising을 찾습니다. 키워드 개수와 형식 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 5 크레딧을 원자적으로 차감합니다.
- 03
캐시 또는 조회
platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다. 미스면 DataForSEO Google Trends explore를 라이브 호출합니다. 과금 갱신은 보통 수 초입니다. 동일 요청은 짧은 검색 캐시에 걸릴 수 있습니다.
- 04
정규화 후 반환
업스트림 Trends 페이로드를 Analytics 형태(series·averages 또는 rising·top)로 매핑하고 성공 봉투로 감싸 빌링 감사에 남깁니다.
과금 규칙
- explore 라이브 미스는 5 크레딧입니다.
- rising 라이브 미스는 5 크레딧입니다.
- 캐시 히트는 0 크레딧입니다.
- 빈 응답과 하드 실패는 자동 환불됩니다.
- 잘못된 파라미터는 400이며 과금하지 않습니다.
- 잔액이 없으면 402이며 과금하지 않습니다.
- explore의 keywords는 1-5개 CSV여야 합니다.
- rising은 단일 keyword만 받습니다.
- 고객 앱에 별도 Trends 벤더 청구가 없습니다.
데이터 수집
Google Trends는 공개 검색 관심도 분석입니다. SocialCrawl Analytics로 정규화하므로 코드에 별도 DataForSEO 클라이언트를 둘 필요가 없습니다.
API에서의 Trends
상대 검색 관심도와 관련 검색어 급상승을 제공합니다. 리서치, 수요 규모 측정, 콘텐츠 기획에 사용합니다. 절대 검색량과 Google Ads 경매 데이터는 아닙니다.
업스트림
DataForSEO Google Trends Explore를 라이브 모드로 호출합니다. 서버 측 동기 호출이며 이 두 라우트에 DFS 자격 증명을 두지 않습니다.
응답 형태
success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. explore는 series와 averages, rising은 rising과 top 버킷을 반환합니다.
미제공 항목
Trends UI 자동화는 없습니다. rising의 다중 키워드 관련 검색어는 없습니다(업스트림이 단일 키워드). 쓰기와 알림 엔드포인트는 없습니다.
필드 매핑
interest-over-time points→ Analytics.series선택한 timeframe의 0-100 상대 인기도 시계열
keyword averages→ Analytics.averages창 전체 키워드별 평균 관심도
rising / top related→ related query buckets급상승 growth 비율과 상위 관련 0-100 값
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
2active Google Trends endpoints in the registry
5 crTrends 라이브 호출당 크레딧
키워드 비교와 급상승 발견
호출은 짧은 키워드 집합의 explore 후 승자 키워드의 rising에 집중됩니다. 전 세계 창이 거칠 때는 location을 좁혀 다시 호출합니다. 같은 SocialCrawl 키와 봉투로 Trends 원시 연산 2개를 제공합니다. 별도 벤더 연동 없이 explore 비교와 rising 급상승을 씁니다.
과금되는 DataForSEO 갱신은 보통 수 초이며 종종 3-8초입니다. 동일 요청은 짧은 검색 캐시에서 0 크레딧으로 제공될 수 있습니다.
Google Trends API 활용 사례
Google Trends 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
SEO·콘텐츠 기획
Python, 노트북, CMS 잡explore로 후보 주제를 비교한 뒤 rising으로 인접 검색어를 확인하고 브리프를 확정합니다.
시장 조사 팀
Node, BI 적재, cronlocation과 timeframe으로 상대 관심도를 추적하고 시계열을 소셜 볼륨 대시보드에 붙입니다.
에이전트·제품 잡
Go, 워커, Explorer워크플로에서 explore 다음 rising을 호출합니다. Universal Search와 소셜 읽기와 같은 API 키를 사용합니다.
호출 예시
Trends 라이브 호출은 5 크레딧입니다. 캐시 히트는 무료입니다. explore는 키워드 1-5개, rising은 키워드 1개입니다.
curl "https://www.socialcrawl.dev/v1/google_trends/explore?keywords=chatgpt,claude&timeframe=past_12_months" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/google_trends/rising?keyword=electric+vehicles" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Google Trends API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 Google Trends 직접 스크래핑, 뭐가 다른가요?
같은 Google Trends 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | Google Trends 직접 스크래핑 |
|---|---|---|
| 접근 방식 | GET 요청 하나로 구조화된 JSON이 돌아와요 | 공식 API가 없어서 사이트를 긁거나 CSV를 손으로 받아야 해요 |
| 키워드 비교 | 최대 5개 키워드를 세트 기준 정규화 점수로 비교해요 | 비교 화면을 하나씩 내보내며 수작업으로 모아야 해요 |
| 급상승 검색어 | 성장률 퍼센트가 붙은 브레이크아웃 목록이 응답에 담겨요 | 레이아웃이 바뀔 때마다 깨지는 DOM 스크래핑에 기대야 해요 |
| 신선도 | 캐시 미스 시 현재 공개 데이터 소싱, 보통 3-8초예요 | 스크래퍼가 마지막으로 살아남은 시점까지만요 |
| 요금 | 어드밴스드 티어 크레딧, 48개 플랫폼이 잔액 하나를 같이 써요 | 프록시·유지보수 비용에 차단된 요청 재시도까지 얹혀요 |
접근 방식
SocialCrawl
GET 요청 하나로 구조화된 JSON이 돌아와요
Google Trends 직접 스크래핑
공식 API가 없어서 사이트를 긁거나 CSV를 손으로 받아야 해요
키워드 비교
SocialCrawl
최대 5개 키워드를 세트 기준 정규화 점수로 비교해요
Google Trends 직접 스크래핑
비교 화면을 하나씩 내보내며 수작업으로 모아야 해요
급상승 검색어
SocialCrawl
성장률 퍼센트가 붙은 브레이크아웃 목록이 응답에 담겨요
Google Trends 직접 스크래핑
레이아웃이 바뀔 때마다 깨지는 DOM 스크래핑에 기대야 해요
신선도
SocialCrawl
캐시 미스 시 현재 공개 데이터 소싱, 보통 3-8초예요
Google Trends 직접 스크래핑
스크래퍼가 마지막으로 살아남은 시점까지만요
요금
SocialCrawl
어드밴스드 티어 크레딧, 48개 플랫폼이 잔액 하나를 같이 써요
Google Trends 직접 스크래핑
프록시·유지보수 비용에 차단된 요청 재시도까지 얹혀요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기SocialCrawl Google Trends API는 무엇인가요?
현재 공개된 Google Trends 데이터를 다루는 엔드포인트 두 개예요. /v1/google_trends/explore는 키워드 최대 5개의 관심도 추이를 0-100 상대 점수로 돌려주고(세트 전체 기준으로 정규화돼요), /v1/google_trends/rising은 키워드 하나의 연관 검색어와 급상승(브레이크아웃) 검색어를 성장률과 함께 돌려줘요.
Google Trends 공식 API가 있나요?
Google은 일반 공개된 공식 Trends API를 제공하지 않아서, 대부분 사이트를 직접 스크랩하거나 CSV를 손으로 내려받아 왔어요. SocialCrawl은 같은 관심도 추이·연관 검색어 데이터를 GET 요청 하나로 구조화된 JSON으로 돌려드려요. 다른 데이터 플랫폼과 같은 키로요.
키워드 여러 개를 맞대어 비교할 수 있나요?
네. /v1/google_trends/explore에 쉼표로 구분한 키워드를 최대 5개까지 넘기면, 0-100 점수가 세트 전체 기준으로 정규화되어 돌아와요. Google Trends 비교 화면과 똑같이, 어떤 키워드의 50은 세트 최고점 100의 절반 관심도를 뜻해요.
급상승·브레이크아웃 검색어는 무엇인가요?
/v1/google_trends/rising의 rising 목록은 설정한 기간 동안 관심이 가장 크게 자란 연관 검색어들이에요. 각 항목에 성장률 퍼센트가 붙는데, 진짜 브레이크아웃은 수천 단위까지 나와요(3200이면 +3200%). 함께 오는 top 목록은 가장 많이 검색된 연관 검색어를 0-100 점수로 담아요.
지역과 기간으로 좁힐 수 있나요?
네. 두 엔드포인트 모두 location('United States' 같은 이름 또는 숫자 코드)과 past_hour부터 past_5_years까지의 timeframe 프리셋을 받아요. explore는 Google Trends 카테고리 코드도 받아서 특정 업종만 떼어볼 수 있어요.
Google Trends 호출 요금은 얼마인가요?
두 엔드포인트 모두 어드밴스드 티어이고 캐시 미스 시 현재 공개 데이터를 가져와 보통 3-8초 안에 돌아와요. 새 계정은 신용카드 없이 100 크레딧을 무료로 받고, 같은 크레딧 잔액으로 SocialCrawl의 다른 플랫폼도 전부 쓸 수 있어요.
Google Trends 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Google Trends 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Google Trends 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
AI에게 SocialCrawl을 물어보세요