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 у закритій беті. Попросіть доступ, щоб відкрити робочий простір.