API ДЛЯ СОЦСЕТЕЙ · REST
API соцсетей для разработчиков
Один REST API для публикации, расписания и управления постами в 16 соцсетях — из вашего продукта, бэкенда или сценария автоматизации. JSON по HTTPS, Bearer-ключ и спецификация OpenAPI 3.
curl -X POST https://api.onlypult.com/v1/posts \
-H "Authorization: Bearer op_…" \
-H "Content-Type: application/json" \
-d '{
"profile_ids": ["1234", "5678"],
"content": "Launch day is here.",
"media_urls": ["https://cdn.example.com/a.png"],
"publish_at": "2026-07-07 14:00"
}' HTTP/1.1 201 Created
{ "data": {
"id": "abc123",
"status": "scheduled",
"content": "Launch day is here.",
"profile_ids": ["1234", "5678"],
"publish_at": "2026-07-07 14:00",
"published_at": null,
"media": […],
"error": null
} } Счёт не растёт вместе с числом клиентов. Платите за тариф, а не за каждый подключённый профиль.
Без отдельного developer-плана. API работает на триале, без карты.
Один эндпоинт, три режима: is_draft: true, publish_now: true или publish_at. Случайно ничего не опубликуется.
Вызывайте из любого HTTP-клиента
Клиенты подключают аккаунты через OAuth: без общих паролей и без своего Meta-приложения.
Как устроен каждый запрос
Личный ключ из «Настройки → API Keys»: op_ и 64 hex-символа. Показывается один раз при создании и хранится только в виде хеша.
Каждый успешный ответ — JSON в конверте data. POST /posts возвращает 201 и созданный пост.
Списки принимают page и limit (до 100) и возвращают meta с total, page, limit и pages.
В каждом ответе есть X-RateLimit-Limit, -Remaining и -Reset: можно распределять запросы заранее, а не узнавать о лимите по 429.
Запланировать пост — три вызова
Узнайте часовой пояс аккаунта и дату окончания тарифа, выберите профили и создайте пост. publish_at — в формате "Y-m-d H:i" по времени аккаунта.
Ответы, которые легко разбирать
Списки приходят с meta для пагинации. Ошибки валидации возвращают стабильный код, сообщение, поле и флаг retryable.
GET /v1/posts?status=scheduled&page=1&limit=20
{ "data": [
{ "id": "abc123", "status": "scheduled", … }
],
"meta": {
"total": 100, "page": 1,
"limit": 20, "pages": 5
} } HTTP/1.1 422 Unprocessable Entity
{ "error": {
"code": "publish_date_after_plan",
"message": "Cannot schedule posts after your plan end date…",
"retryable": false,
"field": "publish_at"
} } Коды ошибок
400, 401 и 404 возвращают { name, message, code, status }. Ошибки валидации (422) — объект error со стабильным кодом. Если retryable: false, тот же запрос повторять не нужно.
Эндпоинты на весь цикл поста
16 каналов из одной интеграции — включая рунет
Один слой интеграции для всех каналов, где публикуются ваши клиенты.
Старт за пять минут
Две частые ошибки: передавать publish_at в UTC ISO-8601 вместо "Y-m-d H:i" по времени аккаунта и повторять запрос после 422 с retryable: false. Обе исправляются за минуту.
API на любом тарифе. Без платы за доступ.
Без наценки за developer-план, без платы за каждый подключённый профиль, триал не обрывается, когда вы создаёте ключ. Программный доступ включён везде — от триала до старших тарифов.
Счёт не растёт с каждым подключённым профилем.
Включено в тариф, который у вас уже есть.
7 дней бесплатно, без карты, API включён.
Отвечаем на вопросы
В какие соцсети можно публиковать через API?
VK, Telegram, Одноклассники, MAX, Instagram, Facebook, YouTube, TikTok, LinkedIn, Pinterest, Threads, X, WordPress, Google Business Profile и другие — всего 16 каналов. Актуальный список возвращает GET /profiles/platforms.
Можно ли опубликовать пост в несколько профилей одним запросом?
Да. Передайте несколько ID в profile_ids, и пост уйдёт в каждый из них: черновиком, по расписанию или сразу.
Как прикрепить картинки и видео?
Передайте до 10 публичных URL в media_urls — Onlypult скачает файлы сам. Файлы из своего хранилища загрузите через POST /media/upload-url или POST /media/upload и передайте полученные ID в media_ids.
На каких тарифах доступен API?
На любом, включая триал — без отдельного developer-плана и без платы за каждый профиль.
Есть ли MCP-сервер для AI-агентов?
Да. Те же возможности доступны Claude, ChatGPT, Cursor и другим агентам через MCP-сервер Onlypult. Инструкции по подключению — в разделе AI-агентов.
Какие лимиты запросов (rate limits)?
В каждом ответе есть X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset (unix timestamp) для вашего ключа. Распределяйте запросы по этим заголовкам; если пришёл 429, подождите до времени сброса.
Есть ли спецификация OpenAPI?
Да, OpenAPI 3.0 по адресу onlypult.com/dev/openapi.yaml. Из неё можно сгенерировать клиент или импортировать её в Postman или Insomnia. Интерактивный справочник — onlypult.com/dev/api.html.
Как устроена пагинация?
Списки вроде GET /posts принимают page (с 1) и limit (1–100, по умолчанию 20) и возвращают meta с total, page, limit и pages.
В каком формате время для расписания?
publish_at — строка в формате "Y-m-d H:i" по часовому поясу аккаунта, например "2026-07-07 14:00". GET /account возвращает timezone и plan_end_at.
Как версионируется API?
API версионируется (v1) с обратной совместимостью внутри мажорной версии, поэтому ваша интеграция продолжает работать по мере обновлений.
Подключите публикацию к своему коду
На любом тарифе · 7 дней бесплатно · без карты
