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

Интегрируйте сервисы SpeedyIndex напрямую в свои рабочие процессы.

Базовый URL: https://api.speedyindex.com

Ищете веб-интерфейс SpeedyIndex? Тогда используйте веб-версию для ручной отправки ссылок на индексацию и проверку на индекс и получения отчетов.

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

API (Application Programming Interface) — это программный интерфейс для автоматизации работы с нашим сервисом. Интеграция позволит вам программно создавать задачи и получать отчеты, экономя время на рутинных операциях. Если у вас возникнут вопросы по интеграции или методам запросов, наша поддержка всегда на связи: @alexspeedyindex.

Скачать PDF

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

Все запросы к API требуют наличия API-ключа. Вы можете получить API-ключ в настройках Telegram-бота или в личном кабинете веб-версии.

Header
Authorization: <API KEY>
GET

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

Возвращает ваш текущий баланс для сервисов индексации и проверки.

Пример ответа
{ "code": 0, "balance": { "indexer": 10014495, "checker": 100732 } }
POST

Создать новую задачу

Программная отправка списка URL для индексации и проверки на индекс в Google, Bing, Yandex. Используйте API-версию для автоматизации создания заданий.

Параметр (в URL) Описание
SEARCH ENGINE google или yandex
TASK TYPE indexer (индексация) или checker (проверка индексации)
Параметр тела (JSON) Тип Описание
title string Название задачи (опционально)
urls array Список ссылок. Максимум 10 000 ссылок на один запрос.
Пример запроса (cURL)
curl -X POST -H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \ -d '{"title":"test title", "urls":["https://google.com", "https://site.com/page1"]}' \ https://api.speedyindex.com/v2/task/google/indexer/create
Коды ответов
  • 0: Успешно
  • 1: Пополните баланс (недостаточно средств)
  • 2: Сервер перегружен (попробуйте позже)
GET

Получить список задач

Пагинация начинается с 0. Каждая страница содержит 1000 задач. Сортировка от новых к старым.

Пример ответа
{ "code": 0, "page": 0, "last_page": 5, "result": [ { "id": "65f8c7315752853b9171860a", "size": 690, "processed_count": 690, "indexed_count": 279, "title": "batch1.txt", "type": "google/checker", "is_completed": true, "created_at": "2024-03-18T22:58:56.901Z" } ] }
POST /v2/task/<SEARCH ENGINE>/<TASK TYPE>/status

Получить статус конкретных задач

Тело запроса должно содержать task_ids (массив строк). Лимит: 1000 ID.

curl -X POST -H "Authorization: YOUR_KEY" -H 'Content-Type: application/json' \ -d '{"task_ids":["65f8c7305759855b9171860a"]}' \ https://api.speedyindex.com/v2/task/google/indexer/status
POST /v2/task/<SEARCH ENGINE>/<TASK TYPE>/fullreport

Скачать полный отчет

Возвращает список проиндексированных и непроиндексированных ссылок.

Примечание по кодам ошибок (только google/indexer):

  • -1: Найден метатег 'noindex'
  • 0: Ошибок нет
  • 404, 502 и т.д.: HTTP-код состояния, возвращенный страницей
curl -X POST -H "Authorization: YOUR_KEY" -H 'Content-Type: application/json' \ -d '{"task_id":"67f542b1e86b8c3b8ffac1a6"}' \ https://api.speedyindex.com/v2/task/google/indexer/fullreport
POST /v2/<SEARCH ENGINE>/url

Индексация одной ссылки

Полезно для порционной подачи ссылок или индивидуального тестирования.

curl -X POST -H 'Authorization: YOUR_KEY' -H 'Content-Type: application/json' \ -d '{"url":"https://google.com"}' \ https://api.speedyindex.com/v2/google/url

Возвращает {"code": 0} при успехе.

POST /v2/task/google/indexer/vip

VIP-очередь (только Google Indexer)

Добавить задачу в приоритетную очередь.
Лимит: только для задач с количеством ссылок ≤ 100.

Стоимость: это платная услуга. 1 ссылка = 1 дополнительный кредит.

Гарантия: Googlebot посетит страницу в течение 1–10 минут. Если задача не будет выполнена в течение 5 минут, средства автоматически вернутся на баланс.

curl -X POST -H "Authorization: YOUR_KEY" -H 'Content-Type: application/json' \ -d '{"task_id":"680222ce0428e10a6b16bf72"}' \ https://api.speedyindex.com/v2/task/google/indexer/vip
POST /v2/account/invoice/create

Создать счет на оплату

Параметр Описание
qty Количество ссылок (кредитов) для покупки
type indexer, checker или mix
method crypto, paypal, yookassa
email Требуется только для ЮKassa
curl -X POST -H "Authorization: YOUR_KEY" -H 'Content-Type: application/json' \ -d '{"qty":10000, "method":"crypto", "type":"indexer"}' \ https://api.speedyindex.com/v2/account/invoice/create

В ответе возвращается URL-ссылка на оплату.