API для разработчиков
Автоматизируйте SMM программно. 8 групп эндпоинтов, 12 платформ, подключение к AI‑агентам через MCP.
REST API
Base URL: https://publpost.ru/api/v1
Posts
Создание, редактирование, публикация, дублирование постов
Accounts
Список подключённых соцсетей, отключение
Media
Загрузка изображений/видео, импорт по URL, управление файлами
Labels
Метки для организации постов по категориям и темам
Campaigns
UTM-шаблоны для автоматической разметки ссылок
Comments
Единый Inbox: чтение, ответы, модерация комментариев
Analytics
Сводная статистика, метрики постов и аккаунтов
AI
ExclusiveГенерация текста, подписей и изображений через AI
Примеры кода
Создайте запланированный пост на любом языке
curl -X POST "https://publpost.ru/api/v1/posts" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": 12,
"content": [{
"text": "Post Once. Publish everywhere. 🚀",
"media": []
}],
"schedule_type": "schedule",
"date": "2026-04-20",
"time": "15:00",
"timezone": "Europe/Moscow"
}'MCP Server
19 инструментов для AI-агентов — Claude, Cursor, Windsurf и других
Что умеет MCP
MCP-сервер PublPost реализует инструменты, повторяющие API v1. AI-ассистенты управляют контентом через структурированные действия.
- Workspaces — контекст и подключённые аккаунты
- Posts — создание, планирование, обновление, удаление
- Comments — Inbox: чтение, ответы, модерация, скрытие
- Analytics — сводка, метрики, синхронизация
- Labels & Campaigns — организация контента
Параметры подключения
| URL | https://publpost.ru/mcp |
| Транспорт | Streamable HTTP |
| Авторизация | Bearer YOUR_TOKEN |
claude mcp add --transport http postpilot https://publpost.ru/mcp \
--header "Authorization: Bearer YOUR_TOKEN_HERE"Аутентификация
Все запросы авторизуются через Bearer-токен
Как получить ключ
- Войдите в PublPost
- Откройте Настройки → API-интеграции
- Нажмите «Создать» и выберите области доступа
- Скопируйте ключ — он покажется только один раз
Authorization: Bearer YOUR_API_TOKENОбласти доступа (abilities)
При создании токена выберите нужные abilities — они ограничивают, какие эндпоинты доступны:
workspacesaccountslabelscampaignspostscommentsanalyticsaiОбращайтесь с токенами как с паролями от продакшена. Они могут публиковать посты, удалять контент и отключать аккаунты. Храните в переменных окружения.
Формат ответов
JSON со стандартными HTTP-кодами статуса
Успешный ответ
{
"data": {
"id": "post_abc123",
"text": "Post Once. Publish everywhere. 🚀",
"status": "scheduled",
"schedule_at": "2026-04-20T15:00:00+03:00",
"accounts": [...]
}
}Ошибка
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Поле content обязательно",
"details": [
{ "field": "content", "rule": "required" }
]
}
}Лимиты
60 запросов в минуту на один API-ключ
| Заголовок | Описание |
|---|---|
| X-RateLimit-Limit | Общее количество запросов в текущем окне |
| X-RateLimit-Remaining | Оставшиеся запросы в текущем окне |
| X-RateLimit-Reset | UNIX-время сброса окна |
При превышении лимита сервер вернёт 429 Too Many Requests. Дождитесь сброса окна или реализуйте exponential backoff.
12 платформ
Публикуйте через один API во все соцсети
Полная документация
Подробные описания эндпоинтов, параметры, примеры ответов и Try It — в Developer Portal внутри дашборда.
Готовы автоматизировать?
Получите API-ключ за 30 секунд и начните публиковать программно.
Получить API ключ