Synupv1
Créer une clé
v1Ressources/Posts/getObtenir un post

Obtenir un post

Renvoie un seul post, y compris sa performance de soumission par plateforme.

get/api/v1/posts/{id}
posts:read
Paramètres de requête
idstringobligatoire
Le post à consulter.
Réponse
dataobjectfacultatif
Des champs internes supplémentaires peuvent être présents mais ne font pas partie du contrat stable — ne vous fiez qu'aux champs documentés ici.
idstringfacultatif
Identifiant unique du post.
namestringfacultatif
Nom/étiquette interne du post.
typestringfacultatif
Type de post (duplicata de postType, conservé pour la compatibilité ascendante).
statusstring (draft | scheduled | active | error)facultatif
Statut du cycle de vie du post : draft, scheduled, active ou error.
postTypestring (announcement | event | offer)facultatif
Type de post : announcement, event ou offer.
clientIdstringfacultatif
ID du client auquel appartient ce post.
locationIdstringfacultatif
ID de l'établissement auquel appartient ce post, ou null pour un post de niveau marque.
locationNamestringfacultatif
Nom d'affichage de l'établissement du post, ou null.
clientNamestringfacultatif
Nom d'affichage du client du post, ou null.
platformsarray of stringfacultatif
Les plateformes ciblées par ce post.
messageGooglestringfacultatif
Légende utilisée pour Google, ou null.
messageFacebookstringfacultatif
Légende sociale partagée utilisée par chaque plateforme non-Google, ou null.
ctaTypestringfacultatif
Type d'appel à l'action, ou null.
ctaUrlstringfacultatif
URL de l'appel à l'action, ou null.
ctaUrlFacebookstringfacultatif
URL de l'appel à l'action spécifique à Facebook, ou null.
xThreadbooleanfacultatif
Si le mode fil X est activé (contourne la limite de 280 caractères).
ctaJsonobjectfacultatif
Réglages bruts d'appel à l'action et de ciblage par plateforme.
mediaUrlsarray of objectfacultatif
Médias associés au post, une entrée par pièce jointe de plateforme.
urlstringfacultatif
platformstringfacultatif
typestring (image | video)facultatif
eventTitlestringfacultatif
Titre de l'événement ou de l'offre, ou null.
eventStartAtstringfacultatif
Date/heure de début de l'événement ou de l'offre, au format horodatage ISO 8601, ou null.
eventEndAtstringfacultatif
Date/heure de fin de l'événement ou de l'offre, au format horodatage ISO 8601, ou null.
offerTermsstringfacultatif
Conditions de l'offre, ou null.
offerCouponCodestringfacultatif
Code promo de l'offre, ou null.
offerRedeemUrlstringfacultatif
URL d'utilisation de l'offre, ou null.
scheduledForstringfacultatif
Date/heure de publication programmée du post, au format horodatage ISO 8601, ou null pour publier immédiatement.
createdAtstringfacultatif
Date de création du post, au format horodatage ISO 8601.
performancearray of objectfacultatif
Performance de soumission par plateforme pour ce post.
submissionIdstringfacultatif
Identifiant unique de la soumission à la plateforme.
connectionIdstringfacultatif
ID de la connexion par laquelle cette soumission a été envoyée.
sitestringfacultatif
La plateforme ciblée par cette soumission.
viewsnumberfacultatif
Nombre total de vues, ou null si pas encore disponible.
clicksnumberfacultatif
Nombre total de clics, ou null si pas encore disponible.
reactionsnumberfacultatif
Nombre total de réactions.
sharesnumberfacultatif
Nombre total de partages.
commentsnumberfacultatif
Nombre total de commentaires.
statusstringfacultatif
Statut de cette soumission à la plateforme : pending, active, error ou deleted.
platformPostIdstringfacultatif
L'identifiant propre à la plateforme pour le post publié, ou null.
postLinkstringfacultatif
URL publique du post publié sur cette plateforme, ou null.
reviewStatestringfacultatif
État de modération Google (processing, live, rejected), ou null pour les autres plateformes.
errorMessagestringfacultatif
Message d'erreur si cette soumission a échoué, ou null.
Erreurs
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/posts/{id}
Votre clé API
id *
{
  "data": {
    "id": "cm_post_abc123",
    "name": "Fall Special Announcement",
    "type": "announcement",
    "status": "scheduled",
    "postType": "announcement",
    "clientId": "cm_client_1",
    "locationId": "cm_loc_1",
    "locationName": "Acme Dental — Downtown",
    "clientName": "Acme Dental",
    "platforms": [
      "google",
      "facebook"
    ],
    "messageGoogle": "Join us this weekend for our fall special — 20% off all services!",
    "messageFacebook": "Join us this weekend for our fall special — 20% off all services!",
    "ctaType": "learn_more",
    "ctaUrl": "https://acmedental.example.com/fall-special",
    "ctaUrlFacebook": null,
    "xThread": false,
    "ctaJson": {
      "ctaType": "learn_more",
      "ctaUrl": "https://acmedental.example.com/fall-special",
      "ctaUrlFacebook": null,
      "xThread": false
    },
    "mediaUrls": [
      {
        "url": "https://cdn.synup.com/uploads/a1/promo.jpg",
        "platform": "facebook",
        "type": "image"
      }
    ],
    "eventTitle": null,
    "eventStartAt": null,
    "eventEndAt": null,
    "offerTerms": null,
    "offerCouponCode": null,
    "offerRedeemUrl": null,
    "scheduledFor": "2026-02-10T15:00:00.000Z",
    "createdAt": "2026-01-20T09:12:00.000Z",
    "performance": [
      {
        "submissionId": "cm_sub_xyz789",
        "connectionId": "cm_conn_1",
        "site": "facebook",
        "views": 890,
        "clicks": null,
        "reactions": 42,
        "shares": 6,
        "comments": 9,
        "status": "active",
        "platformPostId": "1234567890",
        "postLink": "https://www.facebook.com/1234567890",
        "reviewState": null,
        "errorMessage": null
      }
    ]
  }
}