Listar posts
Os posts publicados do site, do mais recente ao mais antigo, paginados e sem o corpo.
GET/public/v1/sites/{siteId}/posts
GET/public/v1/posts
A primeira é a rota por site (só chave secreta, guardada na borda); a segunda é a rota pela chave (secreta ou publicável). Veja Duas rotas. O painel "Testar" usa a rota pela chave, com uma chave publicável.
Parâmetros
| Parâmetro | Padrão | Descrição |
|---|---|---|
pageinteiro | 1 | Página, a partir de 1. |
perPageinteiro | 20 | Itens por página, de 1 a 100. |
localetexto | — | Idioma (pt-BR, en-US, es), entre os habilitados no site. Sem ele, vêm todos os idiomas. |
tagtexto | — | Só posts com essa tag (comparação exata). |
Parâmetro inválido ou repetido responde 400 BAD_USER_INPUT; um locale fora dos idiomas do site responde 400 LOCALE_NOT_ENABLED.
Resposta
Ordem: data de publicação, da mais recente para a mais antiga. Os itens da lista não trazem o corpo; para ele, busque o post.
{
"data": [
{
"id": "7c0e…",
"locale": "pt-BR",
"slug": "como-gerir-varios-blogs",
"title": "Como gerir vários blogs",
"excerpt": "…",
"tags": ["blogs"],
"seo": {
"metaTitle": "Como gerir vários blogs sem perder a voz",
"metaDescription": "…",
"og": { "title": "Como gerir vários blogs sem perder a voz", "description": "…", "type": "article" }
},
"translations": [{ "locale": "en-US", "slug": "managing-many-blogs", "title": "Managing many 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é o do post: as traduções compartilham o mesmoid.translationslista as outras versões publicadas, útil para ohreflang.authoré quem assina a versão (o autor escolhido no painel ou o autor padrão do site);nullsó quando não há nenhum.
Paginação
Peça page=2, page=3… até pagination.totalPages. Uma página além da última volta com data vazio, não com erro.
Na rota por site, monte a query na forma canônica (?locale= antes de &tag=, sem page=1): é a URL que o Postream purga quando um post muda.
Exemplos
Do servidor, com a chave secreta:
curl -H "Authorization: Bearer $POSTREAM_API_KEY" \
"https://api.postream.blog/public/v1/sites/$POSTREAM_SITE_ID/posts?locale=pt-BR&perPage=5"const res = await fetch(`https://api.postream.blog/public/v1/sites/${process.env.POSTREAM_SITE_ID}/posts?locale=pt-BR&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=pt-BR`, {
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>
);
}