REST APIGET

Lister les posts

Récupérez une liste paginée de vos publications planifiées, publiées et en brouillon, avec des filtres par statut.

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

Renvoie une liste paginée de publications sur les réseaux sociaux, les plus récentes en premier par défaut. Elles sont triées par heure programmée, ou par date de création si elles n'en ont pas.

Clé API (jeton Bearer)
Permission:posts.readRôles et permissions

Paramètres de requête

ParamètreTaperDescription
limitnumberNombre de publications à renvoyer (1-100, par défaut : 20)
offsetnumberNombre de publications à ignorer (par défaut : 0)
sortOrderstringOrdre de tri : NEWEST ou OLDEST
statusesPostStatus[]Filtrer par statuts de publication. Répétez la clé pour chaque valeur : statuses=SCHEDULED&statuses=COMPLETED. Les paramètres inconnus renvoient 400
platformsPlatformType[]Filtrer par plateformes, tout PlatformType y compris GOOGLE_BUSINESS, TUMBLR et TELEGRAM. Répétez la clé pour chaque valeur : platforms=TWITTER&platforms=LINKEDIN
startDatestringSeulement les publications programmées à cette date ou après (ISO 8601). Une publication sans heure programmée est filtrée sur sa date de création
endDatestringSeulement les publications programmées à cette date ou avant (ISO 8601). Une publication sans heure programmée est filtrée sur sa date de création

Statuts des publications

StatutDescription
DRAFTEnregistrée mais pas encore publiée ni programmée
PENDINGEn file d'attente pour publication immédiate
SCHEDULEDProgrammée pour une date future
PUBLISHINGPublication en cours sur les plateformes
COMPLETEDPublié avec succès sur au moins une plateforme
FAILEDLa publication a échoué sur toutes les plateformes
PARTIAL_FAILUREPublié sur certaines plateformes, mais échoué sur d’autres
Lister les publications 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
}