Google

모든 Google 엔진은 동일한 엔드포인트를 공유하며, engine 파라미터를 바꾸어 반환되는 결과를 변경합니다.

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

Engines

`engine`	Returns	Key params
`google`	Organic SERP, ads, snippets, PAA, knowledge graph	`q`, `location`, `gl`, `hl`, `device`
`google_autocomplete`	Suggestions for a partial query	`q`
`google_images`	Image SERP	`q`, `location`
`google_maps`	Maps businesses, reviews, photos	`q`, `type=search\|place\|review`, `ll`
`google_maps_reviews`	All reviews for a place	`data_id`
`google_maps_photos`	All photos for a place	`data_id`
`google_news`	News SERP with dates and sources	`q`, `gl`, `hl`
`google_shopping`	Product listings with prices	`q`, `location`
`google_product`	Single product detail page	`product_id`
`google_jobs`	Job listings	`q`, `location`
`google_jobs_listing`	Full detail of one job	`q` (base64 job id)
`google_trends`	Interest-over-time data	`q`, `geo`, `date`
`google_scholar`	Academic paper results	`q`
`google_scholar_author`	Author profile and papers	`author_id`
`google_scholar_cite`	Formatted citations for one paper	`q` (citation id)
`google_scholar_profiles`	Author discovery by name	`mauthors`
`google_events`	Local events	`q`, `location`
`google_play`	Play Store apps, books, movies	`type`, `store`, `product_id`
`google_finance`	Stock and market data	`q`
`google_reverse_image`	Pages that host an image	`image_url`
`google_local_services`	Local services listings	`q`, `location`

Parameter	Purpose
`q`	The search query
`location`	Free-form location string (e.g. `"New York, NY"`)
`gl`	Country code (e.g. `us`, `de`)
`hl`	Interface language (e.g. `en`, `es`)
`device`	`desktop` or `mobile`
`start`	Result offset for pagination
`num`	Results per page

각 엔진에 대한 전체 파라미터 참조는 REST API → Google SERP 섹션에 있습니다.

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=best+pizza&location=Chicago%2C+Illinois&device=mobile"

curl "https://serp.shifter.io/v1?engine=google_maps&api_key=YOUR_API_KEY&q=pizza&type=search&ll=@41.8781,-87.6298,14z"

curl "https://serp.shifter.io/v1?engine=google_jobs&api_key=YOUR_API_KEY&q=software+engineer&location=Austin%2C+Texas"