API de Eventos do Google
Recupere dados estruturados de eventos do Google Events. Defina engine=google_events e passe uma frase de busca como “Events in Paris” para obter uma lista selecionada de próximos eventos na área especificada.
Endpoint
Seção intitulada “Endpoint” GET https://serp.shifter.io/v1?engine=google_events&api_key=YOUR_API_KEY
Parâmetros
Seção intitulada “Parâmetros”| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
api_key | string | sim | Sua chave de API SERP |
engine | string | sim | Deve ser google_events |
q | string | sim | A consulta de busca do evento |
device | string | não | desktop, mobile, ou tablet |
google_domain | string | não | Domínio do Google a ser usado |
location | string | não | Nome do local de geotargeting |
uule | string | não | String de localização codificada do Google |
hl | string | não | Código do idioma da interface |
gl | string | não | Código do país |
Exemplo de requisição
Seção intitulada “Exemplo de requisição”curl "https://serp.shifter.io/v1?engine=google_events&api_key=YOUR_API_KEY&q=Events%20in%20Paris%2C%20France"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()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();Exemplo de resposta
Seção intitulada “Exemplo de resposta”{ "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://..." } ]}