DataForSEO Keywords Data APIInstall

Summary

Get Bing keyword suggestions for the supplied seed keywords (up to 200). Optionally filter by location, language, device, date range, and exclude negative keywords. Results include suggested keywords with search volume, CPC, competition, and relevance. The operation has both live (immediate) and regular (task‑based) variants; the live variant returns the result directly, while the regular variant first posts a task and then polls for completion.

Inputs

• input_mode (required) — Whether keywords are provided manually or as a JSON array. Options: Manual, JSON.
• keywords_for_keywords (required) — Seed keywords (manual mode). Maximum 200 keywords, each up to 100 characters. Values are converted to lowercase. Shown when input_mode is Manual.
• keywords_for_keywords_json (required) — Seed keywords (JSON mode). JSON array of strings, maximum 200 items, each up to 100 characters. Values are converted to lowercase. Shown when input_mode is JSON.
• location_name (required) — Full name of the search engine location (e.g., London,England,United Kingdom).
• language_name (required) — Language for the keywords. Options: English, French, German (default English).
• location_coordinate — GPS coordinates of a location as 'latitude,longitude' (optional).
• keywords_negative — Keywords to exclude from results. Maximum 200 terms, each converted to lowercase.
• device (required) — Device type to filter results. Options: all (default), mobile, desktop, tablet.
• sort_by (required) — Field to sort results by. Options: (none), competition, CPC, relevance, search_volume (default empty).
• date_from — Start date of the time range for which data is returned. If omitted, data for the last 12 months is used.
• date_to — End date of the time range. If omitted, data for the last 12 months is used. Minimum two years back from today, maximum one month from today.
• search_partners (required) — Whether to include Google search partners (applies to the underlying DataForSEO request). Default: false.

Output shape

array

Each element represents a suggested keyword and contains fields such as keyword, location_name, language_name, search_volume, cpc, competition, relevance, and related metadata. For the regular (task‑based) variant, the initial response contains task information; after polling, the final result is the same array of keyword suggestions.

Examples

Example 1: Get live keyword suggestions for 'running shoes' in the US, English, on desktop, sorted by search volume.

input_mode: Manual; keywords_for_keywords: ['running shoes']; location_name: United States; language_name: English; device: desktop; sort_by: search_volume; search_partners: false.

Links

• n8n community nodes installation guide