# Listar posts > Listar posts: GET /v1/posts. Lista os posts, do mais recente para o mais antigo (na fila e nos rascunhos, do mais próximo para o mais distante). Filtros: state, channel, tag. Fonte: https://praeko.app/docs/api/posts/list-posts `GET /v1/posts` · escopo mínimo: read Lista os posts, do mais recente para o mais antigo (na fila e nos rascunhos, do mais próximo para o mais distante). Filtros: `state`, `channel`, `tag`. > **Cabeçalhos** `Authorization: Bearer praeko_…` e `X-Praeko-Contract: en`. Sempre envie os dois. ## Parâmetros | Nome | Onde | Descrição | |---|---|---| | `state` | consulta | Filtra pelo estado. Valores: queued, draft, sent, error, canceled. | | `channel` | consulta | Id do canal ou nome da rede. | | `tag` | consulta | Nome de uma etiqueta. | | `limit` | consulta | Itens por página (1 a 200). Padrão: 50. | | `offset` | consulta | Quantos pular. Padrão: 0. | ## Exemplo **curl** ```bash curl "https://praeko.app/v1/posts" \ -H "Authorization: Bearer $PRAEKO_KEY" \ -H "X-Praeko-Contract: en" ``` **JavaScript** ```js const res = await fetch("https://praeko.app/v1/posts", { method: "GET", headers: { "Authorization": `Bearer ${process.env.PRAEKO_KEY}`, "X-Praeko-Contract": "en", }, }); console.log(res.status, await res.json()); ``` **Node** ```js import { Praeko } from "@praeko/sdk"; const praeko = new Praeko({ url: "https://praeko.app", key: process.env.PRAEKO_KEY }); const resultado = await praeko.posts.list(); console.log(resultado); ``` **Python** ```python import os import requests resp = requests.get( "https://praeko.app/v1/posts", headers={ "Authorization": f"Bearer {os.environ['PRAEKO_KEY']}", "X-Praeko-Contract": "en", }, ) print(resp.status_code, resp.json()) ``` **PHP** ```php 'GET', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer " . getenv("PRAEKO_KEY"), 'X-Praeko-Contract: en', ], ]); $resposta = curl_exec($ch); echo curl_getinfo($ch, CURLINFO_HTTP_CODE), " ", $resposta, PHP_EOL; curl_close($ch); ``` **Go** ```go package main import ( "fmt" "io" "net/http" "os" ) func main() { req, err := http.NewRequest("GET", "https://praeko.app/v1/posts", nil) if err != nil { panic(err) } req.Header.Set("Authorization", "Bearer "+os.Getenv("PRAEKO_KEY")) req.Header.Set("X-Praeko-Contract", "en") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(resp.Status, string(out)) } ``` **Ruby** ```ruby require "net/http" require "uri" uri = URI("https://praeko.app/v1/posts") request = Net::HTTP::Get.new(uri) request["Authorization"] = "Bearer #{ENV['PRAEKO_KEY']}" request["X-Praeko-Contract"] = "en" response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) } puts response.code, response.body ``` **C#** ```csharp using System.Net.Http; using System.Net.Http.Headers; using System.Text; using var client = new HttpClient(); using var request = new HttpRequestMessage(HttpMethod.Get, "https://praeko.app/v1/posts"); request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PRAEKO_KEY")); request.Headers.Add("X-Praeko-Contract", "en"); using var response = await client.SendAsync(request); Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}"); ``` **Java** ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://praeko.app/v1/posts")) .header("Authorization", "Bearer " + System.getenv("PRAEKO_KEY")) .header("X-Praeko-Contract", "en") .method("GET", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode() + " " + response.body()); } } ``` **HTTPie** ```bash http GET "https://praeko.app/v1/posts" \ "Authorization: Bearer $PRAEKO_KEY" \ "X-Praeko-Contract: en" ``` > SDK oficial para Node: Instale com `npm install @praeko/sdk` (veja [SDK e CLI](https://praeko.app/docs/sdk)). ## Resposta | Status de sucesso | Quando | |---|---| | `200` | Sucesso. | **Resposta 200** ```json { "total": 1, "posts": [ { "id": "01KA3W2Y6H1RC5ZQ8M0T4VXE7N", "title": "O teste que só falhava na segunda (versão final)", "state": "queued", "type": "short", "kind": "video", "origin": "api", "media": { "video": "01KA3VQ7M2T9XE4HB8N5RZ6C0D", "cover": null }, "texts": { "youtube": { "title": "O teste que só falhava na segunda", "text": "Um teste que passava de terça a domingo. O que ele escondia.\n\n#programação #testes" } }, "tags": [ "bastidores", "testes" ], "thumb": null, "items": [ { "id": "01KA3W2Y6J9D3BNF7G2K5PQS8A", "network": "youtube", "channel": "01KA3V0R5D8M2WQ7X4HT9NZ1BF", "state": "scheduled", "scheduledFor": "2026-11-10T20:30:00.000Z", "custom": true, "mode": "scheduled", "runAt": "2026-11-10T19:30:00.000Z", "thumb": null } ], "createdAt": "2026-11-07T14:02:11.482Z", "updatedAt": "2026-11-07T15:40:03.120Z" } ] } ``` Cada post vem sem `actions` (elas só aparecem em `GET /v1/posts/:id`). Filtros: `state`, `channel`, `tag`. ## Erros Sem erros específicos desta rota além dos comuns. ### Erros de qualquer rota | Status | code | Quando | |---|---|---| | 401 | `unauthorized` | Faltou o cabeçalho `Authorization: Bearer …`. | | 401 | `invalid_api_key` | A chave não existe. | | 401 | `revoked_api_key` | A chave foi revogada. | | 401 | `expired_api_key` | A chave expirou. | | 403 | `forbidden` | O escopo da chave não basta para esta rota (veja o selo de escopo). | | 429 | `rate_limited` | Passou do limite de requisições por minuto. | O corpo de todo erro é `{ "error": { "code", "message", "details"? } }`. Veja [todos os códigos](https://praeko.app/docs/guides/errors-and-limits). ## Testar > **Testar**: o teste ao vivo exige entrar na conta. Aqui ele fica desligado.