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.

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

Parametres de requete

ParametreTaperDescription
limitnumberNombre de publications a renvoyer (1-100, par defaut : 20)
offsetnumberNombre de publications a ignorer (par defaut : 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 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
DRAFTEnregistree mais pas encore publiee ni programmee
PENDINGEn file d'attente pour publication immediate
SCHEDULEDProgrammee pour une date future
PUBLISHINGPublication en cours sur les plateformes
COMPLETEDPublié avec succès sur au moins une plateforme
FAILEDLa publication a echoue 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
}