# Google Custom Search JSON API 대안: 2027년 1월 1일 전에 무엇을 써야 할까

> Google의 Custom Search JSON API는 신규 사용자에게 닫혔고 2027년 1월 1일에 종료됩니다. US$0.30/1K 검색의 전체 웹 JSON 결과로 이전하세요. KYC 없이, 암호화폐 결제.

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

Google은 Custom Search JSON API를 신규 고객에게 닫았고 2027년 1월 1일에 모든 사용자에게 종료합니다. 이 페이지에서는 무엇이 바뀌는지, Google이 대신 무엇을 제공하는지, 그리고 오후 한나절 만에 코드를 SERP API로 옮기는 방법을 설명합니다.

**빠른 답변 — Google Custom Search JSON API를 대체하는 것은 무엇인가요?**

Google의 Custom Search JSON API는 신규 고객에게 닫혔고, 기존 고객은 **2027년 1월 1일**까지 이전해야 합니다. Google은 최대 50개 도메인 검색에는 Vertex AI Search를 가리키며, 전체 웹 결과에는 보통 SERP API가 대안입니다. **SerpCrypto**는 US$0.30/1K 검색부터 전체 Google 검색 결과 페이지를 JSON으로 반환하며, Custom Search의 1,000쿼리당 $5(2026년 10월)와 비교됩니다. KYC 없이, 암호화폐로 결제하세요.

## Google Custom Search JSON API: 2026년 10월 22일 기준 상태

| 속성 | 값 |
| --- | --- |
| 신규 고객 | 닫힘: "The Custom Search JSON API is closed to new customers" |
| 서비스 종료 | 기존 고객은 2027년 1월 1일 |
| 가격 | 하루 100쿼리 무료, 이후 1,000쿼리당 $5, 하루 최대 10,000쿼리 |
| 요청당 결과 수 | 최대 10개 |
| "Search the entire web" | 2026년 1월 20일부터 신규 Programmable Search Engine에서는 사용할 수 없으며, 기존 엔진은 2027년 1월 1일까지 유지됩니다 |
| Google이 제안하는 대안 | Vertex AI Search, 최대 50개 도메인 검색용 |
| Google의 전체 웹 API | Web Search Service API: 파트너 전용, 공개 가격 없음 |

## Google은 정확히 무엇을, 언제 바꾸나요?

Google은 개발자 검색 제품을 사이트 검색과 엔터프라이즈 검색으로 좁히고 있습니다. 이 변경은 2026년 1월 20일 Programmable Search Engine 블로그에서 발표되었습니다.

- **2026년 1월 20일:** 새 Programmable Search Engine은 최대 50개 도메인의 사이트 목록만 검색할 수 있습니다. "Search the entire web" 옵션은 더 이상 새 엔진에 제공되지 않습니다.
- **현재:** Custom Search JSON API는 신규 고객을 받지 않습니다. 기존 고객은 하루 100쿼리 무료와 이후 1,000쿼리당 $5를 하루 최대 10,000쿼리까지 유지합니다.
- **2027년 1월 1일:** Custom Search JSON API가 모든 사용자에게 중단되고, 기존 엔진도 "Search the entire web"을 잃습니다. Google 고객센터 페이지에 따르면 이 옵션이 꺼지면 다시 켤 수 없습니다.

제품에서 지금 Custom Search 요청을 보내고 있다면, 이 페이지 기준으로 약 열 주의 시간이 남아 있습니다.

## 어떤 대안이 어떤 요구에 맞나요?

올바른 선택은 한 가지 질문에 달려 있습니다. 직접 관리하는 몇 개 사이트를 검색하는가, 아니면 Google이 보여주는 전체 웹을 검색하는가?

| 옵션 | 사용 가능 대상 | 웹 전체 검색 | 공개 가격 | 상태 |
| --- | --- | --- | --- | --- |
| SerpCrypto SERP API | 암호화폐만 있으면 누구나, KYC 없이 | 예: 구글 검색 결과 페이지를 JSON으로 | 10,000건에 US$7.50, 최저 US$0.30/1K 검색부터 | 이용 가능 |
| Custom Search JSON API | 기존 고객 전용 | 기존 "웹 전체" 엔진 전용 | 하루 100회 무료 이후 1,000회당 $5 | 2027년 1월 1일 종료 |
| Programmable Search Engine, 신규 엔진 | 누구나 | 아니요: 최대 50개 도메인 | — | 검색할 사이트만 |
| Vertex AI Search | Google Cloud 고객 | 아니요: Google은 최대 50개 도메인에 권장 | Google Cloud 가격 | 이용 가능 |
| Web Search Service API | Google 파트너, 파트너 클라이언트 ID 필요 | 예 | 공개되지 않음 | 파트너 전용 |

*가격 확인 날짜: 2026년 10월 22일.*

출처는 페이지 하단에 있습니다. "—" = 해당 없음 또는 공개되지 않음.

## Custom Search 파라미터는 SerpCrypto API에 어떻게 매핑되나요?

대부분의 파라미터는 직접 대응되며, 두 개는 사라집니다. 설정할 엔진이 없고 모든 요청이 구글 전체를 검색하므로 `cx`은 더 이상 필요하지 않습니다. API 키는 `key` 파라미터에서 `Authorization` 헤더로 옮겨가며, 쿼리 스트링을 선호한다면 `api_key`로 옮겨갑니다.

| Custom Search JSON API | SerpCrypto | 비고 |
|---|---|---|
| `q` | `q` | `site:` 같은 연산자를 포함한 동일한 검색 쿼리 문법 |
| `key` | `Authorization: Bearer …` 또는 `api_key` | |
| `cx` | — | 필요 없음: 웹 전체 검색 결과 |
| `num` (1–10) | — | Google은 페이지당 약 10개의 유기적 검색 결과를 반환 |
| `start` (1, 11, 21…) | `page` (1, 2, 3…) | `page = (start - 1) / 10 + 1`; Custom Search는 100번째 결과에서 멈추며, `page=10`도 마찬가지 |
| `gl` | `gl` | 두 글자 국가 코드 |
| `hl`, `lr` | `hl` | 인터페이스 언어 |
| `safe` | `safe` | `active` 또는 `off` |
| `siteSearch` | `q` 내부의 `site:example.com` | |
| `dateRestrict` (`d7`, `m1`…) | `period` (`h`, `d`, `w`, `m`, `y`) | 더 굵은 단위 |

응답 측에서는 `items[]`이 `organic_results[]`이 되고, `title`, `link`, `snippet`는 이름을 유지합니다. `displayLink`은 `displayed_link`이 됩니다. Custom Search가 절대 반환하지 않던 블록도 제공됩니다: 광고, People Also Ask, AI Overview, 로컬 팩, 주요 뉴스입니다.

*Python: 동일한 검색, 전과 후*

```python
import os

import requests

# Before: Custom Search JSON API (ends 1 January 2027)
# requests.get("https://www.googleapis.com/customsearch/v1",
#              params={"key": KEY, "cx": CX, "q": "solar inverter", "gl": "de", "start": 11})

# After: SerpCrypto
resp = requests.get(
    "https://serpcrypto.com/api/v1/search",
    headers={"Authorization": "Bearer " + os.environ["SERPCRYPTO_API_KEY"]},
    params={"q": "solar inverter", "gl": "de", "hl": "de", "page": 2},
    timeout=60,
)
resp.raise_for_status()
for item in resp.json().get("organic_results", []):
    print(item["position"], item["title"], item["link"], item.get("snippet", ""))

```

## 이전하면 Custom Search 대비 비용이 얼마나 드나요?

Custom Search는 매일 처음 100회 이후 1,000번의 검색 쿼리당 $5를 청구하며, 하루 상한은 10,000번의 검색 쿼리입니다. SerpCrypto은 성공한 검색당 1 크레딧을 청구합니다: 2026년 10월 기준 검색 10,000회 팩에서 US$0.75/1K 검색, 검색 100,000회에서 US$0.56/1K 검색, 1,000,000회 검색에서 US$0.38/1K 검색입니다.

하루에 3,000번의 검색 쿼리를 보내는 앱을 가정해 봅시다. Custom Search에서는 그중 2,900번에 비용을 지불하며, 하루 약 $14.50, 한 달 $435입니다. 동일한 월 90,000번의 검색은 US$56.25에 검색 100,000회 팩에 들어갑니다. 검색은 일일 할당량이 아니라 동시 실행 수로 제한되며, 사용하지 않은 크레딧은 만료되지 않습니다.

## 무엇을 잃고 무엇을 얻나요?

계약에서 Google 브랜드를 잃고 하루 100번의 무료 검색 쿼리를 잃습니다. SerpCrypto에는 무료 티어가 없습니다: 가장 작은 팩은 US$7.50에 검색 10,000회이며, US$25 충전으로 결제합니다.

사람들이 실제로 보는 페이지를 얻습니다. Google 자체 도움말 페이지에 따르면 Programmable Search Engine은 Google 색인의 일부만 사용하며 Oneboxes나 실시간 결과 같은 Google.com의 기능이 부족합니다. 해당 API는 AI Overview나 지도 팩도 반환한 적이 없습니다. SERP API를 사용하면 모든 요청에서 국가, 언어, 도시, 기기 타겟팅도 제공되며, 동일한 키로 Google News, Images, Maps, Shopping과 Bing을 모두 커버합니다.

## 어떤 팩이 제 Custom Search 사용량을 대체하나요?

일일 Custom Search 검색 쿼리에 30을 곱하세요. 하루 300회 미만이면 검색 10,000회이 한 달 이상 유지되며, 하루 3,000회라면 검색 100,000회이 한 달을 커버합니다. 크레딧은 만료되지 않습니다.

| 요금제 | 수량 | 가격 | 단가 |
| --- | --- | --- | --- |
| 테스트 | 검색 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분

## Custom Search API 종료: 자주 묻는 질문

### Google Custom Search JSON API가 종료되나요?

예. Google 개발자 페이지에 따르면 이 API는 신규 고객에게 폐쇄되었으며 기존 고객은 2027년 1월 1일까지 다른 솔루션으로 이전해야 합니다. 그 날짜 이후에는 모든 사람의 요청이 작동하지 않습니다.

### 웹 전체를 검색하는 Programmable Search Engine을 여전히 만들 수 있나요?

아니요. 2026년 1월 20일부터 신규 엔진은 최대 50개 도메인 목록만 검색할 수 있습니다. 이미 "Search the entire web"이 활성화된 엔진은 2027년 1월 1일까지 유지되며, 끄면 되돌릴 수 없습니다.

### 웹 전체 검색 결과를 위한 공식 Google API가 있나요?

파트너 전용입니다. Google은 2026년 9월에 Web Search Service API를 문서화했지만, 파트너 클라이언트 ID가 필요하고 공개 가격이 없습니다. 그 외의 경우에는 SerpCrypto 같은 SERP API가 실용적인 선택입니다.

### 사이트 제한 검색도 SerpCrypto에서 그대로 작동하나요?

네. 검색 쿼리에 `site:` 연산자를 넣으면 됩니다. 예를 들어 `q=return policy site:example.com`처럼요. 해당 사이트에 대해 Google의 공개 검색 결과를 검색하며, 사이트 제한 엔진이 하던 것과 비슷합니다.

### Google Cloud 결제 계정이나 카드 없이 결제할 수 있나요?

네. SerpCrypto은 BTC, USDT, USDC, ETH, SOL, LTC로 결제하는 선불 크레딧으로 작동하며, US$25부터 충전할 수 있습니다. 신분증도, 셀피도, 회사 서류도 요구하지 않습니다.

## 출처

1. [Custom Search JSON API: 개요](https://developers.google.com/custom-search/v1/overview) — Google for Developers (read 2026-10-22)
2. [Programmable Search Engine: 전체 웹 검색](https://support.google.com/programmable-search/answer/12397162?hl=en) — Google Help (read 2026-10-22)
3. [Programmable Search Engine vs Google.com](https://support.google.com/programmable-search/answer/70392) — Google Help (read 2026-10-22)
4. [Custom Search JSON API: 검색 응답 레퍼런스](https://developers.google.com/custom-search/v1/reference/rest/v1/Search) — Google for Developers (read 2026-10-22)
5. [Web Search Products 및 Programmable Search Engine 기능 업데이트](https://programmablesearchengine.googleblog.com/2026/01/updates-to-our-web-search-products.html) — Programmable Search Engine blog (2026-01-20)
6. [Custom Search JSON API: cse.list 레퍼런스](https://developers.google.com/custom-search/v1/reference/rest/v1/cse/list) — Google for Developers (read 2026-10-22)
7. [Google, 전체 웹 검색 결과용 파트너 전용 API 문서화](https://www.searchenginejournal.com/google-documents-partner-only-api-for-full-web-search-results/) — Search Engine Journal (2026-09-11)

---

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