Перейти к основному содержанию
shareto

ShareTo API

Публикуйте из своего кода

Один REST API, чтобы подключать аккаунты и публиковать или планировать посты в Instagram, Facebook, YouTube, LinkedIn и TikTok. Создавайте столько API-ключей, сколько нужно.

Базовый адресhttps://shareto.social/api/v1

  1. Аутентификация

    Создайте ключ в Настройках, раздел API, и отправляйте его как Bearer-токен в каждом запросе. Ключей может быть сколько угодно, каждый показывается один раз, и его можно отозвать в любой момент.

    curl https://shareto.social/api/v1/accounts \
      -H "Authorization: Bearer st_live_..."
  2. Подключение аккаунта

    Запросите ссылку для подключения и откройте её в браузере или отправьте владельцу аккаунта. Он даёт разрешение на платформе и возвращается на ваш 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" } }
  3. Загрузка медиа

    Получите разрешение на загрузку и отправьте файл методом 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
  4. Публикация или планирование

    Отправьте текст, медиа и идентификаторы аккаунтов. Оставьте 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 в закрытой бете. Запросите доступ, чтобы открыть рабочее пространство.