테스트
검색 10,000회
US$7.50
US$0.75/1K 검색
- 실제 검색 쿼리로 모든 엔진을 사용해 보세요
- 가장 큰 팩과 동일한 API
- 크레딧은 만료되지 않음
마이그레이션 가이드 · 사실 확인일 2026년 10월 22일
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 없이, 암호화폐로 결제하세요.
| 신규 고객 | 닫힘: "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은 개발자 검색 제품을 사이트 검색과 엔터프라이즈 검색으로 좁히고 있습니다. 이 변경은 2026년 1월 20일 Programmable Search Engine 블로그에서 발표되었습니다.
제품에서 지금 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 필요 | 예 | 공개되지 않음 | 파트너 전용 |
가격 확인 날짜:
출처는 페이지 하단에 있습니다. "—" = 해당 없음 또는 공개되지 않음.
대부분의 파라미터는 직접 대응되며, 두 개는 사라집니다. 설정할 엔진이 없고 모든 요청이 구글 전체를 검색하므로 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, 로컬 팩, 주요 뉴스입니다.
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는 매일 처음 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 검색 쿼리에 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개 · 실패한 요청은 과금되지 않음 · 크레딧은 만료되지 않음 · 국가, 언어, 도시 및 디바이스 타겟팅
예. Google 개발자 페이지에 따르면 이 API는 신규 고객에게 폐쇄되었으며 기존 고객은 2027년 1월 1일까지 다른 솔루션으로 이전해야 합니다. 그 날짜 이후에는 모든 사람의 요청이 작동하지 않습니다.
아니요. 2026년 1월 20일부터 신규 엔진은 최대 50개 도메인 목록만 검색할 수 있습니다. 이미 "Search the entire web"이 활성화된 엔진은 2027년 1월 1일까지 유지되며, 끄면 되돌릴 수 없습니다.
파트너 전용입니다. Google은 2026년 9월에 Web Search Service API를 문서화했지만, 파트너 클라이언트 ID가 필요하고 공개 가격이 없습니다. 그 외의 경우에는 SerpCrypto 같은 SERP API가 실용적인 선택입니다.
네. 검색 쿼리에 site: 연산자를 넣으면 됩니다. 예를 들어 q=return policy site:example.com처럼요. 해당 사이트에 대해 Google의 공개 검색 결과를 검색하며, 사이트 제한 엔진이 하던 것과 비슷합니다.
네. SerpCrypto은 BTC, USDT, USDC, ETH, SOL, LTC로 결제하는 선불 크레딧으로 작동하며, US$25부터 충전할 수 있습니다. 신분증도, 셀피도, 회사 서류도 요구하지 않습니다.
US$0.30/1K 검색부터 · KYC 없이
API 키 발급