Logo SearchApi

Google Events API Documentation

GET   /api/v1/search?engine=google_events

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

    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

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.org/api/v1/search?engine=google_events&q=Tech+Events+in+San+Francisco
Request
import requests

url = "https://www.searchapi.org/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"
      }
    },
    ...
  ]
}