Google Events API

Google Events에서 구조화된 이벤트 데이터를 가져옵니다. engine=google_events를 설정하고 “Events in Paris”와 같은 검색 문구를 전달하면 지정한 지역의 예정된 이벤트 목록을 확인할 수 있습니다.

엔드포인트

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

매개변수

매개변수	유형	필수	설명
api_key	string	예	SERP API 키
engine	string	예	google_events이어야 합니다
q	string	예	이벤트 검색 쿼리
device	string	아니요	desktop, mobile, or tablet
google_domain	string	아니요	사용할 Google 도메인
location	string	아니요	지오타겟팅 위치 이름
uule	string	아니요	Google로 인코딩된 위치 문자열
hl	string	아니요	인터페이스 언어 코드
gl	string	아니요	국가 코드

요청 예시

curl

curl "https://serp.shifter.io/v1?engine=google_events&api_key=YOUR_API_KEY&q=Events%20in%20Paris%2C%20France"

Python

import requests

params = {
    "engine": "google_events",
    "api_key": "YOUR_API_KEY",
    "q": "Events in Paris, France",
}
r = requests.get("https://serp.shifter.io/v1", params=params)
data = r.json()

Node.js

import fetch from 'node-fetch';

const url = 'https://serp.shifter.io/v1?' + new URLSearchParams({
  engine: 'google_events',
  api_key: 'YOUR_API_KEY',
  q: 'Events in Paris, France',
});
const data = await (await fetch(url)).json();

응답 예시

{
  "search_metadata": { "status": "Success" },
  "search_parameters": {
    "engine": "google_events",
    "q": "Events in Paris, France",
    "google_domain": "google.com"
  },
  "events_results": [
    {
      "title": "Paris Fashion Week",
      "date": {
        "start_date": "Feb 27",
        "when": "Tue, Feb 27, 10:00 AM - Tue, Mar 5, 6:00 PM"
      },
      "address": ["Paris, France"],
      "link": "https://www.example.com/event/...",
      "venue": { "name": "Le Grand Palais", "rating": 4.6 },
      "thumbnail": "https://..."
    }
  ]
}

참고 항목

• Google SERP 개요
• 응답 형식
• Google Search API