Posts

Creez, listez et supprimez des posts sur les reseaux sociaux via l’API.

Creer un post

POST /public/v1/posts

Creez un nouveau post comme brouillon, programmez-le pour plus tard ou publiez-le immediatement.

Requete

curl -X POST \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "date": "2026-05-01T14:00:00Z",
    "posts": [
      {
        "channel": { "id": "channel-uuid" },
        "value": [
          {
            "content": "Decouvrez notre derniere nouveaute !",
            "id": "unique-uuid",
            "image": []
          }
        ]
      }
    ]
  }' \
  https://api.postzee.app/public/v1/posts

Parametres

Parametre	Type	Requis	Description
`type`	string	Oui	`"now"` (publier immediatement), `"schedule"` ou `"draft"`
`date`	string	Programme uniquement	Date/heure UTC au format ISO 8601 (par ex., `"2026-05-01T14:00:00Z"`)
`posts`	array	Oui	Tableau d’objets de post (un par canal)
`posts[].channel.id`	string	Oui	ID du canal depuis l’endpoint Canaux
`posts[].value[].content`	string	Oui	Contenu textuel du post
`posts[].value[].id`	string	Oui	Identifiant unique (UUID) pour ce bloc de contenu
`posts[].value[].image`	array	Non	Tableau d’objets media a joindre
`posts[].settings`	object	Non	Parametres specifiques a la plateforme (voir ci-dessous)
`tags`	array	Non	Tags de contenu (`[{ "value": "id", "label": "name" }]`)
`shortLink`	boolean	Non	Activer le raccourcissement d’URL et le suivi des clics

Parametres specifiques a la plateforme

Incluez-les dans posts[].settings pour les fonctionnalites specifiques a chaque plateforme : TikTok :

{
  "tiktok": {
    "title": "Video title",
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "duet": true,
    "stitch": true,
    "comment": true
  }
}

YouTube :

{
  "youtube": {
    "title": "Video title",
    "type": "public",
    "tags": [{ "value": "tag1", "label": "Tag 1" }]
  }
}

Instagram :

{
  "instagram": {
    "post_type": "post",
    "collaborators": [{ "label": "@username" }]
  }
}

LinkedIn :

{
  "linkedin": {
    "post_as_images_carousel": true
  }
}

Reponse

Retourne un tableau avec une entree par post cree :

[
  {
    "postId": "post-uuid",
    "channel": { "id": "channel-uuid" }
  }
]

Lister les posts

GET /public/v1/posts

Recuperez les posts dans une plage de dates.

Requete

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.postzee.app/public/v1/posts?startDate=2026-04-01T00:00:00Z&endDate=2026-04-30T23:59:59Z"

Parametres de requete

Parametre	Type	Requis	Description
`startDate`	string	Oui	Date de debut (ISO 8601)
`endDate`	string	Oui	Date de fin (ISO 8601)
`customer`	string	Non	Filtrer par ID client

Reponse

{
  "posts": [
    {
      "id": "post-uuid",
      "content": "Contenu du post...",
      "state": "PUBLISHED",
      "releaseId": "17895695668004550",
      "releaseURL": "https://www.instagram.com/p/Cabc123/",
      "publishDate": "2026-04-15T14:00:00Z",
      "channel": {
        "id": "channel-uuid",
        "platform": "instagram",
        "name": "My Instagram",
        "picture": "https://..."
      }
    }
  ]
}

Obtenir le statut d’un post

GET /public/v1/posts/:id

Recuperez le statut de publication d’un seul post. Comme la publication est asynchrone, utilisez cet endpoint pour interroger un post apres l’avoir cree : une fois que state vaut PUBLISHED, la reponse contient l’ID du post sur la plateforme (releaseId) et le permalien public (releaseURL).

Requete

curl -H "Authorization: YOUR_API_KEY" \
  https://api.postzee.app/public/v1/posts/post-uuid-here

Parametres

Parametre	Type	Requis	Description
`id`	string (path)	Oui	L’ID du post retourne par Creer un post

Reponse

{
  "id": "post-uuid",
  "state": "PUBLISHED",
  "published": true,
  "releaseId": "17895695668004550",
  "releaseURL": "https://www.instagram.com/p/Cabc123/",
  "publishDate": "2026-04-15T14:00:00Z",
  "createdAt": "2026-04-15T13:58:00Z",
  "channel": {
    "id": "channel-uuid",
    "platform": "instagram",
    "name": "My Instagram"
  }
}

Champ	Description
`state`	`QUEUE` (en attente de publication), `PUBLISHED`, `ERROR` ou `DRAFT`
`published`	`true` lorsque `state` vaut `PUBLISHED`
`releaseId`	L’ID natif du post sur la plateforme (par ex. l’ID du media Instagram). `null` jusqu’a la publication
`releaseURL`	Le permalien public vers le post. `null` jusqu’a la publication

La publication se fait en arriere-plan : juste apres Creer un post, le statut est QUEUE et releaseId vaut null. Interrogez cet endpoint (ou utilisez un webhook) jusqu’a ce que state vaille PUBLISHED pour lire le releaseId.

Supprimer un post

DELETE /public/v1/posts/:id

Supprimez un post par ID.

Requete

curl -X DELETE \
  -H "Authorization: YOUR_API_KEY" \
  https://api.postzee.app/public/v1/posts/post-uuid-here

Parametres

Parametre	Type	Requis	Description
`id`	string (path)	Oui	L’ID du post a supprimer

Reponse

Retourne 200 OK en cas de succes.

Supprimer un post publie le retire de Postzee mais ne le supprime pas de la plateforme de reseaux sociaux. Pour supprimer le contenu publie, vous devez le supprimer directement sur la plateforme.

Trouver le meilleur horaire

GET /public/v1/find-slot/:id

Trouvez le creneau horaire le moins encombre pour publier.

Requete

curl -H "Authorization: YOUR_API_KEY" \
  https://api.postzee.app/public/v1/find-slot/channel-uuid

Reponse

{
  "date": "2026-05-01T10:00:00Z"
}

Retourne une date/heure UTC suggeree lorsque votre calendrier est le moins charge.

Aperçu

Endpoints

Creer un post

Requete

Parametres

Parametres specifiques a la plateforme

Reponse

Lister les posts

Requete

Parametres de requete

Reponse

Obtenir le statut d’un post

Requete

Parametres

Reponse

Supprimer un post

Requete

Parametres

Reponse

Trouver le meilleur horaire

Requete

Reponse

​Creer un post

​Requete

​Parametres

​Parametres specifiques a la plateforme

​Reponse

​Lister les posts

​Requete

​Parametres de requete

​Reponse

​Obtenir le statut d’un post

​Requete

​Parametres

​Reponse

​Supprimer un post

​Requete

​Parametres

​Reponse

​Trouver le meilleur horaire

​Requete

​Reponse

Creer un post

Requete

Parametres

Parametres specifiques a la plateforme

Reponse

Lister les posts

Requete

Parametres de requete

Reponse

Obtenir le statut d’un post

Requete

Parametres

Reponse

Supprimer un post

Requete

Parametres

Reponse

Trouver le meilleur horaire

Requete

Reponse