Logo SearchApi

Google Events API Documentation

Google Events API uses the /api/v1/search?engine=google_events endpoint to retrieve detailed events information.

This includes data on event date, venue information, address locations, ticket purchasing options, description of event, and more. The API also provides rich metadata that includes venue ratings, reviews, thumbnail images, and interactive location maps.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    Parameter defines the query you want to search.

Geographic Location

  • Name
    location
    Required
    Optional
    Description

    Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. Head to the Locations API if you need more precise control.

  • Name
    uule
    Required
    Optional
    Description

    Parameter is the Google encoded location you want to use for the search. SearchApi automatically generated the uule parameter when you use the location parameter but we allow you to overwrite it directly. uule and location parameters can't be used together.

Localization

  • Name
    google_domain
    Required
    Optional
    Description

    The default parameter google.com defines the Google domain of the search. Check the full list of supported Google google_domain domains.

  • Name
    gl
    Required
    Optional
    Description

    The default parameter us defines the country of the search. Check the full list of supported Google gl countries.

  • Name
    hl
    Required
    Optional
    Description

    The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages. Note, the Google Events API may not return results if the value of the hl parameter does not align with the gl parameter. For example - gl=us&hl=de

Pagination

  • Name
    page
    Required
    Optional
    Description

    This parameter indicates which page of results to return. By default, it is set to 1.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to google_events.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

API Examples

Search

Search
GET
https://www.searchapi.org/api/v1/search?engine=google_events&q=Tech+meetup
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "google_events",
  "q": "Tech meetup"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_MJjKW8mR3ZGJsqLpn9redbvB",
    "status": "Success",
    "created_at": "2025-05-23T10:40:22Z",
    "request_time_taken": 1.82,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.83,
    "request_url": "https://www.google.com/search?q=tech+meetup&oq=tech+meetup&ibp=htl;events&ie=UTF-8",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_MJjKW8mR3ZGJsqLpn9redbvB.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_MJjKW8mR3ZGJsqLpn9redbvB"
  },
  "search_parameters": {
    "engine": "google_events",
    "q": "tech meetup",
    "google_domain": "google.com"
  },
  "events": [
    {
      "position": 1,
      "title": "Vancouver Tech Community Coffee Meetup",
      "link": "https://lu.ma/0hebsrvk",
      "date": {
        "day": "31",
        "month": "May"
      },
      "duration": "Sat, May 31, 9:00–11:00 a.m.",
      "address": "Deville Coffee - The Post",
      "location": "366 Dunsmuir St, Vancouver, BC",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQevVjicYR7ZIZnsuxGMoIM7g8LCX_QXiaqW7LhkzxvKA&s=10",
      "description": "The anchoring topic for this month's event is TBD. Join us for an informal and welcoming coffee chat where cyber security professionals from all backgrounds can connect, share experiences, and...",
      "venue": {
        "name": "Deville Coffee - The Post",
        "rating": 4.0,
        "reviews": "33 reviews",
        "link": "https://www.google.com/search?sca_esv=495b9ab80c09e44b&q=Deville+Coffee+-+The+Post&ludocid=8190781487015018395&ibp=gwp%3B0,7"
      },
      "offers": [
        {
          "seller": "Eventbrite.ca",
          "link": "https://www.eventbrite.ca/e/vancouver-tech-community-coffee-meetup-tickets-1141668504229",
          "link_type": "tickets"
        },
        {
          "seller": "Luma",
          "link": "https://lu.ma/0hebsrvk",
          "link_type": "more info"
        }
      ],
      "event_location_map": {
        "image": "https://www.google.com/maps/vt/data=eaSOyIu8I23mk8ZfFd93rp_KWryy1qDwWO4s01b6r-Y56YCEbpGTrS6jFPu5GqZiyUWD6ccOgjoMs_IA8P0yjfeUKxda8hG94m0x3XPkHbdMgEPJVJg",
        "link": "https://www.google.com/maps/place//data=!4m2!3m1!1s0x54867170a02e6dc9:0x71ab805da6603f9b?sa=X&ved=2ahUKEwiq27LOs7mNAxUhADQIHWI2JY4Q9eIBegQIAhAA"
      }
    },
    ...
  ]
}