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)
| 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}'