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ámetro | Por defecto | Descripción |
|---|---|---|
pageentero | 1 | Página, a partir de 1. |
perPageentero | 20 | Elementos 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 }
}ides el del post: las traducciones comparten el mismoid.translationslista las otras versiones publicadas, útil para elhreflang.authores quien firma la versión (el autor elegido en el panel o el autor predeterminado del sitio);nullsolo 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"const res = await fetch(`https://api.postream.blog/public/v1/sites/${process.env.POSTREAM_SITE_ID}/posts?locale=es&perPage=5`, {
headers: { Authorization: `Bearer ${process.env.POSTREAM_API_KEY}` },
});
const { data, pagination } = await res.json();export default async function Blog() {
const res = await fetch(`${process.env.POSTREAM_API_URL}/sites/${process.env.POSTREAM_SITE_ID}/posts?locale=es`, {
headers: { Authorization: `Bearer ${process.env.POSTREAM_API_KEY}` },
next: { revalidate: 300 },
});
const { data } = await res.json();
return (
<ul>
{data.map((post: { slug: string; title: string }) => (
<li key={post.slug}>
<a href={`/blog/${post.slug}`}>{post.title}</a>
</li>
))}
</ul>
);
}