DataForSEO Keywords Data APIInstall

Summary

Retrieve current Google Ads search volume, cost-per-click (CPC), and competition index for specified keywords.

Inputs

• input_mode (required) — Select how to provide keywords: 'manual' to use a list field or '' to provide a JSON array. Keywords are converted to lowercase.
• keywords (required) — List of keywords to analyze (maximum 1000). Input via the 'manual' mode field.
• keywords_ (required) — JSON array of keywords to analyze (maximum 1000). Use this field when 'input_mode' is set to ''.
• location_name (required) — 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 the location (e.g., 53.476225,-2.243572).
• search_partners — If true, includes results from Google Search Partners networks.
• include_adult_keywords — If true, includes keywords associated with adult content.
• date_from — Starting date of the time range (minimum 4 years prior). Default is past 12 months.
• date_to — Ending date of the time range (cannot be in the current month). Default is yesterday.
• sort_by — Sort results by: 'competition_index', 'high_top_of_page_bid', 'low_top_of_page_bid', 'relevance', or 'search_volume'.

Output shape

one output item per input item containing the response from the DataForSEO API.

The operation uses a POST request to initiate a task and then polls for results, returning the final data once available. The response structure follows the DataForSEO Keywords Data API v3 format.

Examples

Example 1: Analyze search volume for a list of keywords in London, UK.

Set 'input_mode' to 'manual', provide a list of keywords, specify 'location_name' as 'London,England,United Kingdom', and leave other fields as defaults.

Example 2: Get CPC and competition data for keywords in English, sorted by relevance.

Set 'input_mode' to '' with a keyword array, 'language_name' to 'English', and 'sort_by' to 'relevance'.

Links

• n8n community nodes installation guide