DataForSEO Labs API icon

DataForSEO Labs API

DataForSEO

Google → Get Top Searches

AI-generated

Summary

Retrieves top Google searches for a specified location and language, with optional SERP details and clickstream metrics. Supports filtering, sorting, and limiting or offsetting the results.

Inputs

  • Location (required) — Full location name supported by DataForSEO.
  • Language (required) — Full language name supported by DataForSEO.
  • Include SERP Info? — Whether to include SERP information in the results; defaults to false.
  • Include Clickstream-Based Metrics in the Result? — Whether to include clickstream-based metrics; defaults to false.
  • Ignore Synonyms — When true, excludes highly similar keywords and returns only core keywords; defaults to false.
  • Filters — Optional DataForSEO Labs filters.
  • Sort — Optional sorting rules by field and ascending or descending direction; up to three rules.
  • Limit — Maximum number of results, from 1 to 1000; defaults to 1000.
  • Offset — Number of results to skip; defaults to 0.

Output shape

A list of top-search result items returned by the DataForSEO Labs API.

The source pack provides only function signatures for this operation, so the precise response fields and pagination behavior are not visible.

Links

Discussion