ShareTo API
Публикуйте из своего кода
Один REST API, чтобы подключать аккаунты и публиковать или планировать посты в Instagram, Facebook, YouTube, LinkedIn и TikTok. Создавайте столько API-ключей, сколько нужно.
Базовый адресhttps://shareto.social/api/v1
Аутентификация
Создайте ключ в Настройках, раздел API, и отправляйте его как Bearer-токен в каждом запросе. Ключей может быть сколько угодно, каждый показывается один раз, и его можно отозвать в любой момент.
curl https://shareto.social/api/v1/accounts \ -H "Authorization: Bearer st_live_..."Подключение аккаунта
Запросите ссылку для подключения и откройте её в браузере или отправьте владельцу аккаунта. Он даёт разрешение на платформе и возвращается на ваш redirectUrl. Ссылка действует 30 минут.
curl -X POST https://shareto.social/api/v1/accounts/connect \ -H "Authorization: Bearer st_live_..." \ -H "Content-Type: application/json" \ -d '{ "platform": "tiktok", "redirectUrl": "https://example.com/done" }' # 201 { "data": { "url": "https://shareto.social/api/connect/tiktok?t=...", "expiresAt": "2026-11-10T10:30:00.000Z" } }Загрузка медиа
Получите разрешение на загрузку и отправьте файл методом PUT на putUrl. Большие видео можно докачивать через tus. Используйте полученный url в посте.
curl -X POST https://shareto.social/api/v1/uploads \ -H "Authorization: Bearer st_live_..." \ -H "Content-Type: application/json" \ -d '{ "filename": "launch.mp4", "contentType": "video/mp4" }' curl -X PUT "$PUT_URL" \ -H "Authorization: Bearer $UPLOAD_TOKEN" \ -H "Content-Type: video/mp4" \ --data-binary @launch.mp4Публикация или планирование
Отправьте текст, медиа и идентификаторы аккаунтов. Оставьте scheduledAt пустым, чтобы опубликовать сразу, или укажите время в формате ISO, чтобы запланировать. У каждого аккаунта свой статус.
curl -X POST https://shareto.social/api/v1/posts \ -H "Authorization: Bearer st_live_..." \ -H "Content-Type: application/json" \ -d '{ "kind": "reel", "caption": "Behind the scenes", "media": [{ "url": "$MEDIA_URL", "type": "video" }], "accountIds": ["$ACCOUNT_ID"], "scheduledAt": "2026-11-12T09:00:00Z" }'
Эндпоинты
| Метод | Путь | Что делает |
|---|---|---|
| GET | /accounts | Список подключённых аккаунтов |
| GET | /accounts/{id} | Получить один аккаунт |
| POST | /accounts/connect | Создать ссылку для подключения платформы |
| DELETE | /accounts/{id} | Отключить аккаунт и отменить его запланированные посты |
| POST | /uploads | Получить одноразовое разрешение на загрузку файла |
| POST | /posts | Опубликовать сразу или запланировать пост |
| GET | /posts?ids=a,b | Получить последние 50 постов или те, что указаны в ids |
| GET | /posts/{id} | Получить пост со статусом каждого аккаунта |
| DELETE | /posts/{id} | Удалить пост, который ещё не опубликован |
Способы подключения
Аккаунт подключается через Zernio, партнёрский API для публикаций, чьи приложения платформы одобрили для публичных постов, или напрямую через собственные приложения ShareTo. Передайте connection со значением auto, zernio или direct; auto выбирает способ для каждой платформы.
Ошибки
Ошибки приходят в JSON с полем message: 401, если ключа нет или он неверный, 404, если записи нет в вашем рабочем пространстве, 422, если запрос нарушает правило платформы. Сообщение подскажет, что изменить.
ShareTo в закрытой бете. Запросите доступ, чтобы открыть рабочее пространство.