Google SERP API

모든 Google 화면은 엔드포인트 하나로 접근할 수 있습니다. engine 파라미터를 변경하여 Search, Maps, Jobs, Shopping, Trends, Scholar 등을 전환하세요.

Endpoint

GET https://serp.shifter.io/v1?engine=<engine>&api_key=YOUR_API_KEY

API 키를 api_key 쿼리 파라미터로 전달하세요. 키는 패널의 SERP API 항목에 있습니다.

이 파라미터들은 대부분의 Google 엔진에서 동작합니다. 각 엔진에는 고유한 파라미터도 있으며, 해당 페이지에 문서화되어 있습니다.

Parameter	Type	Required	Description
`api_key`	string	yes	SERP API 키
`engine`	string	yes	어떤 Google 화면을 사용할지 (아래 표 참고)
`q`	string	usually	검색 쿼리 (일부 photo/author 엔드포인트에는 필요하지 않음)
`location`	string	no	자유 형식 위치 (예: `"Chicago, Illinois"`)
`gl`	ISO code	no	국가 필터 (예: `us`, `de`)
`hl`	ISO code	no	인터페이스 언어 (예: `en`, `es`)
`device`	`desktop` \| `mobile` \| `tablet`	no	시뮬레이션할 디바이스
`start`	integer	no	페이지네이션 오프셋
`num`	integer	no	페이지당 결과 수

`engine`	반환하는 내용
`google`	광고, 스니펫, PAA, 지식 그래프가 포함된 오가닉 웹 SERP
`google_autocomplete`	부분 쿼리에 대한 추천어
`google_images`	이미지 SERP
`google_news`	날짜와 출처가 포함된 뉴스
`google_shopping`	제품 목록
`google_product`	단일 제품 상세 정보
`google_maps`	Maps의 장소, 리뷰, 사진
`google_maps_reviews`	장소의 모든 리뷰
`google_maps_photos`	장소의 모든 사진
`google_jobs`	채용 공고 목록
`google_jobs_listing`	단일 채용 공고 상세 정보
`google_trends`	시간 경과에 따른 관심도
`google_scholar`	학술 논문
`google_scholar_author`	저자 프로필
`google_scholar_cite`	형식화된 인용
`google_scholar_profiles`	저자 검색
`google_finance`	주식 및 시장 데이터
`google_events`	지역 이벤트
`google_play`	Play 스토어 앱, 도서, 영화
`google_reverse_image`	이미지를 호스팅하는 페이지
`google_local_services`	지역 서비스 제공업체

Google Search engine=google

Google Maps engine=google_maps

Google Maps Reviews engine=google_maps_reviews

Google Maps Photos engine=google_maps_photos

Google Product engine=google_product

Google Jobs engine=google_jobs

Google Jobs Listing engine=google_jobs_listing

Google Autocomplete engine=google_autocomplete

Google Trends engine=google_trends

Google Scholar engine=google_scholar

Google Scholar Author engine=google_scholar_author

Google Scholar Cite engine=google_scholar_cite

Google Scholar Profiles engine=google_scholar_profiles

Google Finance engine=google_finance

Google Events engine=google_events

Google Play engine=google_play

Google Reverse Image engine=google_reverse_image

Google Local Services engine=google_local_services