На главную

Документация API

REST API Индексация — версия 1

Быстрый старт

1. Получите ключ

Доступен на всех тарифах: Личный кабинет → Профиль → Доступ к API.

2. Отправьте URL

Один POST на эндпоинт отправки. До 500 URL за запрос, обработка партиями по 3.

3. Следите за сканированием

История показывает статус каждого URL и хранится 48 часов.

Аутентификация

Защищённые эндпоинты ждут ваш ключ в заголовке Authorization: Bearer. Ключи начинаются с ixru_ и создаются в разделе Личный кабинет → Профиль → Доступ к API.

# API-ключ аутентифицирует каждый запрос
curl https://instantindexacia.com/api/user/credits \
  -H "Authorization: Bearer ixru_ВАШ_API_КЛЮЧ"

Ключ равнозначен паролю: никогда не размещайте его в коде, который уходит в браузер, в публичном репозитории или в URL. Если ключ утёк, перевыпустите его в личном кабинете — старый перестанет работать немедленно.

Ограничения

500

URL за запрос

3 URL

Размер партии

48 часов

Хранение истории

10 зап/с

Частота

Эндпоинты

POST/api/indexing/submitНужен ключ

Отправить URL

Отправляет до 500 URL в Google. Они ставятся в очередь и обрабатываются партиями по 3.

Тело запроса

{
  "urls": [
    "https://vash-sait.ru/stranica-1",
    "https://vash-sait.ru/stranica-2",
    "https://vash-sait.ru/stranica-3"
  ]
}

Ответ

{
  "success": true,
  "submitted": 3,
  "failed": 0,
  "creditsUsed": 3,
  "remainingCredits": 61,
  "results": [
    { "url": "https://vash-sait.ru/stranica-1", "status": "submitted" },
    { "url": "https://vash-sait.ru/stranica-2", "status": "submitted" },
    { "url": "https://vash-sait.ru/stranica-3", "status": "submitted" }
  ]
}

Ошибки

  • 400Не передан ни один корректный URL
  • 402Недостаточно кредитов
  • 429Слишком много запросов — снизьте частоту
  • 503Сервис индексации недоступен
GET/api/indexing/history?page=1&limit=20Нужен ключ

Получить историю

Возвращает ваши отправки постранично. URL хранятся 48 часов.

Ответ

{
  "submissions": [
    {
      "_id": "abc123",
      "url": "https://vash-sait.ru/stranica-1",
      "status": "submitted",
      "searchEngine": "google",
      "creditsUsed": 1,
      "createdAt": "2026-09-07T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "pages": 3
  }
}

Ошибки

  • 401API-ключ отсутствует или недействителен
GET/api/user/creditsНужен ключ

Проверить баланс

Возвращает остаток кредитов, ваш тариф и стоимость одной отправки.

Ответ

{
  "credits": 80,
  "planName": "Старт",
  "planExpiresAt": "2099-12-31T00:00:00Z",
  "creditCosts": { "credit_cost_url_indexing": 1 }
}

Ошибки

  • 401API-ключ отсутствует или недействителен
GET/api/plansОткрытый

Список тарифов

Возвращает все активные тарифы. Аутентификация не требуется.

Ответ

{
  "plans": [
    {
      "name": "Старт",
      "price": 5,
      "credits": 80,
      "currency": "USD",
      "billingPeriod": "lifetime",
      "features": ["80 кредитов индексации", "…"]
    }
  ]
}

Вопрос по API? Напишите нам — отвечаем в течение 24 часов.