100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
Google Search logo
100 크레딧 무료, 카드 등록 없이

Google Search Keyword Volume API

Google 월간 검색량과 클릭당 비용, 경쟁도, 최근 12개월 추이를 돌려줍니다. 한 국가 기준으로 키워드를 스무 개까지 받아 키워드마다 한 행씩 담습니다.

GET /v1/google/keyword-volume

2026년 11월 업데이트SocialCrawl 팀이 직접 관리해요

Google Search Keyword Volume API는 언제 쓰나요

같은 키워드로 국가마다 한 번씩 호출해 제품 수요를 국가별로 비교할 때 사용합니다.

API 레퍼런스 영문 원문

Returns Google monthly search volume, cost per click, competition, and a 12-month trend for up to 20 keywords in one country. Response is { location, location_name, language, items }: each item carries keyword, search_volume (average monthly searches), cpc with its currency, competition (0 to 1) with competition_level, monthly_searches (the last 12 months, oldest first, as { year, month, search_volume }) and, where Google classifies it, search_intent. Use it to compare demand for a product across markets: call it once per country with the same keywords. You get one item per keyword you asked for, in your order. A keyword Google holds no volume for comes back with search_volume: null, never 0, so a null means unknown and a 0 means Google reports none. Every null row says why in null_reason: "withheld" means Google stopped publishing volume for the term (since December 2023 it withholds many health and other sensitive terms, such as "shingles" or "herniated disc"), and such a row carries last_reported ({ year, month, search_volume }, the last month Google published a figure) with an empty monthly_searches; "no_data" means Google holds no figure at all (very rare or unknown terms). For relative interest in a withheld term, use /v1/google_trends/explore, or /v1/naver/search-trend in Korea. When no keyword has current volume the call returns 404 and costs 0 credits; its message lists the last published figures. Volumes are Google's own rounded monthly averages and are refreshed monthly, so results are cached for 24 hours. Typical latency is 2 seconds. Priced at a flat 16 credits per call whatever the keyword count, so send all 20 at once.

75개 플랫폼을 하나의 API로 제공합니다

·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
Google Search API

Keyword Volume API로 무엇을 할 수 있을까요

Keyword Volume 엔드포인트가 통합 스키마와 계산 필드를 담은 Google Search 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.

요청 예시

# GET /v1/google/keyword-volume: 16 credits per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 10: this endpoint's measured p99 latency x 1.5.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 10 --retry 3 -o response.json \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://www.socialcrawl.dev/v1/google/keyword-volume?keywords=lip+gloss%2Clip+oil&location=GB" && cat response.json
# GET /v1/google/keyword-volume: 16 credits per call. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid

import requests

API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 10  # this endpoint's measured p99 latency x 1.5.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/google/keyword-volume"


def backoff(attempt):
    # Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
    return 2 ** attempt * (0.5 + random.random() / 2)


def socialcrawl(params):
    # One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
    idempotency_key = str(uuid.uuid4())
    for attempt in range(MAX_RETRIES + 1):
        try:
            res = requests.get(
                URL,
                params=params,
                headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
                timeout=TIMEOUT_S,
            )
            body = res.json()
        except (requests.RequestException, ValueError):
            # A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
            if attempt == MAX_RETRIES:
                raise
            time.sleep(backoff(attempt))
            continue
        if body["success"]:
            return body
        error = body["error"]
        # Branch on error["type"], never on the message text.
        if error["type"] == "RESOURCE_NOT_FOUND":
            return None  # refunded: nothing to read
        retry_after = res.headers.get("Retry-After")
        # SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
        permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
        if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
            raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
        # Retry-After (seconds) wins; otherwise back off.
        time.sleep(float(retry_after) if retry_after else backoff(attempt))


params = {
    "keywords": "lip gloss,lip oil",
    "location": "GB",
}
body = socialcrawl(params)
if body is not None:
    print(body["data"])
// GET /v1/google/keyword-volume: 16 credits per call. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 10_000; // this endpoint's measured p99 latency x 1.5.
const MAX_RETRIES = 3;

type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
  | { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
  | { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };

const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);

async function socialcrawl(url: URL) {
  // One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
  const idempotencyKey = crypto.randomUUID();
  for (let attempt = 0; ; attempt++) {
    let res: Response;
    let body: SocialCrawlResponse;
    try {
      res = await fetch(url, {
        headers: {
          "x-api-key": API_KEY,
          "Idempotency-Key": idempotencyKey,
        },
        signal: AbortSignal.timeout(TIMEOUT_MS),
      });
      body = (await res.json()) as SocialCrawlResponse;
    } catch (error) {
      // A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
      if (attempt >= MAX_RETRIES) throw error;
      await sleep(backoffMs(attempt));
      continue;
    }
    if (body.success) return body;
    // Branch on error.type, never on the message text.
    if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
    const retryAfter = res.headers.get("Retry-After");
    // SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
    const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
    if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
      throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
    }
    // Retry-After (seconds) wins; otherwise back off.
    await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
  }
}

const url = new URL("https://www.socialcrawl.dev/v1/google/keyword-volume");
url.searchParams.set("keywords", "lip gloss,lip oil");
url.searchParams.set("location", "GB");

const body = await socialcrawl(url);
if (body) console.log(body.data);

파라미터

파라미터필수설명
keywords예1-20 comma-separated keywords (e.g. 'lip gloss,lip oil'). Each keyword may be up to 80 characters. Duplicates are ignored. More than 20 keywords, or a keyword over 80 characters, is rejected with a free 400 before the request is billed.
location아니오Country as an ISO code ('US', 'GB', 'KR'), a full country name ('United Kingdom', 'South Korea') or a numeric location code ('2826'). Defaults to the United States. Volume is published for 94 countries; any other location is rejected with a free 400 naming the accepted forms.
language아니오Language code ('en', 'de', 'ko') the keywords are searched in. Defaults to the first language listed for the country: Germany is 'de' and Belgium is 'fr', but Vietnam, Indonesia, India, Malaysia, Pakistan, the Philippines, Hong Kong and Singapore default to 'en', so pass their local language (e.g. 'vi', 'id', 'hi') explicitly. A language the country does not hold (Germany in English) is rejected with a free 400 listing the ones it does.
응답 예시

Google Search Keyword Volume API는 무엇을 돌려주나요

모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.

응답 예시 보기
{
  "success": true,
  "platform": "google",
  "endpoint": "/v1/google/keyword-volume",
  "data": {
    "location": "US",
    "location_name": "United States",
    "language": "en",
    "items": [
      {
        "keyword": "hyperhidrosis",
        "search_volume": 110000,
        "cpc": 11.73,
        "currency": "USD",
        "competition": 0.21,
        "competition_level": "LOW",
        "monthly_searches": [
          {
            "year": 2025,
            "month": 9,
            "search_volume": 135000
          },
          {
            "year": 2025,
            "month": 10,
            "search_volume": 135000
          },
          {
            "year": 2025,
            "month": 11,
            "search_volume": 110000
          },
          {
            "year": 2025,
            "month": 12,
            "search_volume": 110000
          },
          {
            "year": 2026,
            "month": 1,
            "search_volume": 110000
          },
          {
            "year": 2026,
            "month": 2,
            "search_volume": 110000
          },
          {
            "year": 2026,
            "month": 3,
            "search_volume": 110000
          },
          {
            "year": 2026,
            "month": 4,
            "search_volume": 110000
          },
          {
            "year": 2026,
            "month": 5,
            "search_volume": 110000
          },
          {
            "year": 2026,
            "month": 6,
            "search_volume": 110000
          },
          {
            "year": 2026,
            "month": 7,
            "search_volume": 110000
          },
          {
            "year": 2026,
            "month": 8,
            "search_volume": 135000
          }
        ],
        "search_intent": "informational"
      },
      {
        "keyword": "shingles",
        "search_volume": null,
        "cpc": null,
        "currency": "USD",
        "competition": null,
        "competition_level": null,
        "monthly_searches": [],
        "search_intent": "informational",
        "null_reason": "withheld",
        "last_reported": {
          "year": 2023,
          "month": 11,
          "search_volume": 673000
        }
      },
      {
        "keyword": "herniated disc",
        "search_volume": null,
        "cpc": null,
        "currency": "USD",
        "competition": null,
        "competition_level": null,
        "monthly_searches": [],
        "search_intent": "informational",
        "null_reason": "withheld",
        "last_reported": {
          "year": 2023,
          "month": 12,
          "search_volume": 165000
        }
      }
    ],
    "dropped": 0
  },
  "credits_used": 16,
  "credits_remaining": 100,
  "request_id": "req-AkyBmdWENDrwA50W",
  "cached": false
}

통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.

API 상세

Google Search Keyword Volume API는 어떻게 동작하나요

API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.

메서드

GET

응답 형식

JSON

왜 SocialCrawl인가요

Google Search Keyword Volume 데이터는 왜 SocialCrawl로 가져올까요

Google Search 데이터 추출에서 까다로운 부분은 SocialCrawl이 가려 드려요. 통합 스키마, AI 인리치먼트, 그리고 코드에 남지 않는 플랫폼 로직까지.

개발자 우선

소셜 미디어 데이터를 몇 초 만에 수집하는 방법

개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 75개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.

모든 플랫폼을 하나의 스키마로

동일한 응답 구조로 75개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.

단순 수집을 넘어 계산된 필드 제공

엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.

코드 한 줄 쓰기 전에, 데이터부터

Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 75개 플랫폼
자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
키워드 검색량 API는 어떤 데이터를 돌려주나요?
한 국가에서 최대 20개 키워드에 대해 search_volume(월평균 검색 수), cpc와 통화, competition(0~1)과 competition_level, 최근 12개월 monthly_searches(오래된 달부터), 구글이 분류한 경우 search_intent를 돌려줘요. 키워드마다 항목이 하나씩, 보낸 순서대로 나와요.
키워드 검색량 API는 어떻게 호출하나요?
GET /v1/google/keyword-volume에 keywords(쉼표로 구분, 1~20개, 키워드당 80자까지)와 x-api-key 헤더를 보내면 돼요. 미국이 아닌 시장이면 location(GB, KR 같은 ISO 코드나 국가 이름)과 language('en', 'de', 'ko')를 함께 넣어요.
요금은 얼마인가요?
키워드 개수와 상관없이 한 번 호출에 16 크레딧(프리미엄 티어)이에요. 그러니 20개를 한꺼번에 보내는 게 이득이에요. 현재 검색량이 있는 키워드가 하나도 없으면 404가 돌아오고 0 크레딧이며, 실패하거나 비어 있는 호출의 크레딧은 자동으로 환불돼요.
search_volume이 null인 키워드는 왜 그런가요?
null은 알 수 없다는 뜻이고 0은 구글이 검색량 없음으로 본다는 뜻이에요. null 행에는 null_reason이 붙어요. withheld는 구글이 해당 검색어의 검색량 공개를 멈췄다는 뜻이고(2023년 12월부터 건강 관련 검색어 다수), 이때 last_reported에 마지막으로 공개된 달의 값이 들어가요. no_data는 구글에 수치가 아예 없다는 뜻이에요.
검색량이 비공개인 키워드의 수요는 어떻게 보나요?
상대적인 관심도 추이는 /v1/google_trends/explore로, 한국에서는 /v1/naver/search-trend로 볼 수 있어요. 월간 숫자 대신 추이 곡선을 받아요.
검색량은 얼마나 최신이고 국가별 비교도 되나요?
구글이 반올림해 매달 갱신하는 월평균 값이라서 결과를 24시간 캐시해요. 시장별 수요를 비교하려면 같은 키워드로 국가마다 한 번씩 호출하세요. 응답은 보통 2초 정도 걸려요.

AI에게 SocialCrawl을 물어보세요

Google Search Keyword Volume 데이터, 가져올 준비 되셨어요?

API 키 받고 60초 안에 Google Search 데이터를 받아 가세요.

무료로 시작하기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요