REST APIGET

Listar Publicações

Recupere uma lista paginada das suas publicações agendadas, publicadas e em rascunho, com filtros por status e data.

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

Retorna uma lista paginada de publicações nas redes sociais, as mais recentes primeiro por padrão. São ordenadas pela hora agendada ou, quando não a têm, pela data de criação.

Chave API (Bearer token)
Permissão:posts.readPapéis e permissões

Parâmetros de Consulta

ParâmetroTipoDescrição
limitnumberNúmero de publicações a retornar (1-100, padrão: 20)
offsetnumberNúmero de publicações a ignorar (padrão: 0)
sortOrderstringOrdem de classificação: NEWEST ou OLDEST
statusesPostStatus[]Filtrar por status da publicação. Repita a chave por valor: statuses=SCHEDULED&statuses=COMPLETED. Parâmetros desconhecidos retornam 400
platformsPlatformType[]Filtrar por plataformas, qualquer PlatformType, incluindo GOOGLE_BUSINESS, TUMBLR e TELEGRAM. Repita a chave por valor: platforms=TWITTER&platforms=LINKEDIN
startDatestringApenas publicações agendadas nesta data ou depois (ISO 8601). Uma publicação sem hora agendada é filtrada pela data de criação
endDatestringApenas publicações agendadas nesta data ou antes (ISO 8601). Uma publicação sem hora agendada é filtrada pela data de criação

Status das Publicações

StatusDescrição
DRAFTSalva, mas ainda não publicada nem agendada
PENDINGNa fila para publicação imediata
SCHEDULEDAgendada para uma data futura
PUBLISHINGAtualmente sendo publicado nas plataformas
COMPLETEDPublicado com sucesso em pelo menos uma plataforma
FAILEDA publicação falhou em todas as plataformas
PARTIAL_FAILUREPublicado em algumas plataformas, mas falhou em outras
Listar publicações sociais
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
}