The TopIndexer API

Overview

Every endpoint lives under /api/v1 and returns JSON. Authentication is a single Bearer key — there are no separate OAuth scopes, no per-endpoint permissions. A key is bound to one team and acts on that team’s credit balance.

Specs & tools

Import the API anywhere — a Postman/Insomnia workspace, an SDK generator, or an AI agent. The OpenAPI spec is the universal one: drop the URL into a custom GPT action, an MCP/tool-use config, or any code generator.

Point an agent at the spec directly: https://topindexer.com/openapi.yaml · https://topindexer.com/llms.txt

Authentication

Create a key in the dashboard under Settings → API keys. Keys are shown once, look like ti_live_…, and don’t expire — but you can revoke them at any time. We only ever store a hash of the key, so a lost key can’t be recovered; create a new one.

Pass it as a Bearer token on every request:

Authorization: Bearer ti_live_a1b2c3…

A missing or malformed key returns 401 unauthorized.

Submit between 1 and 50 URLs. We validate them, deduct one credit per accepted URL in a single atomic batch, and begin triggering the crawl immediately. Invalid (non-http(s)) URLs are silently dropped and reported in ignoredInvalid. Returns 202 Accepted.

Body

{
  "urls": ["https://example.com/page-a", "https://example.com/page-b"]
}

Request

curl -X POST https://api.topindexer.com/api/v1/submit \
  -H "Authorization: Bearer ti_live_a1b2c3…" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com/page-a"]}'

Response · 202

{
  "submitted": 1,
  "ignoredInvalid": 0,
  "submissions": [
    { "id": "01J9…ULID", "url": "https://example.com/page-a", "status": "queued" }
  ]
}

Returns 402 insufficient_credits (with required and available fields) if your balance can’t cover the batch — nothing is charged.

List your team’s submissions, newest first.

Query parameters

Request

curl "https://api.topindexer.com/api/v1/submissions?status=indexed&limit=50" \
  -H "Authorization: Bearer ti_live_a1b2c3…"

Response · 200

{
  "submissions": [
    {
      "id": "01J9…ULID",
      "url": "https://example.com/page-a",
      "status": "indexed",
      "submittedAt": "2026-06-01T12:00:00.000Z"
    }
  ]
}

Return the authenticated team and its current credit balance — handy for a pre-flight check before a large batch.

Request

curl https://api.topindexer.com/api/v1/me \
  -H "Authorization: Bearer ti_live_a1b2c3…"

Response · 200

{
  "team": { "id": "team_…", "name": "Acme", "creditBalance": 480 },
  "keyId": "key_…"
}

Submission lifecycle

A submission moves through these states. We verify index status honestly — via a Google site: check, never Search Console — and auto-refund anything that isn’t indexed within the 7-day guarantee.

Errors

Errors use standard HTTP status codes and a JSON body of the shape { "error": "…", "message": "…" }.