Logo SearchApi

Google Events API Documentation

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

Retrieve detailed events information including 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

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

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.

  • Name
    uule
    Required
    Optional
    Description

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

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

Filters

  • Name
    chips
    Required
    Optional
    Description

    This parameter lets you filter results by date and event type. For dates, you can use filters such as date:today, date:tomorrow, date:week, date:weekend, date:next_week, date:month, date:next_month. To filter by event type, use event_type:Virtual-Event for online events. You can also combine filters with a comma, for example: event_type:Virtual-Event,date:weekend).

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

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_BxR6dazVoAVkFw0z3Ewvbj9G",
    "status": "Success",
    "created_at": "2025-07-10T11:45:34Z",
    "request_time_taken": 1.72,
    "parsing_time_taken": 0.06,
    "total_time_taken": 1.78,
    "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",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_BxR6dazVoAVkFw0z3Ewvbj9G.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_BxR6dazVoAVkFw0z3Ewvbj9G"
  },
  "search_parameters": {
    "engine": "google_events",
    "q": "Tech Events in San Francisco",
    "google_domain": "google.com",
    "hl": "en",
    "gl": "us"
  },
  "events": [
    {
      "position": 1,
      "title": "TECHSPO San Francisco 2025",
      "link": "https://www.eventbrite.com/e/techspo-san-francisco-2025-technology-expo-internet-mobile-adtech-tickets-1002112815407",
      "date": {
        "day": "21",
        "month": "Jul"
      },
      "duration": "Mon, Jul 21, 9 AM – Tue, Jul 22, 4 PM",
      "address": "345 Stockton St, San Francisco, CA",
      "location": "Grand Hyatt San Francisco",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSiWdX4D-iy511VyEz86YtH2Nz3Yd6fYa9qY_cHKjBd6w&s=10",
      "description": "TECHSPO San Francisco 2025 will be held from 21st - 22nd July 2025 at Grand Hyatt Hotel at SFO in San Francisco, California, United States. This is a technology expo. It brings together some of...",
      "venue": {
        "name": "Grand Hyatt San Francisco",
        "rating": 4.3,
        "reviews": 4083,
        "link": "https://www.google.com/search?sca_esv=a593c4d97b4a5a54&hl=en&gl=us&q=Grand+Hyatt+San+Francisco&ludocid=2634875094024949199&ibp=gwp%3B0,7"
      },
      "offers": [
        {
          "seller": "Eventbrite.com",
          "link": "https://www.eventbrite.com/e/techspo-san-francisco-2025-technology-expo-internet-mobile-adtech-tickets-1002112815407",
          "link_type": "tickets"
        },
        {
          "seller": "Tradeindia",
          "link": "https://www.tradeindia.com/tradeshows/133248/techspo-san-francisco-2025.html",
          "link_type": "more info"
        },
        ...
      ],
      "event_location_map": {
        "image": "https://www.google.com/maps/vt/data=Byb1R-hvz1mSx4aX4Ln3hFCvL86VjR-gxJbOp0Ol4q8BJszbLk7fYImAsjCsW7LUL0fsFtLIFk_1Hh1xWzehWXi85S9oGsfdPP-OnNHvY1n3BXjLX1k",
        "link": "https://www.google.com/maps/place//data=!4m2!3m1!1s0x8085808eb34e4dbf:0x2490f4f016e18dcf?sa=X&ved=2ahUKEwj0mq3bm7KOAxWsh1YBHUr7JAMQ9eIBegQIAhAA&hl=en&gl=us"
      }
    },
    ...
  ]
}