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

Інтегруйте сервіси SpeedyIndex безпосередньо у свій робочий процес.

                    Base URL: https://app.speedyindex.com
            

Потрібен вебінтерфейс? Скористайтеся кабінетом масового чекера індексу Google для ручного подання URL і візуальних звітів.

Автентифікація
Перевірити баланс
Створити завдання
Список завдань
Статус завдання
Повний звіт
Перевірка беклінків
Звіт по беклінках
Одне посилання
Створити рахунок

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

API (Application Programming Interface) — програмний інтерфейс для автоматизації роботи з сервісом. Інтеграція дає змогу програмно створювати завдання й отримувати звіти, заощаджуючи час на рутині. Якщо є питання щодо інтеграції чи методів запитів, підтримка завжди на зв’язку: @alexspeedyindex

Завантажити PDF

Автентифікація

Щоб автоматизувати індексацію в Google і перевірку беклінків, усі запити до API потребують дійсного API-ключа. Індивідуальний ключ є в налаштуваннях Telegram-бота або в особистому кабінеті.

        Приклад заголовка
        Authorization: YOUR_API_KEY
    

GET /v2/account

Перевірити баланс

Повертає поточний баланс: токени, кредити індексатора та чекера.

Приклад відповіді

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

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

Створити нове завдання

Програмно надсилайте списки URL на індексацію або перевірку.

Параметр (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 доступний лише цей режим (має бути `true`). Вартість — 100 токенів/URL; токени за непроіндексовані посилання повертаються автоматично. Для Yandex увімкнено за замовчуванням.
drip_feed	boolean	Увімкнути поступове подання URL (крапельне індексування).
drip_feed_days	integer	Кількість днів крапельного режиму (від 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/task/backlink/checker/create

Створити завдання перевірки беклінків

Програмно перевіряйте сторінки-донори на беклінки на ваші цільові домени. Підтримується повний рендеринг JavaScript.

Вартість: 1 URL донора = 2 токени.

Параметр тіла (JSON)	Опис
urls	Масив URL донорів для перевірки (макс. 10 000)
target_domains	Масив ваших доменів для пошуку (наприклад, ["mysite.com"])

curl -X POST -H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"urls":["https://donor1.com/page"],"target_domains":["mydomain.com"]}' \
https://api.speedyindex.com/v2/task/backlink/checker/create
                        

POST /v2/task/backlink/checker/report

Звіт перевірки беклінків

Детальний аналіз по донору: DA, spam score, статус індексації, знайдені цільові посилання.

curl -X POST -H "Authorization: YOUR_KEY" -H 'Content-Type: application/json' \
-d '{"task_id":"...", "page":0, "limit":50}' \
https://api.speedyindex.com/v2/task/backlink/checker/report
                        

POST /v2/<SEARCH ENGINE>/url

Проіндексувати одне посилання

Зручно для крапельного подання посилань. SEARCH_ENGINE: google, yandex.

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

POST /v2/account/invoice/create

Створити рахунок на оплату

Параметр	Опис
price	Ціна пакета в USD (5, 20, 50, 100, 250, 500)
method	`crypto`, `paypal`, `yookassa`
email	Обов’язково лише для Yookassa

curl -X POST -H "Authorization: YOUR_KEY" -H 'Content-Type: application/json' \
-d '{"price":50, "method":"crypto"}' \
https://api.speedyindex.com/v2/account/invoice/create
                        

У відповіді повертається URL посилання на оплату.