API de publication et de messagerie socialepour agents IA
Un seul jeu de points d'accès REST pour publier sur 18 destinations et répondre à chaque DM, commentaire et mention depuis une seule boîte de réception. Authentification par clé d'API, publication mise en file avec relances, webhooks signés — et aucun OAuth à écrire plateforme par plateforme.
URL de base https://api.so-me.studio/v1 · Authentification X-API-Key · JSON en entrée, JSON en sortie
Deux métiers, un seul espace de travail
La plupart des API sociales s'arrêtent à la publication. Un agent qui sait publier mais pas répondre n'est qu'un demi-agent — les deux vivent donc derrière la même clé, sur les mêmes comptes connectés.
Publiez partout en un seul appel
Créez une publication une seule fois, ciblez n'importe quelle destination connectée et laissez la file d'attente gérer le formatage par plateforme, l'envoi des médias, les limites de débit et les relances. Votre agent ne touche jamais au SDK d'une plateforme.
- POST /v1/posts
- POST /v1/posts/:id/schedule
- POST /v1/posts/:id/retry
- POST /v1/media/presign-upload
- POST /v1/drafts/:id/convert
Lisez et traitez chaque conversation
Les DMs, commentaires et mentions de tous vos comptes connectés arrivent dans une seule boîte de réception unifiée. Récupérez le fil, publiez une réponse, marquez-la comme traitée — le tout en simple JSON, dans le même espace de travail que vos publications.
- GET /v1/inbox/conversations
- GET /v1/inbox/conversations/:id/messages
- POST /v1/inbox/conversations/:id/reply
- POST /v1/whatsapp/templates/send
- GET /v1/inbox/saved-replies
À quoi ressemblent les appels
Aucun SDK requis. Trois requêtes couvrent la boucle qu'un agent exécute toute la journée : publier, écouter, répondre.
curl -X POST \
https://api.so-me.studio/v1/posts \
-H "X-API-Key: $SOME_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Ship day 🚀",
"socialMedia": "LINKEDIN",
"postType": "TEXT",
"scheduledAt":
"2026-08-04T09:00:00Z"
}'const { data } = await api(
'/v1/inbox/conversations'
);
for (const c of data) {
const reply = await agent.answer(c);
await api(
`/v1/inbox/conversations/${c.id}`
+ '/reply',
{ method: 'POST',
body: { message: reply } }
);
}await fetch(
BASE + '/v1/webhooks/subscriptions',
{
method: 'POST',
headers: {
'X-API-Key': KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
url: 'https://my-agent.dev/hook',
events: [
'post.published',
'post.failed'
]
})
}
);Tout le produit, sous forme de points d'accès
Tout ce que vous faites dans le tableau de bord a sa route. Rien n'est réservé à l'interface.
Publications
/v1/posts
Créer, modifier, planifier, déplanifier, supprimer en masse, relancer et resoumettre des publications. Lire le calendrier et gérer les commentaires publication par publication.
Brouillons
/v1/drafts
Mettre de côté du contenu en cours, puis convertir un brouillon en publication planifiée en un seul appel.
Boîte de réception
/v1/inbox
Lister les conversations, lire les fils de messages, répondre, archiver et gérer les réponses enregistrées sur tous les comptes connectés.
/v1/whatsapp
Créer et lister les modèles de messages approuvés, envoyer les médias des modèles et expédier des messages modèles à vos clients.
Médias
/v1/media
Envois présignés, dossiers, recherche, renommage, déplacement et suppression en masse. Attachez n'importe quel fichier envoyé à une publication via son id.
Analyses
/v1/analytics
Métriques par compte et par publication, plus les répartitions natives de Facebook, Instagram, LinkedIn, YouTube, X et WhatsApp.
IA
/v1/ai
Générer légendes, images et vidéos UGC depuis votre agent, puis injecter le résultat directement dans une publication.
Approbations
/v1/approvals
Lister tout ce qui attend une relecture, puis approuver ou rejeter — pour qu'un agent rédige pendant qu'un humain valide.
Comptes
/v1/accounts
Lister les comptes sociaux connectés et leurs ids — les identifiants auxquels sont rattachées toutes les publications et toutes les conversations.
Webhooks
/v1/webhooks
Gérer les abonnements, rejouer des livraisons, envoyer des payloads de test et parcourir le catalogue complet des événements.
Bio-links
/v1/biolinks
Construire des pages bio-link par programmation — boutons, publications intégrées, thèmes, mise en ligne et analyses de clics.
Équipes et paramètres
/v1/teams · /v1/settings
Inviter des membres, définir des rôles, faire tourner les clés d'API, changer d'espace de travail et consulter la consommation actuelle de votre plan.
Les schémas complets de requête et de réponse — ainsi que la spécification OpenAPI — se trouvent dans la référence de l'API.
Ce que l'API atteint
Connectez un compte une fois dans le tableau de bord ; l'API en hérite partout.
18 destinations
Twitter/X, Instagram, LinkedIn (profil et Page), Facebook, TikTok, YouTube, Threads, Pinterest, Bluesky, Mastodon, Reddit, Google Business Profile, WordPress, Dev.to, Dribbble, Discord et Slack — le tout depuis un seul POST /v1/posts. WhatsApp, lui, envoie via des modèles approuvés.
Boîte de réception unifiée
Ingestion par webhook en temps réel pour Facebook, Instagram, WhatsApp et Twitter/X, plus des fils récupérés par sondage pour Bluesky, Mastodon, Reddit, Telegram, Discord et Slack. Un seul modèle de conversation pour tous.
20 plateformes
L'OAuth se règle une seule fois dans le tableau de bord. L'API lit les identifiants de compte qui en résultent — vous n'avez jamais à stocker, rafraîchir ou faire tourner un token de plateforme.
Pensée pour un appelant qui ne dort jamais
Un agent relance, s'exécute en parallèle et lit les corps d'erreur au pied de la lettre. L'API est pensée pour ça.
Une clé pour trois surfaces
La même X-API-Key fonctionne pour l'API REST, la CLI installée via npm et le serveur MCP. Émettez-la une fois dans Settings → API Keys ; votre agent ne voit jamais un token OAuth de plateforme.
La publication est mise en file, pas lancée à l'aveugle
Un appel de création répond immédiatement et la publication entre dans une file de workers qui tient compte des limites de débit de chaque plateforme et relance automatiquement. Les échecs se relancent avec POST /v1/posts/:id/retry.
Plus de 150 événements signés
Abonnez-vous à post.published, post.failed, aux événements de messages de la boîte de réception, aux décisions d'approbation, aux déconnexions de compte et plus encore. Les payloads sont signés en HMAC-SHA256 pour que votre agent puisse s'y fier.
Limitée à un espace de travail par construction
Chaque clé est rattachée à un seul espace de travail. Avec une clé par client, un agent est physiquement incapable de lire ou de publier dans les comptes d'un autre tenant.
Des limites de débit documentées et appliquées
Les quotas par minute et par mois sont publiés pour chaque plan et signalés par un 429 net — aucun bridage silencieux qu'une boucle de relance pourrait mal interpréter.
Pas seulement du REST
Vous préférez des outils à des points d'accès ? Le même espace de travail est exposé sous forme de plus de 200 outils MCP et d'une CLI qui affiche du JSON et renvoie de vrais codes de sortie.
Les limites, annoncées d'emblée
L'API se débloque avec le plan Team. Dépassez un quota et vous obtenez un 429 — jamais un abandon silencieux.
| Plan | Appels d'API | Limite de débit | Livraisons de webhooks |
|---|---|---|---|
| Free et Solo | Pas d'accès à l'API | — | — |
| Team | 10 000 appels / mois | 60 appels / min | 25 000 livraisons / mois |
| Scale | Illimité | 300 appels / min | Illimité |
Consultez les tarifs pour les prix en vigueur, ou la présentation des agents si vous préférez les outils MCP aux points d'accès bruts.
Premier appel en trois étapes
Pas d'appel commercial, pas de demande de bac à sable, pas de compte développeur à ouvrir plateforme par plateforme.
Connectez vos comptes
Créez un compte et reliez n'importe laquelle des 20 destinations depuis le tableau de bord. L'OAuth, le rafraîchissement des tokens et les demandes de reconnexion sont pris en charge pour vous à partir de là.
Générez une clé d'API
Settings → API Keys. Envoyez-la en X-API-Key. Une clé par espace de travail garde vos clients isolés ; la même clé pilote aussi la CLI et le serveur MCP.
Publiez, puis écoutez
POST /v1/posts pour publier ou planifier, abonnez-vous à post.published et post.failed, puis lisez GET /v1/inbox/conversations pour commencer à répondre.
Deux choses, avec une seule clé. Publication : créez, planifiez, publiez, relancez et supprimez du contenu sur 18 destinations, avec envois de médias présignés et génération IA de légendes et d'images dans le même espace de travail. Messagerie : listez les conversations de la boîte de réception unifiée, lisez un fil, répondez aux DMs et aux commentaires, et envoyez des modèles WhatsApp approuvés. Autour de cela : analyses, approbations, bio-links, équipes, modèles et webhooks — le tout sous https://api.so-me.studio/v1.
Générez une clé dans Settings → API Keys et envoyez-la dans l'en-tête X-API-Key à chaque requête. Les clés sont limitées à un seul espace de travail : une clé par client suffit à isoler les agents les uns des autres. La même clé authentifie la CLI (npm i -g @social-media-scheduler/cli) et le serveur MCP.
Non. Vous connectez vos comptes une fois dans le tableau de bord et les tokens de plateforme restent chez nous, chiffrés. GET /v1/accounts renvoie les ids de compte que vous référencez pour publier ou répondre. Le rafraîchissement des tokens, les demandes de reconnexion et les bizarreries propres à chaque plateforme sont notre problème, pas le vôtre.
Oui. GET /v1/inbox/conversations liste les fils de tous les comptes connectés, GET /v1/inbox/conversations/:id/messages renvoie l'historique des messages pour le contexte, et POST /v1/inbox/conversations/:id/reply envoie la réponse. Facebook, Instagram, WhatsApp et Twitter/X arrivent par webhooks en temps réel ; Bluesky, Mastodon, Reddit, Telegram, Discord et Slack sont ramenés dans le même modèle de conversation.
WhatsApp fonctionne par modèles plutôt qu'en texte libre : POST /v1/whatsapp/templates crée un modèle à faire approuver, POST /v1/whatsapp/templates/upload-media y attache le média d'en-tête, et POST /v1/whatsapp/templates/send l'expédie. Les messages WhatsApp entrants arrivent dans la même boîte de réception unifiée que le reste.
Non, et c'est délibéré. POST /v1/posts répond dès que la publication est acceptée ; la mise en ligne passe par une file d'attente qui tient compte des limites de débit de chaque plateforme et relance automatiquement. Surveillez les webhooks post.published et post.failed — ou interrogez GET /v1/posts/:id — plutôt que de bloquer un thread de requête sur une plateforme qui passe un mauvais après-midi.
Plus de 150, couvrant les publications, les brouillons, la réutilisation de contenu, les approbations, la boîte de réception, les médias, les comptes, la facturation et les équipes — post.published, post.failed, post.approval.requested, déconnexions de compte et plus encore. Gérez les abonnements avec POST /v1/webhooks/subscriptions, déclenchez une livraison de test, rejouez une livraison échouée et vérifiez la signature HMAC-SHA256 à réception.
L'API est réservée aux plans Team et supérieurs ; Free et Solo n'y ont pas accès. Team inclut 10 000 appels/mois à 60 appels/min, plus 25 000 livraisons de webhooks/mois. Scale supprime les plafonds mensuels et relève le plafond à 300 appels/min. Un dépassement renvoie 429 Too Many Requests.
Un même espace de travail, trois formes. Utilisez REST depuis n'importe quel backend ou framework (LangChain, CrewAI, AutoGen, Vertex AI, un simple worker cron). Utilisez la CLI dans vos shells, en CI et dans les tâches planifiées. Utilisez le serveur MCP quand l'agent doit découvrir seul plus de 200 outils typés — c'est la voie Claude, Cursor et Windsurf.
Sur docs.so-me.studio, spécification OpenAPI comprise, pour générer un client typé dans n'importe quel langage. Cette page est la vue d'ensemble ; la référence contient les schémas de requête et de réponse de chaque route.
Planifiez une fois.
Publiez partout.
Fini la valse des onglets — rédigez, adaptez et publiez sur 20 plateformes depuis un seul calendrier.