REST APIGET

Listar publicaciones

Recupera una lista paginada de tus publicaciones programadas, publicadas y en borrador, con filtros por estado y fecha.

GEThttps://post.adaptlypost.com/post/api/v1/social-posts

Devuelve una lista paginada de publicaciones en redes sociales, las más recientes primero por defecto. Se ordenan por la hora programada o, si no la tienen, por la fecha de creación.

Clave API (token Bearer)
Permiso:posts.readRoles y permisos

Parametros de consulta

ParametroTipoDescripcion
limitnumberNumero de publicaciones a devolver (1-100, predeterminado: 20)
offsetnumberNumero de publicaciones a omitir (predeterminado: 0)
sortOrderstringOrden de clasificación: NEWEST u OLDEST
statusesPostStatus[]Filtrar por estados de publicación. Repite la clave por cada valor: statuses=SCHEDULED&statuses=COMPLETED. Los parámetros desconocidos devuelven 400
platformsPlatformType[]Filtrar por plataformas, cualquier PlatformType incluidos GOOGLE_BUSINESS, TUMBLR y TELEGRAM. Repite la clave por cada valor: platforms=TWITTER&platforms=LINKEDIN
startDatestringSolo publicaciones programadas en esta fecha o después (ISO 8601). Una publicación sin hora programada se filtra por su fecha de creación
endDatestringSolo publicaciones programadas en esta fecha o antes (ISO 8601). Una publicación sin hora programada se filtra por su fecha de creación

Estados de publicacion

EstadoDescripcion
DRAFTGuardada pero aun no publicada ni programada
PENDINGEn cola para publicacion inmediata
SCHEDULEDProgramada para una fecha futura
PUBLISHINGSe está publicando actualmente en las plataformas
COMPLETEDPublicado correctamente en al menos una plataforma
FAILEDLa publicacion fallo en todas las plataformas
PARTIAL_FAILUREPublicado en algunas plataformas, pero falló en otras
Listar publicaciones sociales
curl --request GET \
  --url 'https://post.adaptlypost.com/post/api/v1/social-posts?limit=10&offset=0&statuses=SCHEDULED&statuses=PUBLISHING&platforms=FACEBOOK&platforms=TIKTOK' \
  --header 'Authorization: Bearer <api-key>'
200
{
  "posts": [
    {
      "id": "post_xyz789",
      "contentType": "TEXT",
      "text": "Hello world!",
      "status": "COMPLETED",
      "scheduledAt": null,
      "timezone": "America/New_York",
      "platforms": [
        {
          "id": "pp_001",
          "platform": "TWITTER",
          "status": "PUBLISHED",
          "accountName": "@yourhandle",
          "publishedAt": "2026-03-14T12:00:00Z"
        }
      ],
      "createdAt": "2026-03-14T11:59:00Z",
      "updatedAt": "2026-03-14T12:00:05Z"
    },
    {
      "id": "post_rec456",
      "contentType": "TEXT",
      "text": "Hello everyone, the weekly product tip is live!",
      "status": "SCHEDULED",
      "scheduledAt": "2026-10-15T13:00:00Z",
      "timezone": "America/New_York",
      "recurringPostId": "rp_abc123",
      "occurrenceAt": "2026-10-15T13:00:00Z",
      "platforms": [
        {
          "id": "pp_002",
          "platform": "LINKEDIN",
          "status": "PENDING",
          "accountName": "Your Company"
        }
      ],
      "createdAt": "2026-10-14T13:00:00Z",
      "updatedAt": "2026-10-14T13:00:00Z"
    }
  ],
  "total": 42,
  "hasMore": true
}