postlineDocs
GuiasReferência da APIMCPChangelogAbrir o app

Listar posts

GET
/api/v1/posts

Os posts sociais de um projeto (linkedin, x, carousel), do mais novo ao mais antigo, com o artigo de origem e o status e a data de cada destino.

Permissão: posts:read.

Autorização

apiToken
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
format?string
Valor em"linkedin""carousel""x"
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

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/posts' \  -H 'Authorization: Bearer pl_live_…'
Exemplo de resposta
{  "data": [    {      "id": "3c8e1f20-6a4b-4d7e-9f15-8b2c0d6e4a71",      "projectId": "7f3a91c2-48e6-4b0d-a5c1-2e9d6b8f0a14",      "format": "linkedin",      "status": "in_review",      "title": "Most churn happens before the second invoice.",      "articleId": "0b9c4e7a-5d1f-4c2e-9a8b-3f6e2d1c7b90",      "agent": "n8n",      "destinations": [        {          "destination": "linkedin",          "status": "pending",          "at": "2026-10-20T09:00",          "publishedAt": null,          "url": null        }      ]    }  ],  "nextCursor": "NTA"}