Google Maps API

Google Maps에서 비즈니스 및 위치 데이터를 추출합니다. engine=google_maps를 설정하고, 키워드 목록 검색에는 type=search를, 단일 장소의 전체 프로필을 조회하려면 type=place를 사용하세요.

엔드포인트

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

매개변수

매개변수	유형	필수	설명
`api_key`	string	예	사용자의 SERP API 키
`engine`	string	예	반드시 `google_maps`여야 함
`q`	string	예	검색할 키워드
`type`	string	예	`search` 또는 `place`
`data`	string	아니요	`type=place`일 때 필수. 형식: `!4m5!3m4!1s` + `data_id` + `!8m2!3d` + `latitude` + `!4d` + `longitude`
`device`	string	아니요	`desktop`, `mobile`, 또는 `tablet`
`google_domain`	string	아니요	사용할 Google 도메인
`hl`	string	아니요	인터페이스 언어 코드
`ll`	string	아니요	GPS 좌표, 형식 `@latitude,longitude,zoom`

요청 예시

curl "https://serp.shifter.io/v1?engine=google_maps&api_key=YOUR_API_KEY&q=pizza&type=search"

import requests

params = {
    "engine": "google_maps",
    "api_key": "YOUR_API_KEY",
    "q": "pizza",
    "type": "search",
}
r = requests.get("https://serp.shifter.io/v1", params=params)
data = r.json()

import fetch from 'node-fetch';

const url = 'https://serp.shifter.io/v1?' + new URLSearchParams({
  engine: 'google_maps',
  api_key: 'YOUR_API_KEY',
  q: 'pizza',
  type: 'search',
});
const data = await (await fetch(url)).json();

응답 예시

{
  "search_parameters": {
    "engine": "google_maps",
    "q": "pizza",
    "type": "search",
    "google_domain": "google.com"
  },
  "places_results": [
    {
      "position": 1,
      "title": "Joe's Pizza",
      "place_id": "ChIJ...",
      "data_id": "0x89c25994a1b6e4a3:0x...",
      "gps_coordinates": { "latitude": 40.730, "longitude": -73.998 },
      "rating": 4.5,
      "reviews": 2431,
      "type": "Pizza restaurant",
      "address": "7 Carmine St, New York, NY 10014",
      "phone": "(212) 366-1182",
      "website": "https://www.joespizzanyc.com/"
    }
  ]
}

Google Maps API

엔드포인트

매개변수

요청 예시

응답 예시

참고 항목