Quickstart

This guide gets you from a new account to your first authenticated API request in a few minutes.

1. Create a workspace

Sign up and create a workspace for each site (or client) you manage. A workspace holds its own keyword reservoir, backlink profile and content pipeline, plus the seats and integrations scoped to it.

2. Generate an API key

In Settings → API keys, create a key. Treat it like a password — it grants full access to the workspace. Store it as an environment variable, never in source control.

export SEO_INSIGHT_API_KEY="sk_live_xxxxxxxxxxxxxxxx"

3. Make your first request

Every endpoint lives under https://api.seoinsight.app/v1. Authenticate with a Bearer token. Here is a request for the keyword reservoir of the current workspace:

curl https://api.seoinsight.app/v1/keywords \
  -H "Authorization: Bearer $SEO_INSIGHT_API_KEY" \
  -G -d "limit=3"

A successful response returns JSON:

{
  "data": [
    { "keyword": "seo mcp tool", "volume": 880, "kd": 34, "cpc": 3.1, "position": 12 },
    { "keyword": "seo mcp server", "volume": 320, "kd": 28, "cpc": 2.4, "position": 14 }
  ],
  "has_more": true
}

4. Try it from code

The same call from a TypeScript service:

const res = await fetch("https://api.seoinsight.app/v1/keywords?limit=3", {
  headers: { Authorization: `Bearer ${process.env.SEO_INSIGHT_API_KEY}` },
});
 
const { data } = await res.json();
console.log(data);

Next steps

PreviousIntroductionNext MCP & AI agents