DataForSEO SERP API icon

DataForSEO SERP API

DataForSEO SERP API

Actions87

Google → Get Google Events SERP Advanced

AI-generated

Summary

Retrieve detailed Google Events SERP data within a specified date range and location using advanced parameters.

Inputs

  • Keyword (required) — The search keyword to query on Google Events SERP, supporting up to 700 symbols, with URL encoding considerations for '%' and '+'.
  • Task Priority — Sets the execution priority of the task; options are Normal or High.
  • Location (required) — Full name of the search engine location to target the SERP data, as supported by DataForSEO.
  • Language (required) — Full name of the search engine language for the query.
  • GPS Coordinates of a Location — Optional parameter for precise location targeting in 'latitude,longitude,radius' format.
  • Date Range to get Events for — Selects the date range for the events data, e.g., today, tomorrow, week, month, etc.
  • OS — Specifies the device operating system filter for the search results, e.g., Windows or macOS.
  • Search Engine Domain — Optionally override the search engine domain to use for the query (e.g., google.co.uk).
  • Depth — Specifies the number of results depth to return, defaulting to 100, with a max of 700.
  • Page Crawl Limit — Limits the number of pages to crawl for results, up to 100 pages.

Output shape

a structured JSON object containing detailed information on Google Events search results matching the query parameters, including event metadata and SERP features.

The returned data respects the specified filters such as location, language, date range, and OS. Depth and page crawl limit parameters control result quantity. Priority affects task execution scheduling. Returned JSON follows DataForSEO SERP API advanced event structure.

Examples

Example 1: Retrieve upcoming concerts in New York City for this week in English.

Keyword='concert'; Location='New York City'; Language='English'; Date Range='week'; Depth=50; Priority='Normal'

Links

Discussion