본문으로 건너뛰기
블로그7분 분량

Google Custom Search JSON API 대안: 2027년 1월 1일 종료 전에 google.com 검색 결과를 JSON으로 받기

가이드
Custom Search JSON API 필드를 querying.ai GOOGLE_SERP 필드에 짝지은 표와 검색 1,000번 비용, Custom Search JSON API $5와 querying.ai 플랜별 $0.75에서 $0.30를 함께 보여 주는 그림

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
}
GOOGLE_SERP 응답 필드, 2026년 11월
필드담긴 것
organicResults자연 검색 결과: position, title, link, displayedLink, snippet, page. 늘 있음
page불러온 결과 페이지, 1부터 10
ads위아래 텍스트 광고와 스폰서 쇼핑 카드. 페이지에 있을 때
peopleAlsoAsk, relatedSearchesGoogle의 관련 질문과 관련 검색어 패널. 페이지에 있을 때
map지역 묶음의 name, position, placeId, mapsUrl. 페이지에 있을 때
videos, shoppingCards, knowledgeGraph동영상 카드, 상품 묶음, 지식 패널. 페이지에 있을 때
rawContentinclude.rawResponse가 true일 때 결과 페이지 HTML

cse.list 파라미터와 필드 옮기기

Custom Search 코드는 대개 cse.list를 부르고 Search 응답의 items를 읽습니다. 아래 표는 파라미터와 필드마다 GOOGLE_SERP 작업에서 같은 값을 담는 것을 짝지었습니다.

Custom Search JSON API에서 GOOGLE_SERP로
cse.list 파라미터나 필드GOOGLE_SERP메모
qpayload.query100,000자까지
glpayload.countryISO 3166-1 alpha-2, 기본 US
hlpayload.hlGoogle 화면 언어
start, numpayload.page페이지당 자연 검색 결과 10개, 1부터 10페이지
cx(필요 없음)결과는 google.com에서 옴
items[].titleorganicResults[].title같은 값
items[].linkorganicResults[].link같은 값
items[].snippetorganicResults[].snippet같은 값
items[].formattedUrlorganicResults[].displayedLinkGoogle이 결과에 보여 주는 URL 줄
(start에 순서를 더한 값)organicResults[].position페이지를 이어서 셈, 2페이지는 11부터
(cse.list에 없음)ads, peopleAlsoAsk, map결과 페이지의 패널

패널은 검색 작업에 쓸모가 큽니다. 광고는 그 검색어에 누가 돈을 쓰는지, peopleAlsoAsk는 Google이 그 검색어와 묶는 질문을, map은 장소마다 placeId가 붙은 지역 묶음을 보여 줍니다.

검색 1,000번 비용

Google 검색 1,000번 비용, 2026년 11월 13일 공개 가격
선택지1,000번당Custom Search 비용 대비받는 것
Custom Search JSON API, 기존 고객, 2027년 1월 1일까지$5.001.0x내 Programmable Search Engine 결과 최대 10개
querying.ai Basic, $20 / 8,000크레딧$0.756.7x광고와 패널이 담긴 google.com 결과 페이지 한 장
querying.ai Pro, $200 / 170,000크레딧$0.3514.2x광고와 패널이 담긴 google.com 결과 페이지 한 장
querying.ai Scale, $500 / 480,000크레딧$0.3116.0x광고와 패널이 담긴 google.com 결과 페이지 한 장
querying.ai Max, $1,000 / 1,000,000크레딧$0.3016.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으로 받습니다.

무료로 시작하기

가입하면 500 크레딧을 드립니다. 몇 분 안에 첫 답변을 수집해 보세요.

무료로 시작하기

블로그의 다른 글