Postream

Carregando o índice…

Documentação: Listar posts

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âmetroPadrãoDescrição
pageinteiro1Página, a partir de 1.
perPageinteiro20Itens 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 mesmo id.
  • translations lista as outras versões publicadas, útil para o hreflang.
  • author é quem assina a versão (o autor escolhido no painel ou o autor padrão do site); null só 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"