Authentication

Все запросы к API требуют персональный токен. v2 endpoints поддерживают стандартный заголовок Authorization: Bearer <token>; legacy v1 принимают токен также в JSON-теле через поле api_key или token.

Все эндпоинты POST принимают Content-Type: application/json. GET-эндпоинты принимают токен в query-string как ?api_key=….

Заголовок (рекомендуется для v2)

curl -X POST https://ivoque.de/api/v2/submissions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"links":["https://example.com/page-1"],"queue":"slow"}'

JSON body field (legacy)

curl -X POST https://ivoque.de/api/link-submit.php \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_API_TOKEN","links":["https://example.com/page-1"]}'

Query string (только GET)

curl "https://ivoque.de/api/balance.php?api_key=YOUR_API_TOKEN"

Получить API-токен

Публичного токена нет — у каждого аккаунта свой. Зарегистрируйтесь и выпустите токен в кабинете или в Telegram-боте (бонус $0.38 при первом заходе через бота).

⚠️ Перевыпуск токена немедленно деактивирует предыдущий.

🆕 Authoritative API v2 — обзор

Базовый URL

https://ivoque.de/api/v2/

Список эндпоинтов

Лимиты

V2: POST /api/v2/submissions

Создаёт новый submission. Принимает либо JSON с массивом links, либо multipart/form-data с полем file field. Лимита на количество ссылок в одном запросе нет — большие пачки разрезаются на части по 5 000 на сервере. Баланс проверяется сразу за весь submission.

Параметры тела

Пример запроса

curl -X POST https://ivoque.de/api/v2/submissions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "links": ["https://example.com/p1", "https://example.com/p2"],
    "queue": "slow",
    "client_batch_id": "weekly-2026-04-28",
    "external_id": "client-job-12345",
    "label": "April promo"
  }'

Multipart-вариант (большой .txt)

curl -X POST https://ivoque.de/api/v2/submissions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@./urls.txt" \
  -F "external_id=client-job-12345" \
  -F "queue=slow"

Успешный ответ 202

{
  "status": "ok",
  "submission_id": 4567,
  "parts_total": 1,
  "total_links_received": 2,
  "total_links_accepted": 2,
  "charged_amount": 0.0168,
  "balance_usd": 9.9832,
  "was_cached": false,
  "external_id": "client-job-12345",
  "client_batch_id": "weekly-2026-04-28"
}

V2: GET /api/v2/submissions

Постраничный список submissions аккаунта. Фильтры: status, queue, engine, label, external_id, client_batch_id, date_from/date_to.

curl -s "https://ivoque.de/api/v2/submissions?status=done&date_from=2026-04-01&page=1&per_page=50" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

V2: GET /api/v2/submissions/{id}

Детальная информация по submission: счётчики, processing log, связанные checks и операции баланса, образцы URL. Для пагинации URL: urls_limit (1–50 000), urls_offset.

curl -s https://ivoque.de/api/v2/submissions/4567 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

V2: проверки индексации в Google

Стоимость: $0.0024 / URL (по умолчанию; аккаунты могут иметь индивидуальный тариф). Минимальный баланс для запуска: $1.00. ID проверки префиксированный — a123 (auto post-submission, бесплатная) или m456 (manual paid).

Поставить задачу проверки

curl -X POST https://ivoque.de/api/check-index-task.php \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_TOKEN",
    "links": ["https://example.com/p1"],
    "batch_id": "audit-2026-04-28"
  }'

Список и детали (v2)

curl -s "https://ivoque.de/api/v2/checks?status=completed&per_page=20" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -s "https://ivoque.de/api/v2/checks/m2931?results_per_page=100" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

V2: GET /api/v2/balance/history

Журнал движений баланса (списания и пополнения) с привязкой к submission_id / upload_id. Фильтры: direction (credit/debit), type, submission_id, date_from/date_to.

curl -s "https://ivoque.de/api/v2/balance/history?date_from=2026-04-01&direction=debit&page=1&per_page=50" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

V2: Webhooks

Подписка на события вместо polling. Каждая доставка подписывается HMAC-SHA256 по полному телу запроса. После 10 неудачных попыток (с задержками 0, 1, 2, 4, 8, 16, 32, 60, 60, 60 мин) доставка помечается dead.

Создать подписку

curl -X POST https://ivoque.de/api/v2/webhooks \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.example.com/ivoque",
    "events": ["submission.completed", "check.completed"],
    "description": "Ops alerts"
  }'

Ответ 201

{
  "status": "ok",
  "id": 12,
  "url": "https://hooks.example.com/ivoque",
  "events": ["submission.completed", "check.completed"],
  "is_active": true,
  "secret": "save-me-now-not-shown-again"
}

Legacy v1: link-submit.php

Медленный пул Google + Bing. До 5 000 ссылок за запрос. Без auto-split, без идемпотентности. Для новых интеграций предпочитайте POST /api/v2/submissions.

curl -X POST https://ivoque.de/api/link-submit.php \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_TOKEN",
    "links": ["https://example.com/p1"]
  }'

Legacy v1: link-submit-yandex.php

Только Яндекс. До 5 000 ссылок за запрос.

curl -X POST https://ivoque.de/api/link-submit-yandex.php \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_API_TOKEN","links":["https://example.com/p1"]}'

Legacy v1: link-submit-fast.php

Приоритетная индексация через Google Indexing API — результат в течение минут. Перед использованием убедитесь, что на балансе достаточно средств.

curl -X POST https://ivoque.de/api/link-submit-fast.php \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_API_TOKEN","links":["https://example.com/important-page"]}'

Legacy v1: balance.php

Текущий баланс, цена за ссылку, доступное количество ссылок.

curl -s "https://ivoque.de/api/balance.php?api_key=YOUR_API_TOKEN"

Legacy v1: check-and-reindex.php

Проверка индексации в Google + автоматическая переотправка непроиндексированных URL обратно в обычный пул. Для новых интеграций используйте v2: /api/v2/submissions с подпиской на submission.completed + ручная re-submission.

Цены и лимиты

Аккаунты с большими объёмами могут запросить индивидуальный тариф у @Inderixing.

Коды ошибок

HTTP статусы

Стабильные коды ошибок

MCP интеграция для AI-агентов

Тот же REST API доступен через Model Context Protocol — подключите NeuralIndexer прямо в Claude Desktop, Cursor, Windsurf или ChatGPT, и AI-агент сможет отправлять ссылки и проверять индексацию из чата без кода.