Reddit fetcher.sh

Twitter/X, YouTube, Reddit, Google e mais - mais de 100 endpoints no total. Sem conta, sem OAuth, sem assinatura. Pague por chamada em USDC, ou faça um depósito único e use o mesmo saldo em todos eles.

GitHub

Documentação

name: reddit-api description: >- Uma alternativa à API do Reddit no fetcher.sh — pagamento por chamada em USDC via x402, ou créditos pré-pagos com chave Bearer, sem registro de aplicativo OAuth. Use quando o usuário quiser pesquisar posts do Reddit em todos os subreddits por palavra-chave e ordenar por top, hot, new ou mais discutidos, pesquisar subreddits ou usuários por palavra-chave, buscar informações de um subreddit ou seu feed de posts hot/new/top, buscar um único post com sua árvore de comentários e respostas de comentários, puxar os feeds globais best/hot/new/top, ou buscar o perfil, posts e comentários de um usuário. Também cobre entrada para análise de sentimento do Reddit, monitoramento de subreddits, rastreamento de palavras-chave e pipelines de dados do Reddit sem o registro de aplicativo da própria API do Reddit ou níveis de limite de taxa. keywords:

reddit
reddit-api
reddit-api-alternative
subreddit
social-listening
x402
ai-agent

Reddit API

Dados do Reddit sob demanda: pesquisa de posts entre subreddits, pesquisa de subreddits e usuários, informações e feeds de subreddits, posts individuais com árvores de comentários completas, feeds globais best/hot/new/top e perfis/posts/comentários de usuários — um simples HTTP GET por chamada, pago conforme o uso. Sem registro de aplicativo OAuth, sem par de client ID/secret, sem nível de limite de taxa da API do Reddit.

URL base: https://reddit.fetcher.sh

Autenticação

Duas formas de pagar, mesmos dados — mecânica completa na habilidade fetcher :

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://reddit.fetcher.sh/api/search/post?keyword=hello"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

Toda resposta é { "status": number, "message": string, "data": ... }; o status HTTP reflete status.

Endpoints (15 — todos GET, $0.002/chamada)

Endpoint	O que retorna
`/api/search/post`	Posts em todos os subreddits que correspondem a uma palavra-chave
`/api/search/subreddit`	Subreddits que correspondem a uma palavra-chave
`/api/search/user`	Usuários que correspondem a uma palavra-chave
`/api/subreddit/{name}`	Informações de um subreddit
`/api/subreddit/{name}/posts`	Feed de posts de um subreddit
`/api/post/{id}`	Um único post
`/api/post/{id}/comments`	Árvore de comentários de um post
`/api/post/{id}/comments/{commentId}/replies`	Respostas a um comentário
`/api/posts/hot`	Feed global hot
`/api/posts/new`	Feed global new
`/api/posts/top`	Feed global top
`/api/posts/best`	Feed global best
`/api/user/{username}`	Perfil de um usuário
`/api/user/{username}/posts`	Posts de um usuário
`/api/user/{username}/comments`	Comentários de um usuário

{id} / {name} / {username} são parâmetros de caminho. sort / cursor opcionais reordenam e paginam; keyword (pesquisa) é obrigatório onde aparece.

Cenários

Posts principais sobre um tópico, em todos os subreddits:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=ai agents" -G \
  --data-urlencode "sort=top" \
  "https://reddit.fetcher.sh/api/search/post"

Mais discutidos (maior contagem de comentários):

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=stablecoin payments" -G \
  --data-urlencode "sort=comments" \
  "https://reddit.fetcher.sh/api/search/post"

Mais recentes primeiro:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=x402" -G \
  --data-urlencode "sort=new" \
  "https://reddit.fetcher.sh/api/search/post"

Outros valores de sort para /api/search/post: relevance, hot.

Pesquisar subreddits ou usuários por palavra-chave:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=machine learning" -G \
  "https://reddit.fetcher.sh/api/search/subreddit"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=spez" -G \
  "https://reddit.fetcher.sh/api/search/user"

Informações de um subreddit, depois seu feed hot/new/top:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://reddit.fetcher.sh/api/subreddit/MachineLearning"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "sort=top" -G \
  "https://reddit.fetcher.sh/api/subreddit/MachineLearning/posts"

Um único post, sua árvore de comentários e respostas a um comentário:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://reddit.fetcher.sh/api/post/1abcde2"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "sort=top" -G \
  "https://reddit.fetcher.sh/api/post/1abcde2/comments"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://reddit.fetcher.sh/api/post/1abcde2/comments/fghij3k/replies"

Feeds globais:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://reddit.fetcher.sh/api/posts/hot"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://reddit.fetcher.sh/api/posts/best"

Perfil, posts e comentários de um usuário:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://reddit.fetcher.sh/api/user/spez"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "sort=new" -G \
  "https://reddit.fetcher.sh/api/user/spez/posts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "sort=top" -G \
  "https://reddit.fetcher.sh/api/user/spez/comments"

MCP

{
  "mcpServers": {
    "reddit": {
      "url": "https://reddit.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

Grátis: search_endpoints, describe_endpoint, check_balance. Pagos: fetch_data (qualquer endpoint acima), topup_credits, além do atalho nomeado reddit_search_post. Remova o bloco headers para pagar por chamada com x402 em vez disso — veja a habilidade fetcher para o fluxo completo.

Erros

400 — parâmetro ausente/inválido (a mensagem o nomeia)
401 — chave desconhecida ou rotacionada
402 — pagamento necessário (desafio x402) ou topup_required (créditos esgotados)
404 — não é um caminho com preço
Sem limites de taxa; sem reembolsos em falhas upstream (a liquidação precede a entrega)

Referência

Configuração completa do agente: https://reddit.fetcher.sh/skill.md
Contrato OpenAPI 3.1: https://reddit.fetcher.sh/openapi.json
Catálogo condensado: https://reddit.fetcher.sh/llms.txt
Aprofundamento em pagamento, créditos e MCP: habilidade fetcher
Site: https://reddit.fetcher.sh