Synupv1
Crear clave
v1Recursos/Posts/getObtener una publicación

Obtener una publicación

Devuelve una sola publicación, incluido su rendimiento de envío por plataforma.

get/api/v1/posts/{id}
posts:read
Parámetros de consulta
idstringobligatorio
La publicación a consultar.
Respuesta
dataobjectopcional
Puede haber campos internos adicionales que no forman parte del contrato estable — dependa únicamente de los campos documentados aquí.
idstringopcional
Identificador único de la publicación.
namestringopcional
Nombre o etiqueta interna de la publicación.
typestringopcional
Tipo de publicación (duplicado de postType, mantenido por compatibilidad).
statusstring (draft | scheduled | active | error)opcional
Estado del ciclo de vida de la publicación: draft, scheduled, active o error.
postTypestring (announcement | event | offer)opcional
Tipo de publicación: announcement, event u offer.
clientIdstringopcional
ID del cliente al que pertenece esta publicación.
locationIdstringopcional
ID de la ubicación a la que pertenece esta publicación, o null para una publicación a nivel de marca.
locationNamestringopcional
Nombre visible de la ubicación de la publicación, o null.
clientNamestringopcional
Nombre visible del cliente de la publicación, o null.
platformsarray of stringopcional
Las plataformas a las que apunta esta publicación.
messageGooglestringopcional
Texto usado para Google, o null.
messageFacebookstringopcional
Texto social compartido usado por cada plataforma que no sea Google, o null.
ctaTypestringopcional
Tipo de llamada a la acción, o null.
ctaUrlstringopcional
URL de la llamada a la acción, o null.
ctaUrlFacebookstringopcional
URL de llamada a la acción específica de Facebook, o null.
xThreadbooleanopcional
Si el modo de hilo de X está activado (evita el límite de 280 caracteres).
ctaJsonobjectopcional
Configuración sin procesar de llamada a la acción y segmentación por plataforma.
mediaUrlsarray of objectopcional
Medios adjuntos a la publicación, una entrada por adjunto de plataforma.
urlstringopcional
platformstringopcional
typestring (image | video)opcional
eventTitlestringopcional
Título del evento u oferta, o null.
eventStartAtstringopcional
Hora de inicio del evento u oferta, como marca de tiempo ISO 8601, o null.
eventEndAtstringopcional
Hora de fin del evento u oferta, como marca de tiempo ISO 8601, o null.
offerTermsstringopcional
Términos de la oferta, o null.
offerCouponCodestringopcional
Código de cupón de la oferta, o null.
offerRedeemUrlstringopcional
URL de canje de la oferta, o null.
scheduledForstringopcional
Cuándo está programada la publicación para publicarse, como marca de tiempo ISO 8601, o null para publicar de inmediato.
createdAtstringopcional
Fecha de creación de la publicación, como marca de tiempo ISO 8601.
performancearray of objectopcional
Rendimiento de envío por plataforma para esta publicación.
submissionIdstringopcional
Identificador único del envío a la plataforma.
connectionIdstringopcional
ID de la conexión a través de la cual se envió este envío.
sitestringopcional
La plataforma a la que apunta este envío.
viewsnumberopcional
Total de vistas, o null si aún no está disponible.
clicksnumberopcional
Total de clics, o null si aún no está disponible.
reactionsnumberopcional
Total de reacciones.
sharesnumberopcional
Total de veces compartido.
commentsnumberopcional
Total de comentarios.
statusstringopcional
Estado de este envío a la plataforma: pending, active, error o deleted.
platformPostIdstringopcional
El id propio de la plataforma para la publicación publicada, o null.
postLinkstringopcional
URL pública de la publicación publicada en esta plataforma, o null.
reviewStatestringopcional
Estado de moderación de Google (processing, live, rejected), o null para otras plataformas.
errorMessagestringopcional
Mensaje de error si este envío falló, o null.
Errores
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/posts/{id}
Su clave de 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
      }
    ]
  }
}