# Reddit (dados públicos)

> Reddit (dados públicos): Busca, subreddits, posts e comentários públicos.

URL: https://apicultura.app/ferramentas/reddit-publico/
Atualizado em 05/11/2026 (2026-11-05).

## O que é Reddit (dados públicos) na APIcultura

Acesse Reddit (dados públicos) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Busca, subreddits, posts e comentários públicos. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [Redes (dados públicos)](/catalogo/?cat=social). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `reddit-buscar-posts` | Buscar posts | R$ 0,01 | `POST /v1/call/reddit-buscar-posts` |
| `reddit-posts-subreddit` | Posts de um subreddit | R$ 0,01 | `POST /v1/call/reddit-posts-subreddit` |
| `reddit-comentarios` | Comentários de um post | R$ 0,01 | `POST /v1/call/reddit-comentarios` |
| `reddit-em-alta` | Posts em alta | R$ 0,01 | `POST /v1/call/reddit-em-alta` |
| `reddit-buscar-subreddits` | Buscar subreddits | R$ 0,02 | `POST /v1/call/reddit-buscar-subreddits` |

### Buscar posts (`reddit-buscar-posts`)

Busca posts do Reddit. Preço: R$ 0,01 por chamada.

- `limit` (integer, opcional), ex.: `10`
- `query` (string, obrigatório), ex.: `async runtime`
- `sort` (string, opcional), ex.: `relevance`
- `subreddit` (string, opcional), ex.: `rust`
- `t` (string, opcional), ex.: `all`

### Schema de entrada de reddit-buscar-posts

```json
{
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "sort": {
      "type": "string",
      "maxLength": 2000
    },
    "subreddit": {
      "type": "string",
      "maxLength": 2000
    },
    "t": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Posts de um subreddit (`reddit-posts-subreddit`)

Posts de um subreddit. Preço: R$ 0,01 por chamada.

- `limit` (integer, opcional), ex.: `10`
- `sort` (string, opcional), ex.: `hot`
- `subreddit` (string, obrigatório), ex.: `rust`
- `t` (string, opcional), ex.: `day`

### Schema de entrada de reddit-posts-subreddit

```json
{
  "required": [
    "subreddit"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "sort": {
      "type": "string",
      "maxLength": 2000
    },
    "subreddit": {
      "type": "string",
      "maxLength": 2000
    },
    "t": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Comentários de um post (`reddit-comentarios`)

Comentários de um post. Preço: R$ 0,01 por chamada.

- `limit` (integer, opcional), ex.: `20`
- `sort` (string, opcional), ex.: `top`
- `url` (string, obrigatório), ex.: `https://www.reddit.com/r/rust/comments/1w38wm2/hey_rustaceans_got_a_question_ask_here_362026/`

### Schema de entrada de reddit-comentarios

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "sort": {
      "type": "string",
      "maxLength": 2000
    },
    "url": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Posts em alta (`reddit-em-alta`)

Posts em alta no Reddit. Preço: R$ 0,01 por chamada.

- `after` (string, opcional)
- `limit` (integer, opcional, padrão 25, mín. 1, máx. 100), ex.: `25`

### Schema de entrada de reddit-em-alta

```json
{
  "required": [],
  "properties": {
    "after": {
      "type": "string",
      "maxLength": 2000
    },
    "limit": {
      "type": "number"
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Buscar subreddits (`reddit-buscar-subreddits`)

Busca comunidades do Reddit. Preço: R$ 0,02 por chamada.

- `query` (string, opcional), ex.: `push ups`
- `sort` (string, opcional)
- `subreddit` (string, obrigatório), ex.: `Fitness`
- `timeframe` (string, opcional)

### Schema de entrada de reddit-buscar-subreddits

```json
{
  "required": [
    "subreddit"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "maxLength": 2000
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "sort": {
      "type": "string",
      "maxLength": 2000
    },
    "subreddit": {
      "type": "string",
      "maxLength": 2000
    },
    "timeframe": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

## Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta `call` com o slug do endpoint e a entrada:

```json
{ "name": "call", "arguments": { "slug": "reddit-buscar-posts", "input": {"limit":10,"query":"async runtime","sort":"relevance","subreddit":"rust","t":"all"}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/reddit-buscar-posts \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":10,"query":"async runtime","sort":"relevance","subreddit":"rust","t":"all"}'
```

## Formato da resposta, preço e limites

A resposta é JSON com `data` (o resultado do endpoint) e `meta` (inclui `cost_brl`, o valor cobrado). Preço deste endpoint: R$ 0,01 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use `max_cost_brl` para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

## Workflows que usam Reddit (dados públicos)

- [Calendário de conteúdo a partir de tendências públicas](/workflows/calendario-conteudo/)
- [Monitorar menções públicas da sua marca](/workflows/monitorar-mencoes/)

## Experimente

Teste no playground interativo: [Reddit (dados públicos) no playground](/ferramentas/ferramenta.html?slug=reddit-publico). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Reddit (dados públicos) é marca de seus respectivos donos, citada apenas para identificar a integração.