Logo SearchApi

Google Events API Documentation

GET   /api/v1/search?engine=google_events
OpenAPI Initiative Download OpenAPI Spec

Retrieve events information including the event title, date, start time, venue, address, category and thumbnail.

Breaking Changes (2026-08)

Google replaced its events results page, and the API response changed with it:

  • date is now a string like "Wed, Aug 26".
  • venue is now a string with the venue name, previously in location.
  • address holds a city or neighborhood, not a street address.
  • link points to the ticket seller, not Google.
  • offers → link, seller and price. event_location_map → map_image and venue_map_link.
  • Removed: location, description and duration.
  • New: entity_id, venue_entity_id, start_time, category, extracted_price and is_free.
  • page, chips and google_domain are rejected. All results come on a single page.
  • hl only accepts en. The new gl parameter targets a whole country.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    This parameter is used for the terms you want to search for events. Queries can include terms like "concerts tonight", "tech conferences in New York" or just "Events"

Geographic Location

  • Name
    location
    Required
    Optional
    Description

    This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. When the query itself names a place, Google resolves the geography from the query and this parameter has no effect. Google only serves events in supported countries.

  • Name
    uule
    Required
    Optional
    Description

    Parameter sets the exact Google-encoded location for the search. uule cannot be used at the same time as location or gl. SearchApi builds it for you when you use the location parameter, but you can provide your own if you want precise control.

Localization

  • Name
    gl
    Required
    Optional
    Description

    This parameter defines the country of the search and returns events from across it. Check the full list of supported Google Events gl countries. It cannot be combined with location or uule. When omitted, SearchApi applies its default localization.

  • Name
    hl
    Required
    Optional
    Description

    This parameter defines the language of the results. Google Events only serves English, so en is the only accepted value.

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).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Search

Search
GET
https://www.searchapi.io/api/v1/search?engine=google_events&q=Tech+Events+in+San+Francisco
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_events",
  "q": "Tech Events in San Francisco"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_n9XmVeqAp1RdHL4gKkGJZrxE",
    "status": "Success",
    "created_at": "2026-08-10T14:32:58Z",
    "request_time_taken": 1.42,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.42,
    "request_url": "https://www.google.com/search?q=Tech+Events+in+San+Francisco&oq=Tech+Events+in+San+Francisco&gl=us&hl=en&ibp=htl;events&ie=UTF-8",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_n9XmVeqAp1RdHL4gKkGJZrxE"
  },
  "search_parameters": {
    "engine": "google_events",
    "q": "Tech Events in San Francisco"
  },
  "events": [
    {
      "position": 1,
      "title": "Tech Summit",
      "entity_id": "/g/11ntz_55ls",
      "venue_entity_id": "/m/09fm_t",
      "link": "https://eventexpo.online/events/tech-summit-2026-san-francis...",
      "seller": "eventexpo.online",
      "date": "Tue, Sep 22",
      "start_time": "Sep 22, 2:00 AM",
      "venue": "Moscone Center",
      "venue_map_link": "https://maps.google.com/?cid=15660485404513614956",
      "category": "Technology conference",
      "address": "San Francisco, CA",
      "thumbnail": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcStAMnd...",
      "map_image": "https://www.google.com/maps/vt/data=GUQNSE3udMfLONJGL7aYSOqM..."
    },
    {
      "position": 2,
      "title": "San Francisco Tech Mixer and Social",
      "entity_id": "/g/11z90pm59t",
      "venue_entity_id": "/g/1z449xb4p",
      "link": "https://www.eventbrite.com/e/1986013647281?aff=ebdiglgooglel...",
      "seller": "eventbrite.com",
      "price": "$7",
      "extracted_price": 7.0,
      "date": "Tomorrow",
      "start_time": "Aug 21, 6:00 PM",
      "venue": "Woodbury",
      "venue_map_link": "https://maps.google.com/?cid=5474371255389291581",
      "category": "Tech networking",
      "address": "San Francisco, CA",
      "thumbnail": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTqT4x7...",
      "map_image": "https://www.google.com/maps/vt/data=924-Wxj9SvjXbgVX5CL7LNav..."
    },
    {
      "position": 3,
      "title": "Startup Tech & AI Networking",
      "entity_id": "/g/11zh6njv5s",
      "venue_entity_id": "/g/11yrx3vg6f",
      "link": "https://www.eventbrite.com/e/1995818376490?aff=ebdiglgooglel...",
      "seller": "eventbrite.com",
      "price": "$18",
      "extracted_price": 18.0,
      "date": "Wed, Aug 26",
      "start_time": "Aug 26, 7:00 PM",
      "venue": "AI Start Academy",
      "venue_map_link": "https://maps.google.com/?cid=7813505549760369687",
      "category": "AI and tech startup networking",
      "address": "San Francisco, CA",
      "thumbnail": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTfIuTs...",
      "map_image": "https://www.google.com/maps/vt/data=u1RXRB9KdSeKcQto6xVyFOEx..."
    },
    ...
  ]
}