DataForSEO Keywords Data APIInstall

Summary

Get location-specific keyword popularity data from DataForSEO Trends (live)

Inputs

• keywords (required) — The maximum number of keywords you can specify: 5. Specified keywords are parsed as a fixed collection; if the array is empty, the API body receives null for this field.
• location_name — Full name of the search engine location. Example: London,England,United Kingdom. Defaults to empty string (omitted/null in API request).
• type — DataForSEO Trends content type. Options: web, news, ecommerce. Defaults to web.
• date_from — Starting date of the time range. Minimal value for web: 2004-01-01. Minimal value for other types: 2008-01-01. Defaults to null.
• date_to — Ending date of the time range. If not specified, today's date is used by default. Defaults to null.
• time_range — Preset time range for the query. Options include past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years, or empty string for custom date range. Defaults to empty string.

Output shape

The DataForSEO API response payload from POST /keywords_data/dataforseo_trends/subregion_interests/live, containing keyword popularity trends segmented by subregion/location. Exact structure depends on API response.

The operation uses the dataForSeoRequest helper, which sends a POST request. If the API returns a status_code of 20100, additional polling occurs (not triggered automatically by this node; results are returned immediately per the execute function).

Examples

Example 1: Query popularity for 3 keywords in London, England over the past 30 days, web type

keywords: ['digital marketing', 'seo', 'content marketing']; location_name: 'London,England,United Kingdom'; type: 'web'; time_range: 'past_30_days'; date_from and date_to omitted

Links

• n8n community nodes installation guide