Skip to main content
The Google Events API allows users to retrieve information about events based on specified search terms, locations, and various filter options.

​
Get Your API Key

Sign in at hasdata.com, go to your account settings, and copy your API key. All requests must include your key in the x-api-key header.

​
Make Your First Request

curl --request GET \
  --url 'https://api.hasdata.com/scrape/google/events?q=Events%20in%20New%20York&location=Austin%2CTexas%2CUnited%20States' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'

​
API Parameters

ParameterDefault ValueRequiredDescription
qEvents in New YorkYesSpecify the search term for which you want to scrape the SERP.
locationAustin,Texas,United StatesNoGoogle canonical location for the search.
uule-NoThe encoded location parameter.
domain-NoGoogle domain to use. Default is google.com.
gl-NoThe two-letter country code for the country you want to limit the search to.
hl-NoThe two-letter language code for the language you want to use for the search.
start-NoThis parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the second page, and 20 to the third page.
htichips-NoFilter parameter for refining event search results. Supports various filters for events. Multiple filters can be passed using a comma. The available filters are:

- date:today: Today’s Events
- date:tomorrow: Tomorrow’s Events
- date:week: This Week’s Events
- date:weekend: This Weekend’s Events
- date:next_week: Next Week’s Events
- date:month: This Month’s Events
- date:next_month: Next Month’s Events
- event_type:Virtual-Event: Online Events

For example, to filter for today’s online events, use: event_type:Virtual-Event,date:today.
⌘I