DataForSEO Keywords Data APIInstall

Summary

Returns estimated Google Ads traffic metrics—impressions, clicks, cost, and CPC—for specified keywords based on a custom bid and match type.

Inputs

• input_mode (required) — Choose how to provide keywords: 'manual' for a list field or '' for a JSON array.
• keywords (required) — List of keywords to analyze. Max 1000 per request. Lowercased automatically.
• keywords_ (required) — JSON array of keywords. Max 1000 per request. Lowercased automatically.
• bid (required) — Maximum bid value (USD, 2 decimal precision) used to estimate traffic.
• match (required) — Match type for keywords: 'exact', 'phrase', or 'broad'.
• location_name — Full location name (e.g., 'London,England,United Kingdom') to target.
• language_name — Full language name (e.g., 'English') to target.
• location_coordinate — GPS coordinates (lat,long) for the target location.
• search_partners — If true, includes Google Search Partners in results.
• date_from_traffic — Start date for the forecasting time range (minimum: tomorrow).
• date_to_traffic — End date for the forecasting time range (minimum: date_from + 1 day; maximum: current day of next year).
• date_interval — Preset time interval ('next_week', 'next_month', 'next_quarter') instead of specific dates.
• sort_by_traffic — Sort results by: 'average_cpc', 'clicks', 'cost', 'ctr', 'impressions', or 'relevance'. Default: 'relevance'.

Output shape

An array of items, each containing a JSON object with estimated traffic metrics for the provided keywords.

Metrics are estimates based on the specified bid and match type. Data is fetched via the DataForSEO API, which handles pagination and status polling for results.

Examples

Example 1: Estimate monthly traffic for a set of keywords in the US.

Keywords: 'running shoes', 'yoga mat'; Bid: 2.50; Location: 'United States'; Match: 'phrase'; Sort by: 'clicks'.

Example 2: Forecast next quarter traffic for exact match keywords in London.

Keywords: 'coffee shop london'; Bid: 5.00; Location: 'London,England,United Kingdom'; Match: 'exact'; Date Interval: 'next_quarter'.

Links

• n8n community nodes installation guide