API do Reddit

A API do Reddit permite pesquisar posts do Reddit ou obter um post completo com seus comentários encadeados. Ambos os endpoints retornam JSON estruturado com campos como subreddit, autor, pontuação, flair, prêmios e mídia. Use-a para alimentar agentes conscientes de discussões, monitoramento de marca, análise de sentimento ou pipelines de RAG que precisam de contexto da comunidade.

Tempo de resposta: 5-15 segundos. As requisições ao Reddit são significativamente mais lentas do que nossas outras plataformas porque usam renderização JavaScript e proxies residenciais premium para obter resultados atualizados. Defina um timeout de cliente de pelo menos 30 segundos, mostre um esqueleto ou indicador de progresso e considere padrões de UX assíncronos ou streaming.

Endpoints

Endpoint	Créditos	Descrição
`POST /api/v1/reddit/search`	2	Pesquisar posts do Reddit por consulta, ordenação e cursor de paginação
`POST /api/v1/reddit/post`	2	Obter um post completo com comentários encadeados pela URL do post do Reddit

Autenticação

Cabeçalho	Valor	Obrigatório
`Authorization`	`Bearer YOUR_API_KEY`	Sim
`Content-Type`	`application/json`	Sim

Pesquisa de Posts

Bash

POST https://api.scavio.dev/api/v1/reddit/search

Pesquise posts do Reddit em todo o Reddit. Retorna metadados do post incluindo título, URL, subreddit, autor, timestamp e flag NSFW. Suporta paginação via token de cursor.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`query`	`string`	--	Obrigatório. Consulta de pesquisa (1-500 caracteres).
`sort`	`string`	`relevance`	Ordem de classificação. Uma entre: `relevance`, `hot`, `top`, `new`, `comments`
`cursor`	`string`	--	Token de paginação do campo `nextCursor` da resposta anterior.

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/reddit/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "best python web frameworks 2026",
    "sort": "new"
  }'

Exemplo de Resposta

JSON

{
  "data": {
    "searchQuery": "best python web frameworks 2026",
    "totalResults": 14,
    "nextCursor": "eyJjYW5kaWRhdGVzX3JldH...",
    "posts": [
      {
        "position": 0,
        "id": "t3_1smb9du",
        "title": "FastAPI vs Django in 2026 -- what the teams are actually using",
        "url": "https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/",
        "subreddit": "Python",
        "author": "python_dev",
        "timestamp": "2026-04-15T16:34:40.389000+0000",
        "nsfw": false
      }
    ]
  },
  "response_time": 5200,
  "credits_used": 2,
  "credits_remaining": 498
}

Paginação

Para buscar a próxima página, passe o valor nextCursor da resposta anterior como parâmetro cursor na sua próxima requisição. Quando nextCursor for null, não há mais resultados.

Detalhes do Post

Bash

POST https://api.scavio.dev/api/v1/reddit/post

Busque um post completo do Reddit pela URL, incluindo o corpo do post, metadados, e árvore de comentários encadeados. Os comentários incluem um campo depth que você pode usar para reconstruir a hierarquia de tópicos.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`url`	`string`	--	Obrigatório. URL completa do post do Reddit (ex.: `https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/`).

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/reddit/post' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/"
  }'

Exemplo de Resposta

JSON

{
  "data": {
    "post": {
      "id": "t3_1smb9du",
      "title": "FastAPI vs Django in 2026 -- what the teams are actually using",
      "body": "After a year of running both in production...",
      "url": "https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/",
      "contentUrl": "https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/",
      "subreddit": "Python",
      "author": "python_dev",
      "score": 842,
      "upvoteRatio": 0.97,
      "numComments": 214,
      "timestamp": "2026-04-15T16:34:40.389000+0000",
      "flair": "Discussion",
      "nsfw": false,
      "awards": []
    },
    "comments": [
      {
        "id": "t1_lxs9a0k",
        "author": "senior_py",
        "body": "We moved to FastAPI for the API surface and kept Django for admin...",
        "score": 312,
        "depth": 0,
        "timestamp": "2026-04-15T17:02:11.000000+0000",
        "parentId": "t3_1smb9du"
      },
      {
        "id": "t1_lxsa1b2",
        "author": "django_dev",
        "body": "Django ORM is still unmatched for anything with relational depth.",
        "score": 178,
        "depth": 1,
        "timestamp": "2026-04-15T17:15:42.000000+0000",
        "parentId": "t1_lxs9a0k"
      }
    ]
  },
  "response_time": 8900,
  "credits_used": 2,
  "credits_remaining": 496
}

Reconstruindo a Árvore de Comentários

Os comentários são retornados como um array plano em ordem de travessia. Use o campo depth (0-indexado) para indentação visual, ou reconstrua a árvore completa através do parentId de cada comentário. Respostas de primeiro nível têm parentId igual ao id do post (ex.: t3_…); respostas aninhadas têm parentId igual ao id de outro comentário (ex.: t1_…).

url vs contentUrl

url é o link permanente canônico do Reddit para o post. contentUrl é a URL que o Reddit renderiza no corpo do post -- para posts de link será o artigo externo, para posts de texto/auto é igual aurl, e para posts de imagem/vídeo é a URL de mídia emi.redd.it ou v.redd.it.

Formato da Resposta

Ambos os endpoints retornam um wrapper de resposta consistente:

Campo	Tipo	Descrição
`data`	`object \| null`	O payload da resposta. `null` se a requisição falhou upstream. Pesquisa retorna `{searchQuery, totalResults, nextCursor, posts}`; post retorna `{post, comments}`.
`response_time`	`number`	Tempo de resposta do servidor em milissegundos
`credits_used`	`number`	Número de créditos consumidos (sempre 2 para endpoints do Reddit)
`credits_remaining`	`number`	Créditos restantes no seu período de faturamento atual

Respostas de Erro

Status	Descrição
`400`	Corpo da requisição inválido -- faltando `query` / `url`, cursor inválido ou valor de ordenação não suportado
`401`	Não autorizado -- chave de API ausente ou inválida
`429`	Limite de taxa ou uso excedido para seu plano
`502`	Erro upstream -- tente novamente após um breve intervalo
`503`	Upstream indisponível -- tente novamente mais tarde
`504`	Timeout upstream -- as requisições ao Reddit podem levar de 5 a 15 segundos; tente novamente com um timeout de cliente maior

Consulte Erros para a referência completa de erros e práticas recomendadas de repetição.

Relacionados

Início Rápido -- obtenha sua chave de API e faça sua primeira requisição
API de Pesquisa Google -- pesquise no Google com dados SERP estruturados
API do YouTube -- pesquise vídeos e extraia metadados
API da Amazon -- pesquise produtos Amazon em 12 marketplaces
API do Walmart -- pesquise produtos Walmart com filtros de entrega
Limites de Taxa -- limites por nível de plano

API do Reddit

Endpoints

Endpoint	Créditos	Descrição
`POST /api/v1/reddit/search`	2	Pesquisar posts do Reddit por consulta, ordenação e cursor de paginação
`POST /api/v1/reddit/post`	2	Obter um post completo com comentários encadeados pela URL do post do Reddit

Autenticação

Cabeçalho	Valor	Obrigatório
`Authorization`	`Bearer YOUR_API_KEY`	Sim
`Content-Type`	`application/json`	Sim

Pesquisa de Posts

Bash

POST https://api.scavio.dev/api/v1/reddit/search

Pesquise posts do Reddit em todo o Reddit. Retorna metadados do post incluindo título, URL, subreddit, autor, timestamp e flag NSFW. Suporta paginação via token de cursor.

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`query`	`string`	--	Obrigatório. Consulta de pesquisa (1-500 caracteres).
`sort`	`string`	`relevance`	Ordem de classificação. Uma entre: `relevance`, `hot`, `top`, `new`, `comments`
`cursor`	`string`	--	Token de paginação do campo `nextCursor` da resposta anterior.

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/reddit/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "best python web frameworks 2026",
    "sort": "new"
  }'

Exemplo de Resposta

JSON

{
  "data": {
    "searchQuery": "best python web frameworks 2026",
    "totalResults": 14,
    "nextCursor": "eyJjYW5kaWRhdGVzX3JldH...",
    "posts": [
      {
        "position": 0,
        "id": "t3_1smb9du",
        "title": "FastAPI vs Django in 2026 -- what the teams are actually using",
        "url": "https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/",
        "subreddit": "Python",
        "author": "python_dev",
        "timestamp": "2026-04-15T16:34:40.389000+0000",
        "nsfw": false
      }
    ]
  },
  "response_time": 5200,
  "credits_used": 2,
  "credits_remaining": 498
}

Paginação

Para buscar a próxima página, passe o valor nextCursor da resposta anterior como parâmetro cursor na sua próxima requisição. Quando nextCursor for null, não há mais resultados.

Detalhes do Post

Bash

POST https://api.scavio.dev/api/v1/reddit/post

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`url`	`string`	--	Obrigatório. URL completa do post do Reddit (ex.: `https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/`).

Exemplo

curl -X POST 'https://api.scavio.dev/api/v1/reddit/post' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/"
  }'

Exemplo de Resposta

JSON

{
  "data": {
    "post": {
      "id": "t3_1smb9du",
      "title": "FastAPI vs Django in 2026 -- what the teams are actually using",
      "body": "After a year of running both in production...",
      "url": "https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/",
      "contentUrl": "https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/",
      "subreddit": "Python",
      "author": "python_dev",
      "score": 842,
      "upvoteRatio": 0.97,
      "numComments": 214,
      "timestamp": "2026-04-15T16:34:40.389000+0000",
      "flair": "Discussion",
      "nsfw": false,
      "awards": []
    },
    "comments": [
      {
        "id": "t1_lxs9a0k",
        "author": "senior_py",
        "body": "We moved to FastAPI for the API surface and kept Django for admin...",
        "score": 312,
        "depth": 0,
        "timestamp": "2026-04-15T17:02:11.000000+0000",
        "parentId": "t3_1smb9du"
      },
      {
        "id": "t1_lxsa1b2",
        "author": "django_dev",
        "body": "Django ORM is still unmatched for anything with relational depth.",
        "score": 178,
        "depth": 1,
        "timestamp": "2026-04-15T17:15:42.000000+0000",
        "parentId": "t1_lxs9a0k"
      }
    ]
  },
  "response_time": 8900,
  "credits_used": 2,
  "credits_remaining": 496
}

Reconstruindo a Árvore de Comentários

url vs contentUrl

Formato da Resposta

Ambos os endpoints retornam um wrapper de resposta consistente:

Campo	Tipo	Descrição
`data`	`object \| null`	O payload da resposta. `null` se a requisição falhou upstream. Pesquisa retorna `{searchQuery, totalResults, nextCursor, posts}`; post retorna `{post, comments}`.
`response_time`	`number`	Tempo de resposta do servidor em milissegundos
`credits_used`	`number`	Número de créditos consumidos (sempre 2 para endpoints do Reddit)
`credits_remaining`	`number`	Créditos restantes no seu período de faturamento atual

Respostas de Erro

Status	Descrição
`400`	Corpo da requisição inválido -- faltando `query` / `url`, cursor inválido ou valor de ordenação não suportado
`401`	Não autorizado -- chave de API ausente ou inválida
`429`	Limite de taxa ou uso excedido para seu plano
`502`	Erro upstream -- tente novamente após um breve intervalo
`503`	Upstream indisponível -- tente novamente mais tarde
`504`	Timeout upstream -- as requisições ao Reddit podem levar de 5 a 15 segundos; tente novamente com um timeout de cliente maior

Consulte Erros para a referência completa de erros e práticas recomendadas de repetição.

Relacionados

Início Rápido -- obtenha sua chave de API e faça sua primeira requisição
API de Pesquisa Google -- pesquise no Google com dados SERP estruturados
API do YouTube -- pesquise vídeos e extraia metadados
API da Amazon -- pesquise produtos Amazon em 12 marketplaces
API do Walmart -- pesquise produtos Walmart com filtros de entrega
Limites de Taxa -- limites por nível de plano