Документация и руководства

Как это работает

1. Ваш сервер отправляет в IndexLaunch список URL страниц, подписанный вашим API-ключом.
2. IndexLaunch проверяет каждый URL, списывает по одному кредиту за URL и отправляет его поисковым системам на сканирование. В ответ вы получаете по одному ID на каждый URL.
3. По этим ID можно в любой момент проверить статус каждого URL.

Настройка за 4 шага

1. Войдите и создайте ключ в разделе Настройки → Доступ к API. Он показывается только один раз, поэтому сразу скопируйте его.
2. Сохраните ключ как секретную переменную окружения на сервере или в CI, например INDEXLAUNCH_API_KEY. Никогда не размещайте его в браузерном коде или публичном репозитории.
3. Подтвердите каждый домен, URL которого будете отправлять (Settings → Domain Verification). Поисковые системы отклоняют URL неподтверждённых сайтов.
4. Вызывайте API со своего бэкенда, из скрипта или конвейера деплоя. Примеры ниже готовы к копированию.

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

Передавайте ключ в заголовке Authorization каждого запроса в виде Bearer YOUR_KEY. Все запросы используют HTTPS и JSON.

Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

Отправка URL

Отправляйте до 500 полных URL (начинающихся с https://) за один запрос. Каждый URL стоит один кредит. В ответе — по одному ID на каждый URL в том же порядке, в котором вы их отправили.

POST https://www.indexlaunch.site/api/v1/submit
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{ "urls": ["https://example.com/page-1", "https://example.com/page-2"] }

200 OK
{ "submitted": 2, "ids": ["j57...", "j58..."] }

Проверка статуса URL

Передайте ID из ответа на отправку. Вы можете просматривать только URL, отправленные с вашего аккаунта.

GET https://www.indexlaunch.site/api/v1/urls/j57...
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

200 OK
{
  "id": "j57...",
  "url": "https://example.com/page-1",
  "status": "indexed",
  "submittedAt": 1757740800000,
  "indexedAt": 1757741100000
}

Поля ответа

id

ID отправки.

url

Отправленный вами URL.

status

Одно из значений статуса ниже.

submittedAt

Время отправки в миллисекундах с начала эпохи Unix.

indexedAt

Время, когда поисковые системы приняли URL. До этого момента отсутствует.

Значения статуса

pending

Получен и ожидает отправки. Большинство URL проходят дальше в течение нескольких минут.

indexed

Принят поисковыми системами и поставлен в очередь на сканирование. В панели управления отображается как «Submitted». Это ещё не подтверждает, что страница проиндексирована.

failed

Поисковые системы не приняли URL — чаще всего потому, что домен не подтверждён. Кредит возвращается автоматически.

refunded

URL завис более чем на 7 дней, поэтому кредит был возвращён автоматически.

Примеры кода

curl -X POST https://www.indexlaunch.site/api/v1/submit \
  -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/new-post"]}'

const res = await fetch("https://www.indexlaunch.site/api/v1/submit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INDEXLAUNCH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    urls: ["https://example.com/new-post", "https://example.com/pricing"],
  }),
});

const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(`Submitted ${data.submitted} URLs`, data.ids);

import os
import requests

res = requests.post(
    "https://www.indexlaunch.site/api/v1/submit",
    headers={"Authorization": f"Bearer {os.environ['INDEXLAUNCH_API_KEY']}"},
    json={"urls": ["https://example.com/new-post"]},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"])
print(data["submitted"], data["ids"])

# .github/workflows/indexlaunch.yml
name: Submit new pages
on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  submit:
    runs-on: ubuntu-latest
    steps:
      - name: Send changed URLs to IndexLaunch
        env:
          INDEXLAUNCH_API_KEY: ${{ secrets.INDEXLAUNCH_API_KEY }}
        run: |
          curl --fail-with-body -X POST https://www.indexlaunch.site/api/v1/submit \
            -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{"urls": ["https://example.com/new-post"]}'

Ошибки

При ошибке возвращается JSON с полем error, содержащим сообщение, которое можно показать пользователю или записать в лог.

400

Неверный запрос: в теле нет списка urls, какой-то URL недействителен, отправлено больше 500 URL, недостаточно кредитов или запросы поступают слишком часто.

401

Ключ отсутствует, неверен или отозван.

403

Аккаунт заблокирован.

404

В вашем аккаунте нет отправки с таким ID.

Рекомендации

• Отправляйте только новые или изменённые страницы, а не весь сайт при каждом деплое.
• Объединяйте URL в один запрос вместо отдельного запроса для каждого URL.
• Если вы получили «Too many requests» или сообщение о превышении лимита, подождите минуту и повторите попытку. Точные лимиты вашего аккаунта указаны в разделе Настройки → Доступ к API.
• Если ключ утёк, отзовите его в настройках и создайте новый. Отозванные ключи перестают работать сразу.