API Google Events

Récupérez des données d’événements structurées depuis Google Events. Définissez engine=google_events et transmettez une phrase de recherche comme “Events in Paris” pour obtenir une liste organisée des événements à venir dans la zone spécifiée.

Endpoint

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

Paramètres

Paramètre	Type	Requis	Description
api_key	string	oui	Votre clé API SERP
engine	string	oui	Doit être google_events
q	string	oui	La requête de recherche d’événements
device	string	non	desktop, mobile, ou tablet
google_domain	string	non	Domaine Google à utiliser
location	string	non	Nom de l’emplacement de géociblage
uule	string	non	Chaîne d’emplacement encodée par Google
hl	string	non	Code de langue de l’interface
gl	string	non	Code du pays

Exemple de requête

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

Exemple de réponse

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

Voir aussi

• Présentation de Google SERP
• Structure de la réponse
• API Google Search