Google Events API

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

Endpoint

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

Parameters

Parameter	Type	Required	Description
api_key	string	yes	Your SERP API key
engine	string	yes	Must be google_events
q	string	yes	The event search query
device	string	no	desktop, mobile, or tablet
google_domain	string	no	Google domain to use
location	string	no	Geotargeting location name
uule	string	no	Google encoded location string
hl	string	no	Interface language code
gl	string	no	Country code

Example request

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();

Example response

{
  "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://..."
    }
  ]
}

See also

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