Google Events API

Rufen Sie strukturierte Ereignisdaten von Google Events ab. Setzen Sie engine=google_events und übergeben Sie eine Suchphrase wie “Events in Paris”, um eine kuratierte Liste bevorstehender Veranstaltungen im angegebenen Gebiet zu erhalten.

Endpoint

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

Parameter

Parameter	Typ	Erforderlich	Beschreibung
api_key	string	ja	Ihr SERP-API-Schlüssel
engine	string	ja	Muss google_events sein
q	string	ja	Die Ereignis-Suchanfrage
device	string	nein	desktop, mobile, oder tablet
google_domain	string	nein	Zu verwendende Google-Domain
location	string	nein	Name des Geotargeting-Standorts
uule	string	nein	Google-kodierte Standortzeichenfolge
hl	string	nein	Sprachcode der Benutzeroberfläche
gl	string	nein	Ländercode

Beispielanfrage

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

Beispielantwort

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

Siehe auch

• Google SERP Überblick
• Antwortstruktur
• Google Search API