Actions30
- AI Optimization Actions
- Backlink Actions
- Business Data Actions
- Keywords Data Actions
- Labs Actions
- On Page Actions
- SERP Actions
Labs → Get Keyword Ideas
AI-generatedSummary
Generate keyword ideas related to specified input keywords using Google product or service categories matching. Accepts multiple keywords with location, language, and filtering options to tailor the suggestions.
Inputs
- Keywords (required) — List of input keywords (each at least 3 characters long, converted to lowercase) to base the keyword ideas on; maximum 200 keywords.
- Location (required) — Full name of the geographic location to target (must be supported by DataForSEO).
- Language (required) — Full name of the language to use (must be supported by DataForSEO).
- Search Mode — Boolean setting to select phrase-match (true) or broad-match (false) search algorithm for generating results.
- Ignore Synonyms — Boolean option to exclude highly similar keywords and return only core keywords.
- Include SERP Info? — Boolean option to include search engine results page (SERP) information in the response.
- Include Clickstream-Based Metrics in the Result? — Boolean option to include clickstream data metrics in the results.
- Limit — Maximum number of keyword ideas to return (up to 1000, default 50).
- Offset — Number of results to skip for pagination (default 0).
- Filters — JSON string of filtering parameters to narrow the results, as defined by DataForSEO documentation.
- Sort — Up to three sorting rules to order the results, each specifying a field name and ascending/descending direction.
Output shape
a JSON object containing keyword ideas and optionally SERP and clickstream data per specified input keywords
Supports pagination via limit and offset. Filtering parameters and sort options allow refined control over results. Errors will be thrown for invalid filters or if more than three sorting rules are provided.