The SEOClave API

Start in 2 minutes

1. Log in and open API (in the menu).
2. Click Create key and copy it: it's shown only once.
3. Try it (it doesn't use credits):

curl https://seoclave.com/api/v1/account/ \
  -H "Authorization: Bearer sc_YOUR_KEY"

{
  "plan": "Pro",
  "balance": 150,
  "plan_expires": "2026-12-02T14:00:00+00:00",
  "limits": { "per_minute": 10, "requests_per_day": 1000, "credits_per_day": 50 },
  "today": { "requests": 1, "credits": 0 }
}

Authentication

Every request carries the header Authorization: Bearer sc_…. The key never goes in the URL (it would end up in histories and logs) and it doesn't work from the website session. Treat it like a password: whoever has it spends your credits. You can have up to 3 and revoke any of them instantly; when you create one, we email you.

Limits by plan

Per account, adding up all your keys. They're mandatory: they protect your credits and everyone's service.

Every response includes X-RateLimit-Limit and X-RateLimit-Remaining (this minute); go over and you get a 429 with Retry-After in seconds. Requests rejected by a limit aren't charged.

Endpoints

curl https://seoclave.com/api/v1/keywords/ \
  -H "Authorization: Bearer sc_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "ideas", "query": "immigration lawyer", "country": "us", "limit": 50, "max_credits": 1}'

{
  "id": 812, "mode": "ideas", "cached": false, "empty": false,
  "result": { "rows": [
    { "keyword": "immigration lawyer near me", "volume": 9900, "cpc": 18.4,
      "difficulty": 31, "intent": "commercial", "trend": [ … ] }
  ] },
  "credits": 1, "balance": 149, "notices": []
}

What it costs

How not to burn credits

• Always set max_credits. If your script builds a bad request, it won't spend more than that.
• Ask only for the rows you'll use. limit: 50 costs 1 credit; 1,000 rows, 7.
• Measure in batches. A 60-keyword list in volume costs 1 credit; 60 separate requests, 60.
• Don't use refresh in loops. Repeats are already free for 30 days; refresh within 24 h and we return what you have without charging.
• Keep the id. Reading /keywords/{id}/ again is free.
• Lower your daily cap in API while you test.
• On a 429, wait as long as Retry-After says: retrying right away doesn't help.

Errors

Always {"error": {"code": "…", "message": "…"}}. The code never changes: branch on it. The message is for people: it comes in the Accept-Language language (en, es, pt or fr) or, if you don't send it, in your account's language.

If you used the Spanish names

Until November 11, 2026 the API had Spanish routes and fields. They keep working exactly the same, with Spanish responses and codes: you don't have to change anything. Their error mensaje follows the same rule as message: Accept-Language, else your account's language, else Spanish. For new code, use the English names.

MCP connector: Claude, Cursor and more

MCP is the open standard AI assistants use to call external tools. Connect SEOClave and your AI queries Google on its own when the conversation needs it: “how many people search for lawyer in Houston?”, “where do I rank for leather boots?”. It uses the same key, spends the same credits and follows the same limits (only queries count, not the handshake or the tool list). Only keyword research (50 rows = 1 credit; repeating it within 30 days is free) and the top 10 (1 credit) spend credits; the cost estimate, audit, robots.txt, DNS, redirects and your projects are free.

Connector URL: https://seoclave.com/api/v1/mcp

claude mcp add --transport http seoclave https://seoclave.com/api/v1/mcp \
  --header "Authorization: Bearer sc_YOUR_KEY"

{
  "mcpServers": {
    "seoclave": {
      "url": "https://seoclave.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer sc_YOUR_KEY" }
    }
  }
}

claude.ai (web and mobile) and Claude Desktop: one click

1. In claude.ai, open Settings → Connectors → Add custom connector.
2. Name: SEOClave. URL: https://seoclave.com/api/v1/mcp.
3. Authentication: sign in with OAuth, using Claude's published identity or automatic registration (both work). No headers.
4. Click Connect: we bring you to SEOClave, you log in and click Allow. No keys to copy.

ChatGPT

1. Turn on developer mode in Settings → Apps & Connectors → Advanced (depending on your ChatGPT plan).
2. Create a connector with the URL https://seoclave.com/api/v1/mcp and OAuth authentication.
3. Connect it: we bring you to SEOClave, you log in and click Allow.

Other assistants that accept MCP connectors with sign-in (OAuth) connect the same way. You see it and disconnect it in API → Connections.

Connect it to your AI and your tools

• ChatGPT (custom GPT): under Actions, import the schema from https://seoclave.com/api/v1/openapi.json and choose «API Key» authentication, type «Bearer», with your key. Your GPT can then measure keywords and check today's top 10 on its own.
• n8n or Make: an HTTP Request node with the header Authorization: Bearer sc_….
• Claude and other assistants: with the MCP connector, your AI queries SEOClave on its own.

import requests

r = requests.post("https://seoclave.com/api/v1/keywords/",
    headers={"Authorization": "Bearer sc_YOUR_KEY"},
    json={"mode": "volume", "query": "shoes\nleather boots\nsandals", "country": "us", "max_credits": 1},
    timeout=60)
r.raise_for_status()
for row in r.json()["result"]["rows"]:
    print(row["keyword"], row["volume"], row["cpc"])

const r = await fetch("https://seoclave.com/api/v1/keywords/", {
  method: "POST",
  headers: { Authorization: "Bearer sc_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ mode: "serp", query: "lawyer in houston", country: "us", max_credits: 1 }),
});
const data = await r.json();
if (!r.ok) throw new Error(data.error.code);
console.log(data.result.organic.slice(0, 3));

Questions, or something missing? Write to us from the help center. By using the API you accept the terms.