모든 Google 엔진은 동일한 엔드포인트를 공유하며, engine 파라미터를 바꾸어 반환되는 결과를 변경합니다.
https://serp.shifter.io/v1?engine=<engine>&api_key=YOUR_API_KEY&q=<query>Engines
섹션 제목: “Engines”engine | Returns | Key params |
|---|---|---|
google | 오가닉 SERP, 광고, 스니펫, PAA, 지식 그래프 | q, location, gl, hl, device |
google_autocomplete | 부분 검색어에 대한 추천어 | q |
google_images | 이미지 SERP | q, location |
google_maps | 지도 업체, 리뷰, 사진 | q, type=search|place|review, ll |
google_maps_reviews | 한 장소의 모든 리뷰 | data_id |
google_maps_photos | 한 장소의 모든 사진 | data_id |
google_news | 날짜와 출처가 포함된 뉴스 SERP | q, gl, hl |
google_shopping | Product listings with prices | q, location |
google_product | 단일 제품 상세 페이지 | product_id |
google_jobs | 채용 공고 목록 | q, location |
google_jobs_listing | 하나의 채용 공고 전체 상세 정보 | q (base64 job id) |
google_trends | 시간대별 관심도 데이터 | q, geo, date |
google_scholar | 학술 논문 검색 결과 | q |
google_scholar_author | 저자 프로필 및 논문 | author_id |
google_scholar_cite | 한 논문의 서식화된 인용 정보 | q (citation id) |
google_scholar_profiles | 이름으로 저자 찾기 | mauthors |
google_events | 지역 이벤트 | q, location |
google_play | Play Store 앱, 도서, 영화 | type, store, product_id |
google_finance | 주식 및 시장 데이터 | q |
google_reverse_image | 이미지를 호스팅하는 페이지 | image_url |
google_local_services | 지역 서비스 목록 | q, location |
공통 매개변수
섹션 제목: “공통 매개변수”| 매개변수 | 용도 |
|---|---|
q | 검색어 |
location | 자유 형식 위치 문자열 (예: "New York, NY") |
gl | 국가 코드 (예: us, de) |
hl | 인터페이스 언어 (예: en, es) |
device | desktop or mobile |
start | 페이지네이션을 위한 결과 오프셋 |
num | 페이지당 결과 수 |
각 엔진에 대한 전체 파라미터 참조는 REST API → Google SERP 섹션에 있습니다.
예제: 위치 기반 Google 검색
섹션 제목: “예제: 위치 기반 Google 검색”curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=best+pizza&location=Chicago%2C+Illinois&device=mobile"예제: Google Maps 검색
섹션 제목: “예제: Google Maps 검색”curl "https://serp.shifter.io/v1?engine=google_maps&api_key=YOUR_API_KEY&q=pizza&type=search&ll=@41.8781,-87.6298,14z"예제: Google Jobs
섹션 제목: “예제: Google Jobs”curl "https://serp.shifter.io/v1?engine=google_jobs&api_key=YOUR_API_KEY&q=software+engineer&location=Austin%2C+Texas"다음 단계
섹션 제목: “다음 단계”- Locations, 자유 형식
location문자열을 넘어서는 정밀한 지역 타겟팅입니다. - REST API → Google SERP, 모든 엔진에 대한 전체 파라미터 참조입니다.