N8N integration

On this page, you’ll find the guide on how to connect Keyword Insights API with N8N to run clustering.

Step 1

Authentication via API key

Create an API key in the Keyword Insights dashboard under API Keys. The dashboard shows the full key only one time, so copy it immediately. See API Key Authentication. Use an HTTP Request node and select the following options:

Authentication -> Generic Credential Type
Generic Auth Type -> Header Auth
Header Auth -> Create new credential

N8N opens the credential modal. Enter your API key, then click Save:

Name -> X-API-Key
Value -> your API key, for example kwi_sk_aBcDeFgHiJkLmNoPqRsTuVwXyZ1234567890abc

Header Auth credential with the X-API-Key name

N8N saves the credential as Header Auth account. To change it later, click the pencil icon next to the Header Auth field.

Step 2

Creating a clustering order

In the same HTTP Request node, update the following settings:

Method -> POST
URL -> https://api.keywordinsights.ai/api/keywords-insights/order/
Send Body -> Enabled
JSON, Using JSON

Paste the following json into the body, make sure to update the keywords, volumes you want to cluster, and URL, you can also customize further based on the configuration you want. You can also pass folder_id if you want it placed in a specific folder in the platform.

{
  "clustering_method": "volume",
  "device": "desktop",
  "grouping_accuracy": 4,
  "hub_creation_method": "medium",
  "insights": [
    "cluster",
    "rank",
    "context"
  ],
  "language": "en",
  "location": "United States",
  "project_name": "A Clustering project",
  "keywords": [
    "keyword clustering",
    "keyword research",
    "topical authority",
    "clustering methods",
    "page authority"
  ],
  "search_volumes": [
    2300,
    3210,
    5500,
    2100,
    1200
  ],
  "url": "https://www.keywordinsights.ai/"
}

That’s all!

Getting Started

Learning Center

User Guide

Understanding the Output

Tool Use Cases

Account Management

Data Retention

Integrations

Utilities

API

FAQs

Help & Support

Step 1

Authentication via API key

Step 2

Creating a clustering order

​Step 1

​Authentication via API key

​Step 2

​Creating a clustering order

Step 1

Authentication via API key

Step 2

Creating a clustering order