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

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

URL indexing API от IndexBolt позволяет программно отправлять URL в Google на индексацию, отслеживать прогресс обработки и управлять кредитами. Интегрируйте массовую индексацию URL в свои SEO-процессы, плагины WordPress или собственные инструменты.

Базовый URL: https://indexbolt.com/api/v1•JSON-запрос и ответ•Авторизация по Bearer token

Авторизация#

Все запросы к API требуют Bearer token в заголовке Authorization. API-ключи генерируются в настройках панели.

Пример заголовка запроса

Authorization: Bearer ib_your_api_key_here

Важно: API-ключи начинаются с префикса ib_. Храните ключи в секрете — не размещайте их в клиентском коде. На один аккаунт можно создать до 5 API-ключей.

Лимиты запросов#

Лимиты применяются к каждому API-ключу по принципу скользящего окна. При превышении лимита Вы получите код статуса 429.

Эндпоинт	Лимит	Окно
`POST /submit`	10 запросов	60 секунд
`GET /balance`	30 запросов	60 секунд
`GET /submissions, /submissions/:id`	60 запросов	60 секунд

Заголовки ответа X-RateLimit-Remaining и X-RateLimit-Reset показывают Ваше текущее использование.

Обработка ошибок#

Все ошибки возвращаются в едином формате JSON:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}

HTTP-статус	Код	Описание
`400`	`INVALID_INPUT`	Некорректное тело запроса или параметры
`401`	`UNAUTHORIZED`	Отсутствующий или недействительный API-ключ
`402`	`INSUFFICIENT_CREDITS`	Недостаточно кредитов для операции
`403`	`FORBIDDEN`	Email не подтверждён
`404`	`NOT_FOUND`	Ресурс не найден
`429`	`RATE_LIMITED`	Слишком много запросов
`500`	`INTERNAL_ERROR`	Непредвиденная ошибка сервера

Кредиты и цены#

Обычная индексация

1 кредит / URL

Стандартная обработка. URL отправляются в Google на индексацию.

Мгновенная индексация

10 кредитов / URL

Приоритетная обработка для ускоренной индексации.

Кредиты не сгорают. Каждая отправка может содержать от 1 до 1 000 URL. Некорректные URL отфильтровываются и не расходуют кредиты.

Отправка URL#

POST/api/v1/submit10 запр. / 60 с

Отправьте пакет URL на индексацию в Google.

Тело запроса

Параметр	Тип	Обязательный	Описание
`urls`	string[]	Обязательный	Массив URL для индексации (1–1 000)
`indexingType`	string	Обязательный	«normal» или «instant»
`projectId`	string	Опциональный	Связать с проектом
`submissionName`	string	Опциональный	Произвольное имя для отправки

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

cURL

curl -X POST https://indexbolt.com/api/v1/submit \
  -H "Authorization: Bearer ib_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://example.com/page-1",
      "https://example.com/page-2"
    ],
    "indexingType": "normal"
  }'

Ответ — 201 Created

{
  "success": true,
  "data": {
    "submissionId": "sub_abc123",
    "totalUrls": 2,
    "creditsUsed": 2,
    "balanceAfter": 98,
    "invalidUrls": []
  }
}

Валидация URL: URL должны использовать HTTP/HTTPS, быть короче 2 048 символов и указывать на публичные адреса. Приватные/внутренние IP (localhost, 10.x.x.x, 192.168.x.x и т. п.) отклоняются. Дубликаты URL автоматически удаляются.

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

GET/api/v1/submissions60 запр. / 60 с

Получите постраничный список Ваших отправок.

Параметры запроса

Параметр	Тип	Обязательный	Описание
`page`	integer	Опциональный	Номер страницы (по умолчанию: 1)
`pageSize`	integer	Опциональный	Результатов на странице, максимум 100 (по умолчанию: 20)
`status`	string	Опциональный	«queued», «processing», «completed», «partial_failure» или «failed»

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

cURL

curl https://indexbolt.com/api/v1/submissions?page=1&pageSize=10 \
  -H "Authorization: Bearer ib_your_api_key"

Ответ — 200 OK

{
  "success": true,
  "data": {
    "submissions": [
      {
        "id": "sub_abc123",
        "name": "Submission #1",
        "status": "completed",
        "indexingType": "normal",
        "totalUrls": 5,
        "creditsUsed": 5,
        "createdAt": "2025-01-15T10:30:00Z",
        "completedAt": "2025-01-15T11:45:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 45,
      "totalPages": 5
    }
  }
}

Получение отправки#

GET/api/v1/submissions/:id60 запр. / 60 с

Получите полные сведения об отправке, включая статус каждого URL.

Параметры пути

Параметр	Тип	Обязательный	Описание
`id`	string	Обязательный	Идентификатор отправки

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

cURL

curl https://indexbolt.com/api/v1/submissions/sub_abc123 \
  -H "Authorization: Bearer ib_your_api_key"

Ответ — 200 OK

{
  "success": true,
  "data": {
    "id": "sub_abc123",
    "name": "Submission #1",
    "status": "completed",
    "indexingType": "normal",
    "totalUrls": 5,
    "creditsUsed": 5,
    "createdAt": "2025-01-15T10:30:00Z",
    "completedAt": "2025-01-15T11:45:00Z",
    "urls": [
      { "url": "https://example.com/page-1", "status": "completed" },
      { "url": "https://example.com/page-2", "status": "completed" }
    ]
  }
}

Проверка баланса#

GET/api/v1/balance30 запр. / 60 с

Проверьте текущий баланс кредитов.

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

cURL

curl https://indexbolt.com/api/v1/balance \
  -H "Authorization: Bearer ib_your_api_key"

Ответ — 200 OK

{
  "success": true,
  "data": {
    "balance": 98,
    "unit": "credits"
  }
}

Готовы начать?

Создайте аккаунт, получите API-ключ и начните индексировать URL за считанные минуты.

Начать бесплатно Управление API-ключами