DataForSEO Keywords Data APIInstall

Summary

Fetch live Google Ads search volume, cost-per-click (CPC), and competition index metrics for a specified set of keywords.

Inputs

• input_mode (required) — Select whether to supply keywords manually via a field collection or as a raw JSON array.
• keywords (required) — Collection of up to 1,000 keywords (max 80 characters and 10 words per keyword) when Input Mode is set to Manual.
• keywords_json (required) — JSON array of up to 1,000 keywords when Input Mode is set to JSON.
• location_name — Full location name for target search region (e.g., 'London,England,United Kingdom').
• language_name — Full search engine language name (e.g., 'English').
• location_coordinate — GPS coordinates of the target location formatted as 'latitude,longitude' (e.g., '53.476225,-2.243572').
• search_partners — Include data from Google search partner networks alongside Google search sites. Defaults to false.
• include_adult_keywords — Include adult content keywords in results. Defaults to false.
• date_from — Start date for historical search volume timeframe. Defaults to the past 12 months.
• date_to — End date for historical search volume timeframe. Defaults to yesterday's date.
• sort_by — Sort order field for results (e.g., 'search_volume', 'relevance', 'competition_index', 'high_top_of_page_bid', 'low_top_of_page_bid').

Output shape

a single record

Returns the live response object from the DataForSEO API envelope containing task status, cost metadata, and a result set with keyword search volumes, competition levels, and CPC bids.

Examples

Example 1: Retrieve live Google search volume for software keywords in the US

Set Input Mode to Manual, add keywords ('crm software', 'sales automation'), set Location to 'United States', and Language to 'English'.

Example 2: Fetch live keyword search volume using dynamic JSON array input

Set Input Mode to JSON, set Keywords JSON Array to '={{ $json.keyword_list }}', and set Location to 'United Kingdom'.

Links

• n8n community nodes installation guide