Reddit fetcher.sh

Twitter/X, YouTube, Reddit, Google y más: más de 100 endpoints en total. Sin cuenta, sin OAuth, sin suscripción. Paga por llamada en USDC, o recarga una vez y gasta un saldo en todos ellos.

GitHub

Documentación

name: reddit-api description: >- Una alternativa a la API de Reddit en fetcher.sh — pago por llamada en USDC vía x402, o créditos prepagados con una clave Bearer, sin registro de aplicación OAuth. Úsalo cuando el usuario quiera buscar publicaciones de Reddit en todos los subreddits por palabra clave y ordenar por top, hot, new o más discutidos, buscar subreddits o usuarios por palabra clave, obtener la información de un subreddit o su feed de publicaciones hot/new/top, obtener una publicación individual con su árbol de comentarios y respuestas a comentarios, extraer los feeds globales best/hot/new/top, u obtener el perfil, publicaciones y comentarios de un usuario. También cubre la entrada para análisis de sentimiento de Reddit, monitoreo de subreddits, seguimiento de palabras clave y pipelines de datos de Reddit sin el registro de aplicación de la API propia de Reddit ni sus niveles de límite de tasa. keywords:

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

API de Reddit

Datos de Reddit bajo demanda: búsqueda de publicaciones entre subreddits, búsqueda de subreddits y usuarios, información y feeds de subreddits, publicaciones individuales con árboles de comentarios completos, feeds globales best/hot/new/top y perfiles/publicaciones/comentarios de usuarios — un simple GET HTTP por llamada, pago por uso. Sin registro de aplicación OAuth, sin par de client ID/secret, sin nivel de límite de tasa de la API de Reddit.

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

Autenticación

Dos formas de pagar, mismos datos — mecánica completa en la habilidad 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.

Cada respuesta es { "status": number, "message": string, "data": ... }; el estado HTTP refleja status.

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

Endpoint	Qué devuelve
`/api/search/post`	Publicaciones en todos los subreddits que coinciden con una palabra clave
`/api/search/subreddit`	Subreddits que coinciden con una palabra clave
`/api/search/user`	Usuarios que coinciden con una palabra clave
`/api/subreddit/{name}`	Información de un subreddit
`/api/subreddit/{name}/posts`	Feed de publicaciones de un subreddit
`/api/post/{id}`	Una publicación individual
`/api/post/{id}/comments`	Árbol de comentarios de una publicación
`/api/post/{id}/comments/{commentId}/replies`	Respuestas a un comentario
`/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 un usuario
`/api/user/{username}/posts`	Publicaciones de un usuario
`/api/user/{username}/comments`	Comentarios de un usuario

{id} / {name} / {username} son parámetros de ruta. Los opcionales sort / cursor reordenan y paginan; keyword (búsqueda) es obligatorio donde aparece.

Escenarios

Publicaciones principales sobre un tema, en todos los 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"

Más discutidos (mayor número de comentarios):

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

Más recientes primero:

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

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

Buscar subreddits o usuarios por palabra clave:

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"

Información de un subreddit, luego su 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"

Una publicación individual, su árbol de comentarios y respuestas a un comentario:

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 globales:

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, publicaciones y comentarios de un usuario:

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_..." }
    }
  }
}

Gratis: search_endpoints, describe_endpoint, check_balance. De pago: fetch_data (cualquier endpoint anterior), topup_credits, además del atajo nombrado reddit_search_post. Elimina el bloque headers para pagar por llamada con x402 en su lugar — consulta la habilidad fetcher para el flujo completo.

Errores

400 — parámetro faltante o inválido (el mensaje lo indica)
401 — clave desconocida o rotada
402 — pago requerido (desafío x402) o topup_required (créditos agotados)
404 — no es una ruta con precio
Sin límites de tasa; sin reembolsos por fallos del proveedor (el pago precede a la entrega)

Referencia

Configuración completa del 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
Inmersión profunda en pagos, créditos y MCP: habilidad fetcher
Sitio: https://reddit.fetcher.sh