L'API pour publier sur tous les réseaux sociaux

Kreatoai publie et programme sur Instagram, les Pages Facebook, TikTok, les profils LinkedIn et YouTube (Shorts). Son API vous donne tout cela en une seule requête : vous n'avez pas à créer une application chez chaque réseau, à passer leurs revues, ni à renouveler leurs jetons. Vous envoyez le texte, les médias, les réseaux et l'heure ; Kreatoai publie et vous prévient du résultat, réseau par réseau.

Par où commencer

Adresse et clé

https://api.kreatoai.com/v1

Toutes les routes répondent en JSON. Chaque appel porte une clé, dans l'en-tête x-api-key ou dans Authorization: Bearer. Créez-la dans Réglages → Claude et API → Clés API ; elle commence par sk-kre-v1-, ne s'affiche qu'une fois et porte des permissions explicites (voir Authentification et Clés API). Les erreurs ont toutes la même forme, décrite dans Erreurs.

Premiers appels

1. Lister vos comptes. Rien n'est publié : c'est le bon appel pour vérifier la clé. Chaque compte a un id, utile quand plusieurs comptes d'un même réseau sont reliés.

curl https://api.kreatoai.com/v1/accounts \
  -H "x-api-key: sk-kre-v1-votre_cle"

2. Publier ou programmer. Sans scheduledAt, la publication part tout de suite ; avec, elle attend dans Kreatoai et part seule à l'heure dite. idempotencyKey garantit qu'une requête rejouée ne publie pas deux fois.

curl -X POST https://api.kreatoai.com/v1/posts \
  -H "x-api-key: sk-kre-v1-votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "targets": ["instagram", "facebook", "linkedin"],
    "content": "Nos horaires changent à partir de lundi",
    "mediaUrls": ["https://media.kreatoai.com/horaires.jpg"],
    "scheduledAt": "2026-10-05T08:30:00+02:00",
    "idempotencyKey": "horaires-octobre"
  }'

3. Suivre le résultat. Déclarez une adresse dans Webhooks : chaque réseau vous envoie publish.completed avec le lien de la publication, ou publish.failed avec la raison. Sinon, GET /v1/posts/:id donne l'état de chaque réseau.

Ce que couvre l'API

Le serveur MCP (https://api.kreatoai.com/mcp) expose les mêmes actions aux assistants IA, avec les mêmes règles : il rejoue ces routes avec la clé ou la connexion de l'utilisateur, sans aucun privilège de plus.

Intégrer Kreatoai dans votre SaaS

Une clé appartient à un espace Kreatoai : elle publie depuis les comptes reliés à cet espace, dans les limites de sa formule. Deux montages sont possibles.

Vous publiez pour vos clients ou vos marques. Reliez leurs comptes à votre propre espace, de 10 à 60 comptes selon la formule, puis visez chacun par son id dans targets : { "platform": "instagram", "channelId": "…" }. Les webhooks disent quel compte a publié (accountId, accountName).

Chaque utilisateur de votre produit a son espace. Il crée une clé dans Kreatoai et la colle dans votre produit, qui la garde chiffrée et l'utilise pour ses seuls appels. Ses comptes, sa formule et ses limites restent les siens, et il révoque la clé quand il veut.

Dans les deux cas : un idempotencyKey par tâche de votre côté, les webhooks plutôt que des interrogations répétées, jamais de nouvel essai sur un échec failType: "permanent", et 30 requêtes par minute et par clé au plus (voir Limites).

Ce qui est offert

Un espace sans formule publie dix fois par mois gratuitement, par l'API comme depuis le tableau de bord, sans carte bancaire. Ensuite, chaque formule comprend l'API, les webhooks et le serveur MCP ; sans formule, une nouvelle publication reçoit 402 subscription_required. Lire ses comptes et suivre ses publications reste toujours ouvert. Les formules sont présentées sur la page d'accueil.