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

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

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

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

Аутентификация
Баланс
Создать задачу
Список задач
Статус задачи
Полный отчет
Одна ссылка
VIP-очередь
Создать счет
Цены

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

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

Скачать PDF

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

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

                        Header

                        Authorization: <API KEY>

GET /v2/account

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

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

Пример ответа

{
  "code": 0,
  "balance": {
    "indexer": 10014495,
    "checker": 100732
  }
}
                        

POST /v2/task/<SEARCH ENGINE>/<TASK TYPE>/create

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

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

Параметр (в URL)	Описание
SEARCH ENGINE	`google`, `yandex` или `bing` Примечание: Bing поддерживает ТОЛЬКО тип задачи `checker`. Индексатор для Bing недоступен.
TASK TYPE	`indexer` (индексация) или `checker` (проверка индексации)

Параметр тела (JSON)	Тип	Описание
title	string	Название задачи (опционально)
urls	array	Список ссылок. Максимум 10 000 ссылок на один запрос.
pay_per_indexed	boolean	Режим «Оплата за результат». Критически важно: Для Google Indexer доступен только этот режим (должно быть `true`). Стоимость — 100 токенов/URL, средства за непроиндексированные ссылки возвращаются автоматически. Для Yandex включен по умолчанию.
drip_feed	boolean	Включить постепенную подачу ссылок (Drip Feed).
drip_feed_days	integer	Количество дней для Drip Feed (от 2 до 30). Ограничение: Общее количество `urls` должно быть больше или равно количеству дней.

Пример запроса (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"], "pay_per_indexed": true, "drip_feed": true, "drip_feed_days": 2}' \
https://api.speedyindex.com/v2/task/google/indexer/create
                        

Коды ответов

0: Успешно
1: Пополните баланс (недостаточно средств)
2: Ошибка валидации (например, неверные параметры)

GET /v2/task/<SEARCH ENGINE>/list/<PAGE>

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

Пагинация начинается с 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,
      "pay_per_indexed": true,
      "drip_feed": false,
      "drip_feed_days": 0,
      "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-ссылка на оплату.