INDEXMAFIA / DEVELOPER DESK / V1

A direct line to
your next move.

Use the IndexMafia API from your server to submit standard URL requests and track delivery. Every key is restricted to its owner’s account. Create and revoke keys from your member desk.

Base URL
https://indexmafia.com/api/v1

HTTPS only. Send Authorization: Bearer YOUR_INDEXMAFIA_KEY or X-API-Key: YOUR_INDEXMAFIA_KEY. Never embed a key in public frontend code.

Endpoints

MethodPathPurpose
GET/balanceAccount credits and wallet balance
POST/submitSubmit up to 500 unique standard URLs
GET/request/{id}Read one of your requests
GET/requestsList your requests with pagination

Submit an operation

Send a JSON array of public HTTP(S) URLs. Use a unique Idempotency-Key of 16–128 allowed characters for each new operation. Repeat that same key and payload when retrying. Different URLs or engine selections with a used key return a conflict.

curl -X POST 'https://indexmafia.com/api/v1/submit' \
  -H 'Authorization: Bearer YOUR_INDEXMAFIA_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: release-2026-11-16-001' \
  -d '{"label":"Editorial launch","urls":["https://example.com/story"],"engines":["google","bing","yandex","duckduckgo"]}'

Example response, HTTP 202:

{
  "success": true,
  "operation_id": "a1b2c3d4e5f67890a1b2c3d4e5f67890",
  "submitted": 1,
  "credits_reserved": 1,
  "ids": [42],
  "message": "Accepted into the IndexMafia queue. Delivery does not guarantee search indexing."
}

All request IDs belong to IndexMafia. A 202 response means that your operation is queued, not that the page has been indexed. An operation is atomic: if you do not have enough credits, no URLs from that operation are queued.

Choose search engines

The optional engines array accepts google, bing, yandex and duckduckgo. Google is always included. Omitting the field keeps Google-only delivery. All selected engines are included at one credit per URL. A completed status describes the aggregate provider workflow; it is not a separate verified indexing result for each engine.

Check your balance

curl 'https://indexmafia.com/api/v1/balance' \
  -H 'Authorization: Bearer YOUR_INDEXMAFIA_KEY'

{"success":true,"brand":"IndexMafia","credits":100,"wallet_usd":"29.00","credit_per_url":1}

Follow a request

curl 'https://indexmafia.com/api/v1/request/42' \
  -H 'Authorization: Bearer YOUR_INDEXMAFIA_KEY'

curl 'https://indexmafia.com/api/v1/requests?page=1&per_page=20' \
  -H 'Authorization: Bearer YOUR_INDEXMAFIA_KEY'

List results support page, per_page (1–100) and an optional operation_id. Responses include only requests owned by your account.

{
  "success": true,
  "request": {
    "id": 42,
    "operation_id": "a1b2c3d4e5f67890a1b2c3d4e5f67890",
    "url": "https://example.com/story",
    "status": "pending",
    "credits": 1,
    "refunded": false,
    "created_at": "2026-11-16T10:00:00Z"
  }
}

Understand the status

StatusMeaning
queuedCredits reserved; waiting to be dispatched.
pending / processingThe delivery workflow is in progress.
completedDelivery reported complete. This is not Google indexing confirmation.
reviewThe result is uncertain. It is being reconciled to prevent duplicate sending.
failed / cancelledDelivery failed or was cancelled. Reserved credits are returned once.

Limits and errors

The API allows 120 requests per minute per member/IP pair. Poll at reasonable intervals, such as every 30–60 seconds. Submission bodies are limited to 1.1 MB and 500 unique URLs. Use complete URLs without credentials, fragments or nonstandard ports.

Responses use 401 for missing or invalid credentials, 404 for unknown or unowned requests, 409 for idempotency conflicts, 413 for oversized bodies, 422 for invalid input or insufficient balance, 429 for rate limits and 503 for temporary failures. For a 503 submission response, retry with the same Idempotency-Key.

{"success":false,"error":{"code":"invalid_request","message":"Insufficient balance. Add funds or purchase a credit pack."}}

A workflow built for real expectations

Your API response reports delivery activity, not an independent check of a search engine’s index. IndexMafia does not promise a fixed indexing time, universal inclusion or a ranking increase.