Synupv1
Crear clave
v1Recursos/Posts/getListar publicaciones

Listar publicaciones

Devuelve las publicaciones de una ubicación, empezando por las creadas más recientemente, con el estado de envío por plataforma y estadísticas agregadas.

get/api/v1/posts
posts:read
Parámetros de consulta
locationIdstringobligatorio
La ubicación cuyas publicaciones se listan. Obligatorio.
platformstringopcional
Restringe los resultados a publicaciones enviadas a esta plataforma.
typestring (announcement | event | offer)opcional
Restringe los resultados a un tipo de publicación.
statusstringopcional
Restringe los resultados a un estado de publicación.
fromstringopcional
Incluye solo publicaciones creadas en esta fecha o después.
tostringopcional
Incluye solo publicaciones creadas en esta fecha o antes.
searchstringopcional
Coincidencia sin distinción de mayúsculas con el nombre de la publicación.
pageintegeropcional
Número de página, empezando en 1. El valor predeterminado es 1.
perPageintegeropcional
Resultados por página, hasta 50. El valor predeterminado es 20.
Respuesta
dataobjectopcional
rowsarray of objectopcional
Las publicaciones que coinciden.
idstringopcional
Identificador único de la publicación.
namestringopcional
Nombre o etiqueta interna de la publicación.
typestringopcional
Tipo de publicación: announcement, event u offer.
statusstringopcional
Estado del ciclo de vida de la publicación: draft, scheduled, active o error.
postDatestringopcional
Fecha programada o de creación de la publicación, como marca de tiempo ISO 8601.
platformsarray of stringopcional
Las plataformas a las que apunta esta publicación.
firstMediaUrlstringopcional
URL del primer elemento multimedia de la publicación, o null.
firstMediaTypestringopcional
Tipo del primer elemento multimedia de la publicación (image o video), o null.
submissionsarray of objectopcional
Estado de envío por plataforma para esta publicación.
platformstringopcional
La plataforma a la que corresponde esta fila.
statusstringopcional
Estado de este envío a la plataforma: pending, active, error o deleted.
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.
messagePreviewstringopcional
Los primeros 140 caracteres del texto de la publicación, o null.
viewsnumberopcional
Total de vistas, o null si aún no está disponible.
clicksnumberopcional
Total de clics, o null si aún no está disponible.
errorMsgstringopcional
Mensaje de error del primer envío fallido, o null.
deletedOnstringopcional
Cuándo se retiró esta publicación, como marca de tiempo ISO 8601, o null.
totalnumberopcional
Número total de publicaciones que coinciden.
statsobjectopcional
Estadísticas agregadas de las publicaciones que coinciden.
totalPostsnumberopcional
Número de publicaciones que coinciden.
totalViewsnumberopcional
Total de vistas de las publicaciones que coinciden, o null.
totalClicksnumberopcional
Total de clics de las publicaciones que coinciden, o null.
totalEngagementnumberopcional
Total de reacciones, veces compartido y comentarios combinados de las publicaciones que coinciden.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/posts
Su clave de API
locationId *
platform
type
status
from
to
search
page
perPage
{
  "data": {
    "rows": [
      {
        "id": "cm_post_abc123",
        "name": "Fall Special Announcement",
        "type": "announcement",
        "status": "scheduled",
        "postDate": "2026-02-10T15:00:00.000Z",
        "platforms": [
          "google",
          "facebook"
        ],
        "firstMediaUrl": "https://cdn.synup.com/uploads/a1/promo.jpg",
        "firstMediaType": "image",
        "submissions": [
          {
            "platform": "google",
            "status": "pending",
            "postLink": null,
            "reviewState": null,
            "errorMessage": null
          },
          {
            "platform": "facebook",
            "status": "pending",
            "postLink": null,
            "reviewState": null,
            "errorMessage": null
          }
        ],
        "messagePreview": "Join us this weekend for our fall special — 20% off all services!",
        "views": null,
        "clicks": null,
        "errorMsg": null,
        "deletedOn": null
      }
    ],
    "total": 1,
    "stats": {
      "totalPosts": 12,
      "totalViews": 4300,
      "totalClicks": 210,
      "totalEngagement": 96
    }
  }
}