Главная/Документация

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

Простой REST API: отправьте капчу — заберите ответ. Любой язык, любой стек скрапинга. Базовый URL — https://api.glidercap.com/v1.

Начало работы

Работа с Glidercap строится в два шага: вы создаёте задачу (отправляете капчу) и затем опрашиваете результат по её идентификатору. Подключение занимает около 5 минут.

Зарегистрируйтесь и получите API-ключ в личном кабинете.
Отправьте капчу методом POST /v1/captcha.
Заберите ответ методом GET /v1/captcha/{id}, когда статус станет ready.

💡

Текстовые капчи — бесплатно. Списание происходит только за успешно решённые SmartCaptcha — 1,8 ₽ за 1000.

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

Все запросы авторизуются по API-ключу в заголовке Authorization по схеме Bearer:

HEADERAuthorization: Bearer YOUR_API_KEY

Ключ привязан к балансу аккаунта. Не публикуйте его в клиентском коде — храните на стороне сервера.

Создать задачу

POSThttps://api.glidercap.com/v1/captcha

Отправляет капчу в обработку. В ответ приходит идентификатор задачи id.

{
  "type": "smartcaptcha",
  "sitekey": "ysc1_xxxxxxxx",
  "url": "https://site.ru/page"
}

{ "id": "a1b2c3d4", "status": "pending" }

Получить результат

GEThttps://api.glidercap.com/v1/captcha/{id}

Опрашивайте задачу с интервалом 1–2 секунды, пока статус не станет ready (готово) или failed (не решена).

{
  "id": "a1b2c3d4",
  "status": "ready",
  "token": "dD0x...ysc"
}

Для текстовых капч ответ возвращается в поле text.

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

Поле	Тип	Описание
`type` required	string	Тип капчи: `smartcaptcha` или `textcaptcha`.
`sitekey`	string	Для SmartCaptcha — ключ виджета (начинается с `ysc1_`).
`url`	string	Для SmartCaptcha — адрес страницы, где показана капча.
`image`	string	Для TextCaptcha — изображение капчи в base64.

Типы капч

type	Описание	Точность	Цена
`smartcaptcha`	Клик-капча (SmartCaptcha)	99,7%	1,8 ₽ / 1000
`textcaptcha`	Текстовая капча: цифры, кириллица, латиница	99,9%	бесплатно

Коды ошибок

HTTP	code	Что значит
401	`invalid_key`	Неверный или отсутствующий API-ключ.
402	`no_balance`	Недостаточно средств на балансе.
422	`bad_request`	Не хватает обязательного параметра или неверный формат.
404	`not_found`	Задача с таким `id` не найдена.
429	`rate_limited`	Слишком много запросов — снизьте частоту опроса.

Примеры кода

Полный цикл «отправить → дождаться → забрать» на популярных языках:

# 1. Отправить капчу
curl -X POST https://api.glidercap.com/v1/captcha \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"type":"smartcaptcha","sitekey":"ysc1_...","url":"https://site.ru"}'
# → {"id":"a1b2c3d4"}

# 2. Забрать результат
curl https://api.glidercap.com/v1/captcha/a1b2c3d4 \
  -H "Authorization: Bearer YOUR_API_KEY"
# → {"status":"ready","token":"..."}

import requests, time

API = "YOUR_API_KEY"
H = {"Authorization": f"Bearer {API}"}

task = requests.post("https://api.glidercap.com/v1/captcha", headers=H,
    json={"type": "smartcaptcha", "sitekey": "ysc1_...",
          "url": "https://site.ru"}).json()["id"]

while True:
    r = requests.get(f"https://api.glidercap.com/v1/captcha/{task}", headers=H).json()
    if r["status"] == "ready":
        print(r["token"]); break
    time.sleep(1)

const API = "YOUR_API_KEY";
const H = { Authorization: `Bearer ${API}`, "Content-Type": "application/json" };

const { id } = await (await fetch("https://api.glidercap.com/v1/captcha", {
  method: "POST", headers: H,
  body: JSON.stringify({ type: "smartcaptcha", sitekey: "ysc1_...", url: "https://site.ru" })
})).json();

// опрашиваем задачу, пока status !== "ready"
const res = await (await fetch(`https://api.glidercap.com/v1/captcha/${id}`, { headers: H })).json();
console.log(res.token);

🛟

Нужна помощь с интеграцией? Напишите в Telegram @It_techai — поможем подключиться.

Подключите API за 5 минут

Получите ключ в личном кабинете и отправьте первую капчу прямо сегодня.

Получить API-ключ Написать в Telegram