# Google Search API: 전체 결과 페이지를 JSON으로

> 전체 결과 페이지를 JSON으로 반환하는 Google Search API: 유기적 결과, 광고, People Also Ask, AI Overview, 로컬 팩. US$0.30/1K 검색부터, KYC 없이, 암호화폐 결제.

- URL: https://serpcrypto.com/ko/google-search-api/
- 마지막 업데이트: 2026-10-22
- 발행자: SerpCrypto (https://serpcrypto.com)

국가, 언어, 필요하면 도시를 지정해 검색 쿼리를 보내세요. 구글이 해당 쿼리에 대해 보여준 내용을 구조화된 JSON으로 받습니다: 유기적 결과, 광고, People Also Ask, AI Overview, 로컬 팩 등.

**빠른 답변 — 결과 페이지를 JSON으로 반환하는 Google Search API가 있나요?**

네. **SerpCrypto** Google Search API는 검색 쿼리, 국가, 언어, 도시, 기기로 구글 검색을 실행하고 결과 페이지를 JSON으로 반환합니다: 유기적 결과, 광고, People Also Ask, 구글이 표시하는 경우 출처가 포함된 AI Overview, 로컬 팩, 지식 패널, 주요 뉴스. 검색 성공당 1크레딧이며, 2026년 10월 기준 US$0.30/1K 검색부터입니다. KYC 없이, 암호화폐로 결제하세요.

## Google Search API 한눈에 보기

| 속성 | 값 |
| --- | --- |
| 엔드포인트 | `GET https://serpcrypto.com/api/v1/search?engine=google&q=…` |
| 가격 | 검색 10,000회은 US$7.50, 검색 100,000회은 US$56.25, 5,000,000회 검색 기준 US$0.30/1K 검색부터 |
| 과금 | 1 크레딧 = 성공한 검색 요청 1건이며, 지원되는 모든 엔진에서 결과 한 페이지를 반환합니다. 실패한 요청은 과금되지 않습니다 |
| 크레딧 만료 | 만료 |
| 타겟팅 | 국가(gl), 언어(hl), Google 도메인 및 도시 단위 위치 문자열, 데스크톱 또는 모바일 |
| 페이지당 결과 수 | 페이지당 약 10개의 유기적 결과로, Google이 2025년 9월 num=100을 더 이상 지원하지 않게 된 이후 제공되는 방식입니다. 추가 페이지마다 크레딧이 1개 더 차감됩니다 |
| 반환되는 블록 | `organic_results`, `ads`, `people_also_ask`, `ai_overview`, `local_results`, `knowledge_graph`, `top_stories`, `inline_videos`, `shopping_results`, `related_searches`, `pagination` |
| 인증 | Authorization 헤더(Bearer) 또는 api_key 쿼리 파라미터에 API 키를 넣습니다 |
| 결제 | BTC, USDT, USDC, ETH, SOL, LTC, US$25 충전으로 충당하며, KYC가 없습니다 |

## Google 검색 API는 무엇을 반환하나요?

결과 페이지마다 JSON 객체 하나를 반환하며, Google이 표시한 블록마다 키가 하나씩 있습니다. 페이지에 없는 블록은 그냥 빠지므로, 코드에서는 해당 키가 있는지 먼저 확인한 뒤 읽어야 합니다.

| 키 | 담기는 내용 |
|---|---|
| `organic_results` | 순위, 제목, 링크, 표시 링크, 스니펫, 표시된 경우 날짜, 사이트링크 |
| `ads` | 결과 위아래의 텍스트 광고와 그 순위 및 블록 |
| `people_also_ask` | 각 질문, 답변 스니펫, 출처 링크 |
| `ai_overview` | AI Overview 텍스트와 인용된 페이지 (Google이 표시하는 경우) |
| `local_results` | 지도 팩: 업체명, 주소, 평점, 리뷰 수, 카테고리 |
| `knowledge_graph` | 지식 패널의 제목, 유형, 설명, 출처 |
| `top_stories` | 제목, 링크, 출처, 날짜가 포함된 뉴스 카드 |
| `related_searches` | 페이지 하단에 Google이 제안하는 검색 쿼리 |

모든 응답은 `search_metadata`(상태, 엔진, 시간, `credits_used`)와 `search_parameters`(실제 사용된 설정)로 시작합니다. [응답 형식](https://serpcrypto.com/ko/docs/response/) 페이지에 모든 필드와 예시가 나와 있습니다.

*Python: 독일에서 특정 검색 쿼리의 상위 10개 링크*

```python
import os
import requests

resp = requests.get(
    "https://serpcrypto.com/api/v1/search",
    headers={"Authorization": "Bearer " + os.environ["SERPCRYPTO_API_KEY"]},
    params={"engine": "google", "q": "e-bike kaufen", "gl": "de", "hl": "de", "google_domain": "google.de"},
    timeout=60,
)
resp.raise_for_status()
data = resp.json()
for r in data.get("organic_results", []):
    print(r["position"], r["title"], r["link"])
print("credits used:", data["search_metadata"]["credits_used"])

```

## 특정 국가, 도시 또는 기기에 대한 결과를 얻으려면 어떻게 하나요?

`gl`에 두 글자 국가 코드를, `hl`에 인터페이스 언어를, `location`에 `Austin, Texas, United States` 같은 도시 단위 지명을 설정하세요. `device=mobile`를 추가하면 휴대폰 레이아웃을 받을 수 있으며, 이 레이아웃은 데스크톱과 달리 로컬 및 동영상 블록의 순서가 자주 다릅니다.

- **국가:** `gl=gb`는 영국에서 검색하는 사용자가 보는 결과를 반환하며, `google_domain=google.co.uk`과 함께 사용하세요.
- **언어:** `gl=us`와 함께 `hl=es`를 사용하면 미국에서 스페인어 인터페이스를 볼 수 있습니다.
- **도시:** `location`은 배관공, 식당, 병원처럼 로컬 의도 검색 쿼리에서 가장 중요합니다.
- **기기:** 기본값은 `desktop`이며, 같은 검색 쿼리를 모바일로 확인하는 것은 별도의 검색으로 크레딧이 따로 듭니다.

[지역 및 언어](https://serpcrypto.com/ko/docs/locations/) 페이지에 주요 시장의 코드와 location 문자열 형식이 나와 있습니다.

## 한 요청에 몇 개의 결과가 반환되나요?

요청 하나는 결과 페이지 하나, 즉 약 10개의 유기적 결과를 반환합니다. Google은 2025년 9월 10~14일경부터 `num=100` 파라미터를 더 이상 지원하지 않으므로, 이제 top-100 확인에는 요청 한 번이 아니라 10번이 필요합니다. Search Engine Land가 319개 사이트를 분석한 결과, 변경 이후 87.7%가 Search Console 노출 감소를 겪었으며, 대부분 첫 결과 페이지 이후의 페이지 때문이었습니다.

SerpCrypto를 사용하면 `page=2`부터 `page=10`까지 다음 페이지를 가져오며, 페이지마다 크레딧 하나가 듭니다. 따라서 1,000개 키워드의 일일 top-10 확인은 한 달에 30,000회 검색이고, 일일 top-100 확인은 300,000회입니다. [순위 추적 가이드](https://serpcrypto.com/ko/use-cases/rank-tracking/)에 두 경우의 예산 책정 방법이 나와 있습니다.

## API가 Google AI Overviews를 반환하나요?

네, Google이 표시하는 경우에 그렇습니다. `ai_overview` 객체에는 개요 텍스트와, 인용된 각 페이지의 제목, 링크, 출처를 담은 `references` 목록이 들어 있습니다. Google은 모든 검색 쿼리, 국가, 기기에서 AI Overview를 표시하지 않으므로, 많은 결과 페이지에서 이 키는 빠져 있습니다.

AI Overview 데이터는 두 가지 실용적인 질문에 답합니다. 특정 검색 쿼리에서 내 페이지가 인용되는지, 그리고 어떤 경쟁사가 인용되는지입니다. `ai_overview.references`를 `organic_results` 순위와 함께 저장하면, 같은 일일 작업으로 둘 다 시간에 따라 추적할 수 있습니다.

## 2025년과 2026년 변경 이후에도 Google SERP API는 여전히 작동하나요?

작동은 하지만, 저희를 포함한 모든 제공업체가 2년 전보다 더 많은 마찰을 겪고 있습니다. 2026년 10월 22일 기준 공개된 사실은 다음과 같습니다:

- **2025년 1월:** Google이 검색에 JavaScript를 요구하기 시작했고, 이로 인해 결과 페이지의 단순 HTTP 가져오기가 끝났습니다.
- **2025년 9월:** `num=100`가 작동을 멈춰, 심층 확인에 드는 요청 수가 10배로 늘었습니다.
- **2026년 7~8월:** 결과 링크가 서버 측 `/goto` 리다이렉트를 거치기 시작했습니다.
- **2026년 9월 11일경 이후:** 순위 추적 업체들이 대규모 주거용 프록시 네트워크에서의 광범위한 차단, 늘어난 CAPTCHA, 변경된 결과를 보고했습니다. Nozzle은 결과 페이지의 8.0%가 영향을 받았다고 측정했고, DemandSphere는 약 11%로 측정했습니다.

이것이 의미하는 바: 실패한 검색은 오류를 반환하며 **비용이 청구되지 않으므로**, 실패로 손해 보는 것은 크레딧이 아니라 시간입니다. 저희는 공개 표본을 대상으로 측정을 마치기 전까지 성공률이나 응답 시간을 공개하지 않으며, 측정을 마치면 방법과 날짜를 이 페이지에 게시합니다.

## Google 검색 API는 비용이 얼마인가요?

Google은 다른 모든 엔진과 동일하게 크레딧 하나입니다. 2026년 10월 기준 검색 10,000회의 비용은 US$7.50, 검색 100,000회의 비용은 US$56.25, 1,000,000회 검색의 비용은 US$375입니다. 크레딧은 만료되지 않습니다. [일곱 가지 팩 모두 보기](https://serpcrypto.com/ko/pricing/).

| 요금제 | 수량 | 가격 | 단가 |
| --- | --- | --- | --- |
| 테스트 | 검색 10,000회 | US$7.50 | US$0.75/1K 검색 |
| 빌드 | 검색 100,000회 | US$56.25 | US$0.56/1K 검색 |
| 규모 | 500,000회 검색 | US$281.25 | US$0.56/1K 검색 |
| 볼륨 | 1,000,000회 검색 | US$375 | US$0.38/1K 검색 |

모든 요금제에 포함: 모든 엔진 검색당 크레딧 1개 · 실패한 요청은 과금되지 않음 · 크레딧은 만료되지 않음 · 국가, 언어, 도시 및 디바이스 타겟팅

**결제 전 확인 사항**

- 최소 충전 금액 US$25. 암호화폐로 한 번 충전하면 잔액에서 원하는 요금제를 구매할 수 있습니다.
- 미사용 잔액은 계정에 그대로 남아 만료되지 않으며 검색 크레딧 결제에 사용됩니다. 구매 금액이 최소 충전 금액보다 적어 최소 금액을 채우기 위해서만 추가된 부분은 결제일로부터 30일 이내에 지원팀에 요청하면 USDT 또는 USDC로 환불되며, 사용되지 않은 경우에 한합니다. 나머지 잔액은 법령에서 요구하는 경우를 제외하고 환불되지 않습니다.
- 블록체인에서 결제가 확인되면 잔액에 반영됩니다. 일반적인 네트워크 확인 시간: BTC ≈ 20분 · USDT TRC-20 ≈ 1분 · USDT ERC-20 ≈ 5분 · USDC ERC-20 ≈ 5분 · ETH ≈ 5분 · SOL ≈ 1분 · LTC ≈ 15분

## Google 검색 API: 자주 묻는 질문

### 이것은 Google의 공식 API인가요?

아니요. SerpCrypto는 독립적인 SERP API로, 검색을 실행하고 Google이 반환한 페이지를 파싱합니다. Google 자체의 개발자 검색 제품은 Custom Search JSON API로, 설정된 사이트 집합 내에서 검색합니다. 두 API의 비교는 저희 [Google Custom Search API 대안](https://serpcrypto.com/ko/alternatives/google-custom-search-api/) 페이지에서 확인하세요.

### 한 요청으로 10개 이상의 결과를 받을 수 있나요?

아니요. Google은 2025년 9월부터 `num=100`를 더 이상 지원하지 않으므로, 결과 페이지 하나에는 약 10개의 유기적 결과가 담깁니다. 11위부터 100위까지는 `page=2`에서 `page=10`까지 요청하세요. 페이지마다 크레딧 하나입니다.

### 실패한 검색에도 비용이 청구되나요?

아니요. 1 크레딧 = 성공한 검색 요청 1건이며, 지원되는 모든 엔진에서 결과 한 페이지를 반환합니다. 실패한 요청은 과금되지 않습니다. 오류는 HTTP 상태와 `search_failed` 또는 `search_timeout` 같은 코드와 함께 반환됩니다. [오류](https://serpcrypto.com/ko/docs/errors/) 페이지에 백오프를 적용한 재시도 루프가 나와 있습니다.

### Google Maps, 뉴스, 이미지, 쇼핑도 검색할 수 있나요?

네, 같은 API 키와 같은 크레딧으로 가능합니다. `engine`를 `google_maps`, `google_news`, `google_images`, `google_shopping`로 설정하세요. 각각 별도 페이지가 있습니다: [Maps](https://serpcrypto.com/ko/google-maps-api/), [뉴스](https://serpcrypto.com/ko/google-news-api/), [이미지](https://serpcrypto.com/ko/google-images-api/), [쇼핑](https://serpcrypto.com/ko/google-shopping-api/).

### 키를 받으려면 회사나 신분증이 필요한가요?

아니요. SerpCrypto는 KYC 없는 SERP API입니다. 신분증도, 셀피도, 회사 서류도, 카드도 필요 없습니다. 계정 번호로 로그인하며 이메일은 선택 사항입니다. BTC, USDT, USDC, ETH, SOL, LTC로 US$25에서 충전합니다.

## 출처

1. [Google이 Google 검색에 JavaScript를 요구하기 시작](https://techcrunch.com/2025/01/17/google-begins-requiring-javascript-for-google-search/) — TechCrunch (2025-01-17)
2. [Google num=100 영향 데이터](https://searchengineland.com/google-num100-impact-data-462231) — Search Engine Land (2025-09)
3. [Google의 goto 리다이렉트](https://susodigital.com/thoughts/googles-goto-redirect/) — SUSO Digital (2026-09-25)
4. [서드파티 Google 순위 추적 중단](https://www.seroundtable.com/third-party-google-rank-tracking-broken-42272.html) — Search Engine Roundtable (2026-10-12)
5. [DemandSphere 일일 순위 확인 중 11%에서 Google이 잘못된 결과 반환](https://ppc.land/google-returns-wrong-results-on-11-of-demandspheres-daily-rank-checks) — PPC Land (2026-10-13)

---

SerpCrypto: SerpCrypto는 개발자와 AI 에이전트를 위한 SERP API로, Google 및 Bing 검색 결과를 JSON으로 반환하며 신분증 업로드 없이 암호화폐로 결제합니다. 선불 검색 크레딧 US$0.30/1K 검색는 만료되지 않습니다. KYC 없이 — 신분증도, 셀피도, 서류도 없습니다. 암호화폐 결제.