API ДЛЯ СОЦСЕТЕЙ · REST

API соцсетей для разработчиков

Один REST API для публикации, расписания и управления постами в 16 соцсетях — из вашего продукта, бэкенда или сценария автоматизации. JSON по HTTPS, Bearer-ключ и спецификация OpenAPI 3.

Пост не ушёл? GET /posts?status=failed покажет его, а POST /posts/retry-all-failed переотправит всё одним вызовом.
или посмотрите весь сценарий
7 дней бесплатно Без карты Отмена в любое время
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
} }
POST /posts publish_at — в часовом поясе аккаунта
Не за каждый аккаунт

Счёт не растёт вместе с числом клиентов. Платите за тариф, а не за каждый подключённый профиль.

На любом тарифе

Без отдельного developer-плана. API работает на триале, без карты.

Черновик, расписание или сразу

Один эндпоинт, три режима: is_draft: true, publish_now: true или publish_at. Случайно ничего не опубликуется.

Вызывайте из любого HTTP-клиента

curl
Node.js
Python
PHP
Go
n8n
Make
Zapier
Официальные интеграции площадок

Клиенты подключают аккаунты через OAuth: без общих паролей и без своего Meta-приложения.

Как устроен каждый запрос

Авторизация
Authorization: Bearer op_…

Личный ключ из «Настройки → API Keys»: op_ и 64 hex-символа. Показывается один раз при создании и хранится только в виде хеша.

Ответы
{ "data": … }

Каждый успешный ответ — JSON в конверте data. POST /posts возвращает 201 и созданный пост.

Пагинация
?page=1&limit=20 → meta

Списки принимают page и limit (до 100) и возвращают meta с total, page, limit и pages.

Лимиты
X-RateLimit-Remaining

В каждом ответе есть X-RateLimit-Limit, -Remaining и -Reset: можно распределять запросы заранее, а не узнавать о лимите по 429.

Запланировать пост — три вызова

Узнайте часовой пояс аккаунта и дату окончания тарифа, выберите профили и создайте пост. publish_at — в формате "Y-m-d H:i" по времени аккаунта.

1 GET /account
timezone, plan_end_at
2 GET /profiles
ID профилей
3 POST /posts
is_draft · publish_now · publish_at

Ответы, которые легко разбирать

Списки приходят с 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, тот же запрос повторять не нужно.

Код
Когда
Что делать
400
Неверный параметр запроса, например publish_after
Исправить запрос
401
API-ключа нет или он неверный
Проверить заголовок Authorization
404
Профиль или пост не найден в этом аккаунте
Проверить ID
422 plan_expired
Подписка закончилась
Продлить тариф, не повторять
422 publish_date_after_plan
publish_at позже окончания тарифа
Выбрать дату раньше
422 publish_date_invalid
publish_at — недопустимое время публикации
Передать "Y-m-d H:i" по времени аккаунта
422 post_empty
В посте нет текста, медиа или опроса
Добавить контент
422 validation_error
Ошибка в другом поле, см. error.field
Смотреть на retryable
429
Превышен лимит запросов
Подождать до X-RateLimit-Reset

Эндпоинты на весь цикл поста

Что нужно
Эндпоинт
Часовой пояс и дата окончания тарифа
GET /account
Подключённые профили
GET /profiles
Поддерживаемые площадки
GET /profiles/platforms
Медиа по URL (до 10)
media_urls в POST /posts
Медиа файлом
POST /media/upload-url · POST /media/upload
Черновик, расписание или публикация сразу
POST /posts
Список постов с фильтрами
GET /posts?status=…&profile_id=…
Изменить или удалить пост
PUT /posts/{id} · DELETE /posts/{id}
Опубликовать черновик сразу
POST /posts/{id}/publish
Переотправить упавшие посты
POST /posts/{id}/retry · POST /posts/retry-all-failed
Аналитика
GET /analytics/{id}/overview · /top-posts · /best-time

16 каналов из одной интеграции — включая рунет

Один слой интеграции для всех каналов, где публикуются ваши клиенты.

Старт за пять минут

1 Создайте API-ключ в «Настройки → API Keys». Скопируйте сразу: он показывается только один раз.
2 Вызовите GET /account, чтобы узнать timezone и plan_end_at, затем GET /profiles — за ID профилей.
3 Вызовите POST /posts с is_draft, publish_now или publish_at.
base URL
https://api.onlypult.com/v1
спецификация OpenAPI
https://onlypult.com/dev/openapi.yaml

Две частые ошибки: передавать publish_at в UTC ISO-8601 вместо "Y-m-d H:i" по времени аккаунта и повторять запрос после 422 с retryable: false. Обе исправляются за минуту.

API на любом тарифе. Без платы за доступ.

Без наценки за developer-план, без платы за каждый подключённый профиль, триал не обрывается, когда вы создаёте ключ. Программный доступ включён везде — от триала до старших тарифов.

Не за каждый аккаунт

Счёт не растёт с каждым подключённым профилем.

Без отдельного 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 дней бесплатно · без карты

Попробовать бесплатно