DataForSEO Keywords Data APIInstall

Summary

Retrieves estimated Google Ads performance metrics for specified keywords, including impressions, clicks, cost, and average CPC.

Inputs

• input_mode (required) — Specifies how keywords are provided: 'manual' for a list of keywords or '' for a JSON array.
• keywords (required) — List of keywords to analyze. Maximum 1000 keywords. Each keyword supports up to 80 characters and 10 words and is converted to lowercase.
• keywords_ (required) — JSON array of keywords to analyze. Maximum 1000 keywords. Each keyword supports up to 80 characters and 10 words and is converted to lowercase.
• bid (required) — The maximum custom bid (in USD) used to filter the estimated performance data.
• match (required) — The keywords match type to use: 'exact', 'phrase', or 'broad'.
• location_name — Full name of the search engine location (e.g., 'London,England,United Kingdom').
• language_name — Full name of the search engine language (e.g., 'English').
• location_coordinate — GPS coordinates of a location (e.g., '53.476225,-2.243572').
• search_partners — If true, results include Google Search Partners.
• date_from_traffic — Starting date of the forecasting time range (minimum value is tomorrow).
• date_to_traffic — Ending date of the forecasting time range (minimum value is date_from + 1 day).
• date_interval — Preset forecasting time interval: 'next_week', 'next_month', or 'next_quarter'.
• sort_by_traffic — Sort the results by: 'average_cpc', 'clicks', 'cost', 'ctr', 'impressions', or 'relevance'.

Output shape

A single record per keyword containing estimated Google Ads metrics such as impressions, clicks, cost, and average CPC.

The operation returns data for the forecasting time range defined by date_from_traffic, date_to_traffic, or date_interval.

Examples

Example 1: Estimate traffic for a specific list of keywords with a maximum bid of $5.00 and exact match type.

Input mode: manual, Bid: $5.00, Match type: exact

Example 2: Get estimated traffic for 1000 keywords over the next month with results sorted by relevance.

Input mode: manual, Date interval: next_month, Sort by: relevance

Links

• n8n community nodes installation guide