Google은 Custom Search JSON API의 새 가입을 닫았고 기존 고객에게도 2027년 1월 1일에 종료합니다. google.com 자연 검색 결과, 광고, 결과 페이지 패널을 API 호출 한 번에 JSON으로 받고, cse.list 필드를 옮기고, 검색 1,000번 비용을 비교합니다.
Custom Search JSON API에서 바뀌는 것
Custom Search JSON API는 Programmable Search Engine의 웹과 이미지 검색 결과를 JSON으로 돌려줍니다. Google은 새 고객 가입을 닫았고, 기존 고객은 2027년 1월 1일까지 다른 방식으로 옮겨야 합니다. 그날까지 기존 고객은 하루 100건을 무료로 쓰고, 그 위로는 1,000건에 $5를 내며 하루 10,000건까지 씁니다. 출처: Custom Search JSON API 개요.
API 뒤의 검색 엔진도 바뀌었습니다. 2026년 1월 20일부터 새 Programmable Search Engine은 도메인 50개까지의 목록만 검색하고, 이미 웹 전체 검색으로 설정한 엔진은 2027년 1월 1일까지 그 설정을 유지합니다. 출처: 검색 엔진의 사이트 업데이트.
Google은 도메인 50개까지의 검색에는 Vertex AI Search를, 웹 전체 검색에는 문의 양식을 안내합니다. 순위 추적, 링크 발견, 연구용 데이터셋에는 검색어마다 google.com 결과 페이지 전체를 구조화된 데이터로, 정해진 검색당 가격으로 받는 길이 필요합니다.
GOOGLE_SERP로 google.com 결과를 JSON으로 받기
GOOGLE_SERP는 query, ISO 3166-1 alpha-2 코드의 country(기본 US), 화면 언어 hl, 1부터 10까지의 page를 받습니다. 한 페이지에 자연 검색 결과 10개가 있어 10페이지면 100번째 결과까지 닿고, 이는 Custom Search JSON API가 허용하는 깊이와 같습니다. 작업 하나는 0.3크레딧입니다. 문서: Google 검색.
curl -X POST https://api.querying.ai/v1/async/task \
-H "Authorization: Bearer $QUERYING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"taskType": "GOOGLE_SERP",
"payload": { "query": "best project management software", "country": "US", "hl": "en", "page": 1 }
}'보내기 호출은 바로 작업 id를 돌려줍니다. 상태가 COMPLETED가 될 때까지 id로 읽거나, 웹훅 URL을 넘겨 결과가 나오면 받습니다. 결과는 작업이 끝난 뒤 24시간 동안 읽히니 받는 대로 저장합니다. 폴링, 웹훅, 상태: 비동기 작업.
curl https://api.querying.ai/v1/async/task/8f2c1e40-... \
-H "Authorization: Bearer $QUERYING_API_KEY"완료된 작업은 결과 페이지를 한 가지 모양으로 담습니다.
{
"organicResults": [
{ "position": 1, "title": "...", "link": "https://...", "displayedLink": "...", "snippet": "...", "page": 1 }
],
"peopleAlsoAsk": [{ "...": "..." }],
"relatedSearches": [{ "...": "..." }],
"ads": [{ "position": 1, "blockPosition": "...", "title": "...", "link": "https://..." }],
"page": 1
}| 필드 | 담긴 것 |
|---|---|
| organicResults | 자연 검색 결과: position, title, link, displayedLink, snippet, page. 늘 있음 |
| page | 불러온 결과 페이지, 1부터 10 |
| ads | 위아래 텍스트 광고와 스폰서 쇼핑 카드. 페이지에 있을 때 |
| peopleAlsoAsk, relatedSearches | Google의 관련 질문과 관련 검색어 패널. 페이지에 있을 때 |
| map | 지역 묶음의 name, position, placeId, mapsUrl. 페이지에 있을 때 |
| videos, shoppingCards, knowledgeGraph | 동영상 카드, 상품 묶음, 지식 패널. 페이지에 있을 때 |
| rawContent | include.rawResponse가 true일 때 결과 페이지 HTML |
cse.list 파라미터와 필드 옮기기
Custom Search 코드는 대개 cse.list를 부르고 Search 응답의 items를 읽습니다. 아래 표는 파라미터와 필드마다 GOOGLE_SERP 작업에서 같은 값을 담는 것을 짝지었습니다.
| cse.list 파라미터나 필드 | GOOGLE_SERP | 메모 |
|---|---|---|
| q | payload.query | 100,000자까지 |
| gl | payload.country | ISO 3166-1 alpha-2, 기본 US |
| hl | payload.hl | Google 화면 언어 |
| start, num | payload.page | 페이지당 자연 검색 결과 10개, 1부터 10페이지 |
| cx | (필요 없음) | 결과는 google.com에서 옴 |
| items[].title | organicResults[].title | 같은 값 |
| items[].link | organicResults[].link | 같은 값 |
| items[].snippet | organicResults[].snippet | 같은 값 |
| items[].formattedUrl | organicResults[].displayedLink | Google이 결과에 보여 주는 URL 줄 |
| (start에 순서를 더한 값) | organicResults[].position | 페이지를 이어서 셈, 2페이지는 11부터 |
| (cse.list에 없음) | ads, peopleAlsoAsk, map | 결과 페이지의 패널 |
패널은 검색 작업에 쓸모가 큽니다. 광고는 그 검색어에 누가 돈을 쓰는지, peopleAlsoAsk는 Google이 그 검색어와 묶는 질문을, map은 장소마다 placeId가 붙은 지역 묶음을 보여 줍니다.
검색 1,000번 비용
| 선택지 | 1,000번당 | Custom Search 비용 대비 | 받는 것 |
|---|---|---|---|
| Custom Search JSON API, 기존 고객, 2027년 1월 1일까지 | $5.00 | 1.0x | 내 Programmable Search Engine 결과 최대 10개 |
| querying.ai Basic, $20 / 8,000크레딧 | $0.75 | 6.7x | 광고와 패널이 담긴 google.com 결과 페이지 한 장 |
| querying.ai Pro, $200 / 170,000크레딧 | $0.35 | 14.2x | 광고와 패널이 담긴 google.com 결과 페이지 한 장 |
| querying.ai Scale, $500 / 480,000크레딧 | $0.31 | 16.0x | 광고와 패널이 담긴 google.com 결과 페이지 한 장 |
| querying.ai Max, $1,000 / 1,000,000크레딧 | $0.30 | 16.7x | 광고와 패널이 담긴 google.com 결과 페이지 한 장 |
querying.ai 가격은 플랜 월 요금을 크레딧 수로 나눈 값입니다. 새 계정은 무료 500크레딧으로 시작하고, 이는 Google 검색 1,666번이라 플랜을 고르기 전에 옮긴 코드를 시험해 볼 만합니다.
미리 알아 둘 한계
GOOGLE_SERP는 웹 결과를 돌려줍니다. 이미지 검색과 cse.list의siteSearch,dateRestrict,fileType필터에 맞는 payload 필드는 없습니다.device가mobile이나android일 때page를 2 이상으로 보내면422 VALIDATION_ERROR입니다. 모바일 페이지에는 페이지 링크가 없습니다.- 완료된 작업의
organicResults가 비어 있으면 Google이 그 검색어에 결과를 보여 주지 않았다는 뜻이고, 돌려주기 전에 다른 브라우저로 한 번 더 확인합니다. - 1부터 10 밖의
page는422 VALIDATION_ERROR이고, 실패한 작업은 0크레딧입니다.
자주 묻는 질문
Google Custom Search JSON API는 언제 종료되나요?
기존 고객은 2027년 1월 1일까지 다른 방식으로 옮겨야 합니다. 새 고객 가입은 이미 닫혔습니다.
지금 Google은 검색 결과에 무엇을 권하나요?
도메인 50개까지의 검색에는 Vertex AI Search를, 웹 전체 검색이 필요한 팀에는 문의 양식을 안내합니다.
Google 검색 결과를 JSON으로 받으려면 어떻게 하나요?
검색어와 나라를 담은 GOOGLE_SERP 작업을 POST /v1/async/task로 보내고, id로 읽거나 웹훅으로 받습니다. 결과에는 organicResults와 페이지에 보인 패널이 들어 있습니다.
querying.ai에서 Google 검색 한 번은 얼마인가요?
0.3크레딧입니다. 검색 1,000번에 Basic $0.75, Max $0.30입니다.
검색어 하나로 결과를 몇 개까지 받나요?
페이지당 자연 검색 결과 10개, 1부터 10페이지라서 0.3크레딧 작업 10개로 100개까지 받습니다.
같은 페이지의 AI Overview도 받을 수 있나요?
GOOGLE 엔진을 쓰면 1.25크레딧에 같은 결과 페이지와 AI Overview, 그 요약이 인용한 페이지를 받습니다. Google AI Overviews를 보세요.
바로 활용하기
- Google SERP API: 검색 결과를 JSON으로
google.com의 자연 검색 결과, 광고, 관련 질문, 로컬 팩과 그 밖의 패널을 검색 한 번에 0.3크레딧으로 JSON으로 받습니다. 검색 1,000번에 Basic $0.75, Max $0.30입니다. 국가, 미국 주, 정확한 위치를 지정하고 데스크톱과 모바일, 1~10페이지를 읽습니다.
- SERP API: 검색 결과와 쇼핑몰 상품을 JSON으로
Google, Bing, 네이버 검색 결과와 Google 장소 탭의 한 도시 장소 최대 100곳, Google 뉴스 탭의 기사, Amazon, 쿠팡, 올리브영 등 쇼핑몰 21곳의 상품 검색과 상품 페이지를 같은 비동기 API에서 JSON으로 받습니다.


