Top SEO Toolkit icon Top SEO Toolkit
SEO Tools Pricing API Docs AI Playground ↗ AI Gateway ↗ AI Docs ↗ API Health

Toolkit REST API v1 & AI Gateway

Toolkit routes authenticate with scoped Bearer tokens from /tokens. AI inference runs on us-chicago-1.

Authentication Header

Authorization: Bearer tst_live_<your_token>
Accept: application/json
Content-Type: application/json

Endpoints

Method Path Required Ability Description
GET /api/v1/health Public Database connectivity & service health status
POST /api/v1/tools/seo-analyze tools:run Run SSRF-safe On-Page SEO audit for {"url":"..."}
POST /api/v1/tools/headers tools:run Trace redirects, grade security headers & inspect TLS cert
POST /api/v1/tools/dns-rdap tools:run Query DNS records + RDAP registration data for {"domain":"..."}
CRUD /api/v1/links{/{id}} links:manage List, create, view, update, or delete short links
CRUD /api/v1/monitors{/{id}/check} monitors:manage Manage uptime monitors and trigger immediate checks

Example Request

curl -sS -X POST "https://topseotoolkit.com/api/v1/tools/seo-analyze" \
  -H "Authorization: Bearer tst_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

AI Gateway API — us-chicago-1 (17 Verified Models)

Base URL: https://api.topseotoolkit.com/v1 (or https://ai.topseotoolkit.com/v1)

Test in Playground ↗
Method Endpoint Models Details
GET /health 17 total Public liveness & active region (us-chicago-1)
GET /v1/models 17 verified Lists all 15 Chat, 1 Embedding, and 1 Rerank model
POST /v1/chat/completions 15 Chat xAI Grok, Google Gemini 2.5, Meta Llama 3.3/4, OpenAI GPT-OSS (JSON + SSE)
POST /v1/embeddings cohere.embed-v4.0 1536 dims; input_type: SEARCH_DOCUMENT, SEARCH_QUERY, CLASSIFICATION, CLUSTERING
POST /v1/rerank cohere.rerank-v4.0-fast Plain string documents list, top_n, is_echo

Verified Model IDs (us-chicago-1)

xAI Grok (7 Chat)

  • xai.grok-4.7
  • xai.grok-4.6
  • xai.grok-4.3
  • xai.grok-4.20-reasoning
  • xai.grok-4.20-non-reasoning
  • xai.grok-4.20-0309-reasoning
  • xai.grok-4.20-0309-non-reasoning

Google Gemini 2.5 (3 Chat)

  • google.gemini-2.5-pro
  • google.gemini-2.5-flash
  • google.gemini-2.5-flash-lite

Meta Llama 3.3 & 4 (3 Chat)

  • meta.llama-4-maverick-17b-128e-instruct-fp8
  • meta.llama-4-scout-17b-16e-instruct
  • meta.llama-3.3-70b-instruct

OpenAI GPT-OSS (2 Chat)

  • openai.gpt-oss-120b
  • openai.gpt-oss-20b

Embeddings (/v1/embeddings)

cohere.embed-v4.0

1536 dims · SEARCH_DOCUMENT, SEARCH_QUERY, CLASSIFICATION, CLUSTERING

Rerank (/v1/rerank)

cohere.rerank-v4.0-fast

Plain string documents list, top_n, is_echo

AI Gateway Examples — Chat, Embeddings & Rerank

1. Chat Completions (/v1/chat/completions)

curl -sS -X POST "https://api.topseotoolkit.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-fleet-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"xai.grok-4.7","messages":[{"role":"user","content":"Audit this meta title"}],"stream":true}'

2. Embeddings (/v1/embeddings)

curl -sS -X POST "https://api.topseotoolkit.com/v1/embeddings" \
  -H "Authorization: Bearer sk-fleet-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"cohere.embed-v4.0","input":["first document","second document"],"input_type":"SEARCH_DOCUMENT"}'

3. Rerank (/v1/rerank)

curl -sS -X POST "https://api.topseotoolkit.com/v1/rerank" \
  -H "Authorization: Bearer sk-fleet-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"cohere.rerank-v4.0-fast","query":"what is AI","documents":["AI is machine intelligence","cats are animals"],"top_n":2,"is_echo":false}'