postlineDocs
GuiasReferência da APIMCPChangelogAbrir o app

Listar artigos

GET
/api/v1/articles

Os artigos de um projeto, do atualizado mais recentemente ao mais antigo, com o status: draft, generating, in_review, approved, scheduled ou published. Com o token de leitura do site (pl_read_…), responde só os artigos publicados do projeto, com locale obrigatório, no formato publicado.

Permissão: articles:read.

Autorização

headerAutorizaçãoBearer <token>

Token de API (pl_live_…) de Organização › Chaves de API, com suas permissões e limite de 60 chamadas por minuto. Um token de projeto trabalha no seu projeto; um token de todos os projetos indica um com projectId.

Parâmetros de query

projectId?string

O projeto, de Listar projetos. Um token de projeto preenche sozinho.

Tamanho1 <= length <= 64
status?string
Valor em"draft""generating""in_review""approved""scheduled""published"
limit?integer

Itens por página, de 1 a 100.

Intervalo1 <= value <= 100
Padrão50
cursor?string

O nextCursor da página anterior.

Tamanholength <= 200
locale?string

Só com o token de leitura: o idioma, como pt-BR ou en.

Corpo da resposta

OK

application/json
  1. response
data*array<>
nextCursor*string|null
Exemplo de requisição
curl -X GET 'https://app.postline.com.br/api/v1/articles' \  -H 'Authorization: Bearer pl_live_…'
Exemplo de resposta
{  "data": [    {      "id": "0b9c4e7a-5d1f-4c2e-9a8b-3f6e2d1c7b90",      "projectId": "7f3a91c2-48e6-4b0d-a5c1-2e9d6b8f0a14",      "title": "How to cut churn in the first 30 days",      "status": "in_review",      "slug": "cut-churn-first-30-days",      "locale": "en",      "scheduledAt": null,      "publishedAt": null,      "updatedAt": "2026-10-15T09:41:00.000Z"    }  ],  "nextCursor": "NTA"}