Google Events API

Retrieve structured event data from Google Events. Set engine=google_events and pass a search phrase like “Events in Paris” to get a curated list of upcoming events in the specified area.

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 overview
• Response shape
• Google Search API