Posts

Crea, lista y elimina posts de redes sociales a través de la API.

Crear post

POST /public/v1/posts

Crea un nuevo post como borrador, prográmalo para después o publícalo inmediatamente.

Solicitud

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": "¡Mira nuestro último lanzamiento!",
            "id": "unique-uuid",
            "image": []
          }
        ]
      }
    ]
  }' \
  https://api.postzee.app/public/v1/posts

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	Sí	`"now"` (publicar inmediatamente), `"schedule"` o `"draft"`
`date`	string	Solo schedule	Fecha y hora UTC en formato ISO 8601 (ej., `"2026-05-01T14:00:00Z"`)
`posts`	array	Sí	Array de objetos de post (uno por canal)
`posts[].channel.id`	string	Sí	ID del canal del endpoint de Canales
`posts[].value[].content`	string	Sí	Contenido de texto del post
`posts[].value[].id`	string	Sí	Identificador único (UUID) para este bloque de contenido
`posts[].value[].image`	array	No	Array de objetos de medios a adjuntar
`posts[].settings`	object	No	Configuraciones específicas de plataforma (ver abajo)
`tags`	array	No	Etiquetas de contenido (`[{ "value": "id", "label": "name" }]`)
`shortLink`	boolean	No	Habilitar acortamiento de URLs y seguimiento de clics

Configuraciones específicas de plataforma

Incluye estas en posts[].settings para funciones específicas de plataforma: 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
  }
}

Respuesta

Devuelve un array con una entrada por cada post creado:

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

Listar posts

GET /public/v1/posts

Recupera posts dentro de un rango de fechas.

Solicitud

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"

Parámetros de consulta

Parámetro	Tipo	Obligatorio	Descripción
`startDate`	string	Sí	Fecha de inicio (ISO 8601)
`endDate`	string	Sí	Fecha de fin (ISO 8601)
`customer`	string	No	Filtrar por ID de cliente

Respuesta

{
  "posts": [
    {
      "id": "post-uuid",
      "content": "Contenido del 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://..."
      }
    }
  ]
}

Obtener estado del post

GET /public/v1/posts/:id

Recupera el estado de publicación de un solo post. Dado que la publicación es asíncrona, usa este endpoint para hacer polling de un post después de crearlo: una vez que state sea PUBLISHED, la respuesta incluye el id del post en la plataforma (releaseId) y el enlace público permanente (releaseURL).

Solicitud

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

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`id`	string (path)	Sí	El ID del post devuelto por Crear post

Respuesta

{
  "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"
  }
}

Campo	Descripción
`state`	`QUEUE` (esperando para publicar), `PUBLISHED`, `ERROR` o `DRAFT`
`published`	`true` cuando `state` es `PUBLISHED`
`releaseId`	El id nativo del post en la plataforma (ej., el id del medio en Instagram). `null` hasta que se publique
`releaseURL`	El enlace público permanente al post. `null` hasta que se publique

La publicación ocurre en segundo plano, por lo que justo después de Crear post el estado es QUEUE y releaseId es null. Haz polling de este endpoint (o usa un webhook) hasta que state sea PUBLISHED para leer el releaseId.

Eliminar post

DELETE /public/v1/posts/:id

Elimina un post por ID.

Solicitud

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

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`id`	string (path)	Sí	El ID del post a eliminar

Respuesta

Devuelve 200 OK en caso de éxito.

Eliminar un post publicado lo elimina de Postzee pero no lo elimina de la plataforma de redes sociales. Para eliminar contenido publicado, debes eliminarlo directamente en la plataforma.

Encontrar mejor horario

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

Encuentra el horario menos congestionado para publicar.

Solicitud

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

Respuesta

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

Devuelve una fecha y hora UTC sugerida cuando tu calendario está menos ocupado.

Resumen

Endpoints

Crear post

Solicitud

Parámetros

Configuraciones específicas de plataforma

Respuesta

Listar posts

Solicitud

Parámetros de consulta

Respuesta

Obtener estado del post

Solicitud

Parámetros

Respuesta

Eliminar post

Solicitud

Parámetros

Respuesta

Encontrar mejor horario

Solicitud

Respuesta

​Crear post

​Solicitud

​Parámetros

​Configuraciones específicas de plataforma

​Respuesta

​Listar posts

​Solicitud

​Parámetros de consulta

​Respuesta

​Obtener estado del post

​Solicitud

​Parámetros

​Respuesta

​Eliminar post

​Solicitud

​Parámetros

​Respuesta

​Encontrar mejor horario

​Solicitud

​Respuesta

Crear post

Solicitud

Parámetros

Configuraciones específicas de plataforma

Respuesta

Listar posts

Solicitud

Parámetros de consulta

Respuesta

Obtener estado del post

Solicitud

Parámetros

Respuesta

Eliminar post

Solicitud

Parámetros

Respuesta

Encontrar mejor horario

Solicitud

Respuesta