DataForSEO SERP API icon

DataForSEO SERP API

DataForSEO SERP API

Actions87

Google → Get Live Google Events SERP Advanced

AI-generated

Summary

Retrieve live Google Events search engine results page (SERP) data with advanced parameters.

Inputs

  • Keyword (required) — Specify the keyword to search for, supporting up to 700 symbols. Special characters like % and + must be URL encoded as %25 and %2B respectively.
  • Location (required) — Full name of the search engine location to tailor the search results.
  • Language (required) — Full name of the search engine language to localize the results.
  • GPS Coordinates of a Location — Latitude, longitude, and radius formatted as 'latitude,longitude,radius' to specify precise location targeting.
  • Date Range to get Events for — Select the date range for which to fetch events, such as today, tomorrow, week, weekend, next week, month, or next month.
  • OS — Specify the desktop operating system (Windows or macOS) to simulate device context; defaults to Windows.
  • Search Engine Domain — Override the default search engine domain based on location and language, e.g., google.co.uk, google.com.au.
  • Depth — Number of results depth to retrieve, from 1 up to 700; default is 100.
  • Page Crawl Limit — Maximum number of search results pages to crawl, from 1 to 100.

Output shape

a JSON object containing detailed live events SERP data from Google for the specified keyword and parameters

The response includes advanced event-specific search results as returned by the DataForSEO API. Output structure corresponds to DataForSEO's live Google Events SERP advanced response format. Pagination through results is controlled by 'Depth' and 'Page Crawl Limit' parameters.

Examples

Example 1: Get live event SERP data for keyword 'music festival' in New York with English language settings for events this week, limiting depth to 50 results.

Keyword='music festival', Location='New York, United States', Language='English', Date Range='week', Depth=50

Links

Discussion