구글 트렌드 API, 관심도 0이면 404·0크레딧

SocialCrawl 구글 트렌드 API는 관심도 0인 키워드에 404와 크레딧 0을 돌려주고, 적용할 수 없는 필터는 무료 400으로 거절해요. 2026-09-08 프로덕션에서 찍은 curl, 응답 envelope, credits_used 영수증을 그대로 보여 드릴게요.

Trends·News·App Store·Play에서 확인한 동작은 9개예요. 인증은 x-api-key 헤더고, 경로는 /v1/google_trends, /v1/google_news, /v1/app_store, /v1/google_play 아래예요.

SocialCrawl 구글 트렌드 API로 지금 뭘 할 수 있나요?

공식 Google 트렌드 API는 알파·신청제예요. 오늘 당장 키를 발급받아 돌릴 수 있는 REST가 필요하면 SocialCrawl 경로를 쓰면 돼요. pytrends는 아카이브된 비공식 파이썬 경로예요. 노트북용으로 남아 있어도 프로덕션 계약(상태코드·크레딧 영수증)은 아니에요.

아래 표는 2026-09-08 프로덕션에서 확인한 동작이에요. before 열은 업그레이드 메모에 적힌 옛 동작이고, 이번 런에서 옛 동작을 다시 측정한 값은 아니에요. after만 라이브 증거예요.

원칙은 단순해요. 답이 있을 때만 과금하고, 적용할 수 없는 필터는 조용히 무시하지 않아요. 아래 세 예제를 깊게 보고, 나머지는 표로 압축해 둘게요.

관심도 0인 구글 트렌드 요청은 왜 404인가요?

구글 트렌드 검색량이 사실상 없는 키워드를 치면, 빈 시계열을 200으로 돌려주고 크레딧을 깎는 대신 리소스가 없다고 말해요. 업그레이드 메모 기준 before는 200 + 빈 시리즈 + 5크레딧이었어요. 지금은 404와 0크레딧이에요.

왜 이렇게 바꿨냐면, 빈 시리즈를 성공으로 받으면 대시보드·알람 코드가 “데이터는 있는데 전부 0”으로 해석하기 쉬워서예요. 관심도가 없다는 사실을 404로 드러내면, 호출하는 쪽에서 분기하기가 훨씬 단순해요. 크레딧도 안 깎이니까 탐색 비용이 작아요.

의미 없는 키워드 zzqqxjw로 재현해 보세요.

curl "https://www.socialcrawl.dev/v1/google_trends/explore?keywords=zzqqxjw" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

{
  "success": false,
  "error": {
    "type": "RESOURCE_NOT_FOUND",
    "message": "No search-interest data were returned for this keyword. The location and timeframe were accepted; Google Trends simply holds too little search volume for this keyword in that combination to build a result. Try a wider `timeframe`, a broader keyword, or the keyword in the local language of the location you requested. You were not charged for this request.",
    "status": 404
  },
  "credits_used": 0
}

/v1/google_trends/rising?keyword=zzqqxjw도 같은 영수증이에요. 404 · credits_used: 0.

반대로 관심도가 있는 키워드는 정상 시계열과 5크레딧이에요.

curl "https://www.socialcrawl.dev/v1/google_trends/explore?keywords=taylor%20swift" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

2026-09-08 측정: HTTP 200, 주간 포인트 53개, 구간 평균 25, credits_used: 5. 마지막 세 버킷만 보면 이래요.

마지막 점이 떨어지는 것처럼 보일 때, 먼저 partial을 보세요. 아직 집계 중인 현재 버킷이에요. 차트를 그리기 전에 partial: true 행을 걸러내면 가짜 하락을 피할 수 있어요. 이 날짜는 측정일 기준이라, Google이 주간을 닫으면 플래그가 false로 바뀌어요.

한 가지 주의: zzqqxjw는 의도적으로 만든 가짜 키워드예요. 실제 저볼륨 니치 키워드도 지역·기간을 좁히면 404가 날 수 있어요. Google 트렌드 FAQ가 말하듯 관심도는 절대 검색량이 아니라 0–100으로 정규화된 인덱스고, 검색이 너무 적으면 0으로 떨어져요. 그건 버그가 아니라 관심도 사실이에요.

구글 트렌드 API 사용법에서 가장 먼저 확인하면 좋은 계약이 이거예요. 빈 결과는 과금하지 않아요.

구글 뉴스 API rank는 왜 빠지면 안 되나요?

구글 뉴스 API는 요청한 depth만큼만 자르고, 각 행에 1부터 연속인 rank를 붙여 줘요. 업그레이드 메모 before는 depth 20 요청에 29건이 나오거나, 여러 행에서 순위 필드가 비는 경우가 있었어요. 지금은 정확히 20행, ranks 1..20, 공백·중복 없음이에요.

뉴스 피드를 캐시하거나 페이지 단위로 이어 붙일 때, 순위가 비거나 건수가 들쭉날쭉하면 파서가 깨져요. “요청한 만큼만, 번호는 끊기지 않게”가 계약이에요.

curl "https://www.socialcrawl.dev/v1/google_news/search?keyword=openai&depth=20" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

샘플 세 행(+마지막):

응답 JSON 필드 이름은 rank(1-based)예요. 업그레이드 영문 메모에 쓰인 “position”은 내부 용어고, 응답에는 rank만 나와요. 정렬·페이지네이션·캐시를 짤 때 빈 슬롯을 가정하지 마세요.

주의할 점도 솔직히 적을게요. rank는 SocialCrawl이 이번 요청에서 돌려준 페이지 안 순서예요. Google News 외부의 “공식 점수”가 아니에요. 그래도 depth를 지키지 않거나 순위가 구멍 나면 파서가 깨지니까, 연속 rank는 계약으로 지켜요.

적용 안 되는 필터는 왜 거절하나요?

필터를 조용히 무시하고 전체 피드를 과금하면, 호출하는 쪽은 “필터가 된 줄” 알고 잘못된 분석을 쌓아요. 그래서 적용할 수 없는 파라미터는 이름을 밝힌 400으로 거절하고, 크레딧은 0이에요.

앱스토어 리뷰 API에서 Apple rating을 깊게 볼게요. Apple App Store 리뷰는 별점으로 걸러 주는 필터가 없어요. 예전(업그레이드 메모)에는 미필터 피드를 200으로 주고 5크레딧을 깎았어요. 지금은 거절해요.

curl "https://www.socialcrawl.dev/v1/app_store/app-reviews?app_id=310633997&rating=1" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

HTTP 400, 메시지에 rating이 명시되고, 별점 필터가 필요하면 /v1/google_play/app-reviews로 안내해요. credits_used: 0.

구글 트렌드 API도 같은 패턴이에요. category에 이름 문자열을 넣으면 거절해요.

curl "https://www.socialcrawl.dev/v1/google_trends/explore?keywords=jaguar&category=games" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

{
  "success": false,
  "error": {
    "type": "INVALID_REQUEST",
    "message": "`category` must be a numeric Google Trends category code, not a name. Received \"games\". Omit it (or send 0) to search every category.",
    "status": 400
  },
  "credits_used": 0
}

나머지 검증 실패는 표로 압축할게요. 전부 2026-09-08 라이브예요.

구글 플레이 리뷰 API의 rating=7 예시는 이렇게 재현해요.

curl "https://www.socialcrawl.dev/v1/google_play/app-reviews?app_id=com.spotify.music&rating=7" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

Play /locations는 “거절”은 아니지만, 예전에 수십만 행·수십 MB로 나오던 목록을 211행·약 28KB로 줄였어요. 필요한 스토어프론트 코드만 받고 싶을 때 부담이 작아요.

공식 Play/App Store 리뷰 API는 본인 앱 범위예요(Play Developer API, App Store Connect Customer Reviews). 경쟁 앱 리뷰·차트·자동완성을 한 키로 읽을 때는 SocialCrawl 같은 데이터 API를 쓰면 돼요.

구글 트렌드 API 사용법 — 어떻게 시작하나요?

1. 가입하고 API 키를 받아요. 헤더는 x-api-key예요.
2. 가장 작은 호출부터 돌려 보세요. 빈 Trends는 0크레딧, News depth=10은 1크레딧이에요. 코드 한 줄 쓰기 전에 데이터를 먼저 확인해 보세요.

# 관심도 0 → 404 · 0크레딧 (키만 확인해도 됨)
curl "https://www.socialcrawl.dev/v1/google_trends/explore?keywords=zzqqxjw" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

# 뉴스 10건 → 200 · 1크레딧
curl "https://www.socialcrawl.dev/v1/google_news/search?keyword=openai&depth=10" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

3. 응답 모양을 눈으로 먼저 보고 싶으면 비주얼 익스플로러를 열고, 파라미터·스키마는 문서에서 이어가요. 구글 트렌드, 구글 뉴스, App Store, Google Play 네 경로면 이번 글에서 다룬 엔드포인트를 다 볼 수 있어요.

구글 트렌드 파이썬(pytrends)으로 노트북을 돌리던 분들은 GeneralMills/pytrends가 2025-04-17에 아카이브된 사실을 알아 두세요. 비공식·읽기 전용 경로예요. REST와 크레딧 영수증이 필요한 파이프라인과는 계약이 달라요.

한국 검색 수요만 보면 Google Trends에 덜 잡힐 수 있어요. 같은 키로 네이버 쪽은 /v1/naver/search-trend(네이버 문서)를 보면 돼요. 영문 비교 글은 Best Google Trends APIs 2026에 있어요. 이번 글은 비교 리스트가 아니라 과금·필터 정직성 쇼케이스예요.

자주 묻는 질문

구글 트렌드 API는 공식인가요, SocialCrawl인가요?

둘 다 “구글 트렌드 API”로 검색되지만 성격이 달라요. 공식 Trends API는 알파·신청제고, 오늘 바로 발급받는 키가 없어요. SocialCrawl은 지금 x-api-key로 호출하는 REST예요. 관심도 시계열·뉴스·앱 마켓 데이터를 같은 인증으로 받을 때 쓰는 경로예요.

관심도 0 키워드를 호출하면 크레딧이 차감되나요?

아니요. RESOURCE_NOT_FOUND(404)와 함께 **credits_used: 0**이에요. 위에서 찍은 zzqqxjw 영수증이 그대로예요. 데이터가 있을 때만 explore/rising이 5크레딧을 써요.

구글 뉴스 API에서 rank가 비어 있으면 어떻게 정렬하나요?

비지 않아요. depth=N이면 ranks는 1..N 연속이고 중복이 없어요. 응답을 받은 뒤 rank로 정렬·병합하면 돼요. 빈 슬롯 보정 로직은 필요 없어요.

구글 트렌드 API 사용법 — Python(pytrends)과 REST 중 뭐가 맞나요?

일회성 노트북·탐험이면 로컬 라이브러리도 쓸 수 있어요. 다만 pytrends는 아카이브된 비공식 경로라 Google 쪽이 바뀌어도 고칠 사람이 없어요. 상태코드·크레딧·재시도 계약을 코드에 박아야 하는 서비스라면 REST가 맞아요. SocialCrawl은 빈 결과와 잘못된 필터를 과금 전에 거절해요.

Trends 시계열 마지막 점이 떨어지는 것처럼 보이는 이유는?

현재 집계 버킷에 partial: true가 붙어 있어서예요. 2026-09-08 측정에서는 2026-09-06만 true였고 나머지 52개는 false였어요. 차트·알림 전에 partial 행을 빼세요. 날짜를 “영원히 partial”로 하드코딩하지 마세요. 주간이 닫히면 플래그가 바뀌어요.

문서와 익스플로러 링크만 다시 모아 둘게요. 구글 트렌드 문서, 구글 뉴스 문서, App Store, Google Play, 비주얼 익스플로러. 위 curl을 자기 키로 그대로 재현해 보시면 영수증이 맞는지 바로 확인할 수 있어요.