DataForSEO Keywords Data APIInstall

Summary

Retrieves Google Ads keyword suggestions relevant to specified terms.

Inputs

• input_mode (required) — Choose 'Manual' to add keywords via the UI or 'JSON' to provide a JSON array of keywords.
• keywords_for_keywords (required) — Up to 20 keywords. If input_mode is 'manual', add keywords via the UI. If '', provide a JSON array.
• keywords_for_keywords_ (required) — Up to 20 keywords in JSON array format. Only visible when input_mode is ''.
• target_keywords_for_keywords — A website or URL to get keywords relevant to it. Only visible for this operation.
• location_name — Full name of the search engine location (e.g., London,England,United Kingdom).
• location_coordinate — GPS coordinates of a location (e.g., 53.476225,-2.243572).
• language_name — Full name of the search engine language (e.g., English).
• search_partners — Include Google Search Partners results. Default is false.
• include_adult_keywords — Include adult keywords in the response. Default is false.
• date_from — Starting date of the time range. Default is past 12 months.
• date_to — Ending date of the time range. Default is yesterday.
• sort_by — Sort results by Competition Index, Relevance, or Search Volume.

Output shape

a list of items containing keyword suggestions

Keywords are converted to lowercase. The API enforces a maximum of 20 keywords per request.

Examples

Example 1: Get relevant keywords for a list of terms

Use 'Manual' input mode with up to 20 keywords; optionally filter by location, language, and date range.

Example 2: Provide keywords via JSON

Set 'JSON' input mode and supply a JSON array of keywords; target a specific website URL to get relevant keywords for it.

Links

• n8n community nodes installation guide