Démarrage rapide de l'API de réseaux sociaux

Prérequis

Avant de commencer, assurez-vous d’avoir :

Un compte Social media studio avec au moins un compte social connecté
Une clé d’API (voir Authentification)

URL de base

Toutes les requêtes API doivent être envoyées à :

https://api.so-me.studio/v1

Créer une publication

Envoyez une requête POST pour créer une nouvelle publication :

curl -X POST https://api.so-me.studio/v1/posts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from the API!",
    "socialMedia": "TWITTER",
    "postType": "TEXT"
  }'

socialMedia accepte n’importe laquelle des 16 destinations de publication (comme TWITTER, LINKEDIN, INSTAGRAM, FACEBOOK, TIKTOK, YOUTUBE, THREADS, PINTEREST, BLUESKY, et d’autres), pas seulement les quelques-unes utilisées dans ces exemples. WHATSAPP et TELEGRAM sont réservées à la messagerie et ne peuvent pas recevoir de publications. Consultez Connecter des comptes pour la liste complète des plateformes prises en charge.

Réponse

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "text": "Hello from the API!",
  "socialMedia": "TWITTER",
  "postType": "TEXT",
  "postStatus": "SCHEDULED",
  "createdAt": "2025-01-15T09:00:00.000Z"
}

Programmer une publication

Pour programmer une publication à une date ultérieure, incluez scheduledAt lors de la création :

curl -X POST https://api.so-me.studio/v1/posts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Scheduled post!",
    "socialMedia": "LINKEDIN",
    "postType": "TEXT",
    "scheduledAt": "2025-02-01T12:00:00Z"
  }'

Ou programmez une publication existante :

curl -X POST https://api.so-me.studio/v1/posts/{id}/schedule \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledAt": "2025-02-01T12:00:00Z"
  }'

Lister les publications

Récupérez les publications de votre espace de travail avec un filtrage facultatif. Le filtre status correspond au champ postStatus renvoyé dans les réponses, et socialMedia filtre par plateforme :

curl "https://api.so-me.studio/v1/posts?status=SCHEDULED&socialMedia=TWITTER&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Téléverser des médias

Pour les publications avec image ou vidéo, obtenez d’abord une URL de téléversement présignée :

curl -X POST https://api.so-me.studio/v1/posts/presign-media \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postType": "IMAGE",
    "socialMedia": "INSTAGRAM",
    "files": [{
      "filename": "photo.jpg",
      "mimetype": "image/jpeg",
      "size": 1024000
    }]
  }'

Téléversez ensuite votre fichier vers l’uploadUrl renvoyée avec une requête HTTP PUT. Envoyez un en-tête Content-Type égal au mimetype que vous avez déclaré :

curl -X PUT "UPLOAD_URL_FROM_THE_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg

L’URL de téléversement est signée avec le mimetype déclaré. Un PUT sans en-tête Content-Type (par exemple avec curl -T ou requests.put(url, data=f) en Python), ou avec une valeur différente, échoue avec 403 SignatureDoesNotMatch.

Utilisez ensuite s3Prefix et fileSrc dans votre requête de création de publication.

Premiers pas

Publication

AI Studio

Boîte de réception et engagement

Statistiques

Biolink

Équipe et collaboration

Paramètres et facturation

Démarrage rapide de l'API de réseaux sociaux

Prérequis

URL de base

Créer une publication

Programmer une publication

Lister les publications

Téléverser des médias

Étapes suivantes

Référence de l'API

Serveur MCP

​Prérequis

​URL de base

​Créer une publication

​Programmer une publication

​Lister les publications

​Téléverser des médias

​Étapes suivantes

Référence de l'API

Serveur MCP

Prérequis

URL de base

Créer une publication

Programmer une publication

Lister les publications

Téléverser des médias

Étapes suivantes