Publicaciones

Listar las publicaciones

Lista las publicaciones de los establecimientos accesibles al token, las más recientes primero, filtrables por establecimiento, estado, fechas y autor.

GEThttps://api.sofia-post.com/api/v1/posts

Listar las publicaciones

Lista las publicaciones de los establecimientos accesibles al token, las más recientes primero, filtrables por establecimiento, estado, fechas y autor.

Autorizaciones

Authorizationstringobligatorio

Tu clave personal o token de acceso OAuth, enviado como Bearer <token>.

Se guarda solo en esta pestaña y se envía únicamente a api.sofia-post.com. Obtener una clave de API

Parámetros de consulta

establishmentIdstring

Solo las publicaciones de este establecimiento.

cursorstring

El nextCursor de la página anterior.

statusstring

Live: al menos una red en este estado. El status de la publicación resume sus redes, así que filtrar por failed puede devolver partial.

fromstring<date-time>

Live: al menos una red publicada (o, antes de publicar, programada) a partir de este instante.

tostring<date-time>

Live: y antes de este instante (excluido).

createdBystring

Live: me para las publicaciones de la persona por la que actúa el token, app para las que creó esta aplicación. Ausente: todas.

limitnumber

Tamaño de página, de 1 a 100 (20 por defecto).

Listar las publicaciones

curl -X GET 'https://api.sofia-post.com/api/v1/posts' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "status": "published",
      "establishmentId": "string",
      "scheduledAt": "2026-11-02T10:00:00.000Z",
      "createdAt": "2026-11-02T10:00:00.000Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "string",
          "state": "published",
          "permalink": "https://www.instagram.com/p/C1"
        }
      ]
    }
  ]
}

Listar las publicaciones

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/posts' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "status": "published",
      "establishmentId": "string",
      "scheduledAt": "2026-11-02T10:00:00.000Z",
      "createdAt": "2026-11-02T10:00:00.000Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "string",
          "state": "published",
          "permalink": "https://www.instagram.com/p/C1"
        }
      ]
    }
  ]
}

GET /v1/posts lista todas las publicaciones accesibles al token, las más recientes primero, filtradas por establishmentId, status, from, to y createdBy (me o app). Una publicación coincide con status cuando al menos una de sus redes está en ese estado. Consulta la paginación.

Los estados posibles de una publicación se describen en la página Leer una publicación.

Autorizaciones

Authorizationstringheaderobligatorio
Tu clave personal o token de acceso OAuth, enviado como Bearer <token>.

Parámetros de consulta

establishmentIdstring
Solo las publicaciones de este establecimiento.
cursorstring
El nextCursor de la página anterior.
statusstring
Live: al menos una red en este estado. El status de la publicación resume sus redes, así que filtrar por failed puede devolver partial.
Valores permitidos: draftscheduledpublishingpublishedsent_to_inboxfailed
fromstring<date-time>
Live: al menos una red publicada (o, antes de publicar, programada) a partir de este instante.
tostring<date-time>
Live: y antes de este instante (excluido).
createdBystring
Live: me para las publicaciones de la persona por la que actúa el token, app para las que creó esta aplicación. Ausente: todas.
Valores permitidos: meapp
limitnumber
Tamaño de página, de 1 a 100 (20 por defecto).

Respuesta

Una página de publicaciones, con nextCursor cuando hay más.

dataobject[]obligatorio
Las publicaciones de la página
Mostrar atributos hijos
- idstringobligatorio
  Identificador de la publicación
- statusstringobligatorio
  En todas las redes; partial: publicada en una, fallida en otra
  Valores permitidos: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
- establishmentIdstringobligatorio
  Establecimiento de la publicación
- createdAtstring<date-time>obligatorio
  Cuándo se creó la publicación
- targetsobject[]obligatorio
  Una entrada por red y cuenta: dos cuentas en una red, dos entradas
  Mostrar atributos hijos
  - platformstringobligatorio
    Red del destino
  - accountIdstringobligatorio
    La cuenta que publica (GET /v1/establishments/:id/accounts)
  - statestringobligatorio
    Estado del destino en su red
    Valores permitidos: draftscheduledpublishingpublishedsent_to_inboxfailed
  - publishedAtstring<date-time>
    Cuándo se publicó el destino
  - permalinkstring
    Enlace a la publicación en la red
  - errorstring
    Por qué la red la rechazó
- scheduledAtstring<date-time>
  Cuándo está programada la publicación
nextCursorstring
Pásalo como ?cursor= para la página siguiente; ausente al final

¿Te ha resultado útil esta página?