DataForSEO Labs API icon

DataForSEO Labs API

DataForSEO

Google → Get Keyword Ideas

AI-generated

Summary

Retrieves Google Keyword Ideas from DataForSEO Labs using up to 200 seed keywords and the selected location, with optional search, SERP, clickstream, synonym, filter, sorting, and pagination settings.

Inputs

  • Input Mode (required) — Choose Manual to enter keywords individually or JSON to provide a keyword array. The array supports up to 200 keywords; each keyword should be at least 3 characters and is converted to lowercase.
  • Keywords / Keywords JSON Array (required) — Seed keywords used to generate ideas, entered manually or as a JSON array, depending on Input Mode.
  • Location (required) — Full name of the location to use for the keyword ideas request.
  • Language — Full name of the language to use for the request.
  • Search Mode — When enabled, uses phrase-match; when disabled, uses broad-match. Defaults to broad-match.
  • 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 — Whether to exclude highly similar keywords and return only core keywords. Defaults to false.
  • Filters — DataForSEO Labs filter expression for narrowing the results.
  • Sort — Up to three sorting rules, each specifying a field name and ascending or descending direction.
  • Limit (up to 1000) — Maximum number of ideas to request, from 1 to 1000. Defaults to 700.
  • Offset — Starting offset for paginating results. Defaults to 0.

Output shape

A list of keyword idea results returned by the DataForSEO Labs API.

The supplied source pack exposes the operation function signature but omits its implementation body, so the exact response envelope and item fields are not shown.

Links

Discussion