Google Search API는 어떻게 호출하나요?

쿼리를 담아 인증된 POST 요청을 보냅니다. serp.cheap의 경우: POST https://api.serp.cheap/v1/search, 헤더 X-API-Key, JSON 본문은 {"q": "...", "gl": "us"} 형태입니다. 응답은 결과가 담긴 organic[] 배열이 있는 JSON입니다.

브라우저에서 Google Search API를 호출할 수 있나요?

안 됩니다 — API 키를 클라이언트 측 코드에 절대 노출하지 마세요. 키가 비밀로 유지되도록 항상 자체 백엔드를 통해 요청을 프록시하세요.

Google Search API 비용을 낮게 유지하려면 어떻게 하나요?

캐싱을 활용하고(serp.cheap에서는 반복 쿼리가 절반 가격에 제공됩니다), 필요할 때만 추가 페이지를 가져오며, 호출별로 stats.cost를 추적하세요.

2026년 Google Search API 사용법: 완벽 가이드

이 글은 Google Search API를 사용하는 실용적인 처음부터 끝까지의 가이드입니다: 인증하고, 쿼리를 보내고, JSON을 읽고, 페이지네이션하고, 오류를 처리하고, 비용을 낮게 유지하는 법을 다룹니다. 예제는 serp.cheap(2026년 가장 저렴한 선택지)를 사용하지만, 개념은 어떤 SERP API에도 적용됩니다.

1. API 키 받기

app.serp.cheap/login에서 무료로 가입하세요 — 카드 없이 100회 무료 검색을 받을 수 있습니다. X-API-Key 헤더로 전달할 키를 즉시 받게 됩니다. 카드로 결제하는 편이 좋다면 Apify나 RapidAPI에서도 동일한 API를 쓸 수 있습니다. 크레딧은 12개월간 유효합니다.

2. 한 줄로 보는 엔드포인트

POST https://api.serp.cheap/v1/search

파라미터	기본값	설명
`q`	필수	검색 쿼리
`gl`	`"us"`	국가 (예: `br`, `gb`, `de`)
`hl`	국가 기본값	UI 언어 재정의
`page`	`1`	결과 페이지 (1부터 시작)
`tbs`	없음	기간 필터: `qdr:h`, `qdr:d`, `qdr:w`

전체 레퍼런스: Google Search API 파라미터.

3. 첫 번째 요청

curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "best electric cars 2026", "gl": "us", "page": 1}'

import requests

r = requests.post(
    "https://api.serp.cheap/v1/search",
    headers={"X-API-Key": "YOUR_KEY"},
    json={"q": "best electric cars 2026", "gl": "us", "page": 1},
)
r.raise_for_status()
data = r.json()
for item in data["organic"]:
    print(item["position"], item["title"], item["link"])

언어별 가이드: Python · Node.js · PHP · Go · curl.

4. 응답 읽기

{
  "search": "best electric cars 2026",
  "page": 1,
  "organic": [
    {
      "position": 1,
      "title": "Best Electric Cars of 2026",
      "link": "https://example.com/best-evs",
      "snippet": "We tested every major EV...",
      "date": "Jan 10, 2026"
    }
  ],
  "stats": { "balance": 99994, "cost": 6, "cached": false }
}

stats.cost는 크레딧 단위입니다(1 크레딧 = $0.0001). 신규 조회는 6 크레딧($0.0006)이고 캐시 적중은 3 크레딧($0.0003)입니다. stats.cached는 어떤 경로로 처리되었는지 알려줍니다.

5. 페이지네이션

각 페이지는 별도의 요청입니다 — page를 증가시키세요. 사용자가 실제로 필요로 할 때만 2페이지 이상을 가져오세요. 100개 결과 얻기를 참고하세요.

6. 오류 처리

401 — 잘못되거나 누락된 API 키.
402 — 크레딧 소진; 충전하세요.
429 — 속도 제한(무료 등급 분당 60건, 종량제 분당 600건, 상위 플랜 최대 초당 60건); 백오프 후 재시도하세요.
5xx — 일시적 오류; 지수 백오프로 재시도하세요.

429/5xx에 대해서는 항상 백오프 재시도로 호출을 감싸세요.

7. 저렴하게 유지하기

캐시 적중은 절반 가격 — 반복 쿼리에 대해 신규 조회를 강제하지 마세요.
페이지네이션은 지연 로딩으로.
gl을 정확히 선택하여 재실행을 피하세요.

다음 단계

실제로 무언가 만들어 보세요: Python 순위 추적기 또는 AI 에이전트를 위한 Google Search.
제공업체 비교: 2026년 가장 저렴한 SERP API.
Apify에서 API 키 받기 →