Postream

Cargando el índice…

Documentación: Listar posts

Listar posts

Los posts publicados del sitio, del más reciente al más antiguo, paginados y sin el cuerpo.

GET/public/v1/sites/{siteId}/posts

GET/public/v1/posts

La primera es la ruta por sitio (solo clave secreta, guardada en el borde); la segunda es la ruta por clave (secreta o publicable). Mira Dos rutas. El panel "Probar" usa la ruta por clave, con una clave publicable.

Parámetros

ParámetroPor defectoDescripción
pageentero1Página, a partir de 1.
perPageentero20Elementos por página, de 1 a 100.
localetexto—Idioma (pt-BR, en-US, es), entre los habilitados en el sitio. Sin él, vienen todos los idiomas.
tagtexto—Solo posts con esa tag (comparación exacta).

Un parámetro inválido o repetido responde 400 BAD_USER_INPUT; un locale fuera de los idiomas del sitio responde 400 LOCALE_NOT_ENABLED.

Respuesta

Orden: fecha de publicación, de la más reciente a la más antigua. Los elementos de la lista no traen el cuerpo; para obtenerlo, busca el post.

{
  "data": [
    {
      "id": "7c0e…",
      "locale": "es",
      "slug": "como-gestionar-varios-blogs",
      "title": "Cómo gestionar varios blogs",
      "excerpt": "…",
      "tags": ["blogs"],
      "seo": {
        "metaTitle": "Cómo gestionar varios blogs sin perder la voz",
        "metaDescription": "…",
        "og": { "title": "Cómo gestionar varios blogs sin perder la voz", "description": "…", "type": "article" }
      },
      "translations": [{ "locale": "pt-BR", "slug": "como-gerir-varios-blogs", "title": "Como gerir vários blogs" }],
      "author": null,
      "publishedAt": "2026-10-20T12:00:00.000Z",
      "updatedAt": "2026-10-20T12:00:00.000Z"
    }
  ],
  "pagination": { "page": 1, "perPage": 20, "total": 1, "totalPages": 1 }
}
  • id es el del post: las traducciones comparten el mismo id.
  • translations lista las otras versiones publicadas, útil para el hreflang.
  • author es quien firma la versión (el autor elegido en el panel o el autor predeterminado del sitio); null solo cuando no hay ninguno.

Paginación

Pide page=2, page=3… hasta pagination.totalPages. Una página más allá de la última vuelve con data vacío, no con error.

En la ruta por sitio, arma la query en la forma canónica (?locale= antes de &tag=, sin page=1): es la URL que Postream purga cuando un post cambia.

Ejemplos

Desde el servidor, con la clave secreta:

curl -H "Authorization: Bearer $POSTREAM_API_KEY" \
  "https://api.postream.blog/public/v1/sites/$POSTREAM_SITE_ID/posts?locale=es&perPage=5"