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

API SOROKA: чтение Telegram и ВКонтакте, подписки на события, долгие задачи с файлом результата. Всё — по одному ключу, JSON поверх HTTPS.

Любой запрос с ключом — действие вашей организации на условиях Пользовательского соглашения: источники и цели сбора выбираете вы и отвечаете за законность сбора и использования данных; сбор персональных данных запрещён.

Быстрый стартКлюч → первый запрос → задача → вебхук за 5 минут. СправочникКаждый путь: поля, ответ, пример на curl и Python. ОсновыКлючи и права, форматы, пагинация, задачи и подписки. ОшибкиЧто значит каждый ответ и что делать. Лимиты и кредитыЛимит в минуту, квоты, цена записи, 402. ВебхукиСобытия на ваш адрес и проверка подписи.

Как это устроено

Разовый запрос — карточка канала, последние посты, метод ВКонтакте: ответ сразу. Платите за полученные записи.
Задача — долгий сбор (посты за период, поиск по словам): ставите задачу, узнаёте цену заранее, забираете файл json, csv или xlsx.
Подписка — новые публикации из списка каналов: потоком, страницами или на ваш вебхук с подписью.

Адрес

https://soroka.tools/v1

Машиночитаемая схема: /v1/openapi.json (OpenAPI 3.1, без ключа) — подойдёт для генераторов клиентов и Postman.