ShareTo API
Publiez depuis votre propre code
Une seule API REST pour connecter des comptes et publier ou programmer sur Instagram, Facebook, YouTube, LinkedIn et TikTok. Créez autant de clés d’API que nécessaire.
URL de basehttps://shareto.social/api/v1
S’authentifier
Créez une clé dans Paramètres, section API, puis envoyez-la comme jeton Bearer à chaque requête. Les clés sont illimitées, affichées une seule fois et révocables à tout moment.
curl https://shareto.social/api/v1/accounts \ -H "Authorization: Bearer st_live_..."Connecter un compte
Demandez un lien de connexion et ouvrez-le dans un navigateur, ou envoyez-le au propriétaire du compte. Il donne son accord sur la plateforme et revient sur votre redirectUrl. Le lien reste valable 30 minutes.
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" } }Envoyer des médias
Obtenez une autorisation d’envoi, puis envoyez le fichier avec PUT vers putUrl. Les grandes vidéos peuvent reprendre via tus. Utilisez l’url renvoyée dans votre publication.
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.mp4Publier ou programmer
Envoyez le texte, les médias et les identifiants de comptes. Laissez scheduledAt vide pour publier tout de suite, ou indiquez une heure ISO pour programmer. Chaque compte a son propre statut.
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" }'
Points de terminaison
| Méthode | Chemin | Rôle |
|---|---|---|
| GET | /accounts | Lister les comptes connectés |
| GET | /accounts/{id} | Obtenir un compte |
| POST | /accounts/connect | Créer un lien de connexion pour une plateforme |
| DELETE | /accounts/{id} | Déconnecter un compte et annuler ses publications programmées |
| POST | /uploads | Obtenir une autorisation d’envoi unique pour un fichier |
| POST | /posts | Publier tout de suite ou programmer une publication |
| GET | /posts?ids=a,b | Obtenir les 50 dernières publications, ou celles indiquées dans ids |
| GET | /posts/{id} | Obtenir une publication avec le statut de chaque compte |
| DELETE | /posts/{id} | Supprimer une publication qui n’est pas encore en ligne |
Modes de connexion
Un compte se connecte via Zernio, une API de publication partenaire dont les applications sont approuvées par les plateformes pour publier en public, ou directement via les applications de ShareTo. Indiquez connection avec auto, zernio ou direct. Avec auto, ShareTo choisit le mode pour chaque plateforme.
Erreurs
Les erreurs arrivent en JSON avec un message. Code 401 pour une clé absente ou erronée, 404 si l’élément n’est pas dans votre espace de travail, 422 si la requête enfreint une règle de la plateforme. Le message indique quoi corriger.
ShareTo est en bêta privée. Demandez un accès pour ouvrir un espace de travail.