API de Reddit

La API de Reddit te permite buscar publicaciones en Reddit u obtener una publicacion completa con sus comentarios en hilo. Ambos endpoints devuelven JSON estructurado con subreddit, autor, puntuacion, flair, premios y campos de medios. Usala para potenciar agentes con contexto de discusiones, monitoreo de marca, analisis de sentimiento o pipelines RAG que necesiten contexto de la comunidad.

Tiempo de respuesta: 5-15 segundos. Las solicitudes a Reddit son significativamente mas lentas que en nuestras otras plataformas porque utilizan renderizado JavaScript y proxies residenciales premium para obtener resultados actualizados. Configura un timeout de cliente de al menos 30 segundos, muestra un skeleton o indicador de progreso, y considera patrones de UX con streaming o asincrono.

Endpoints

Endpoint	Creditos	Descripcion
`POST /api/v1/reddit/search`	2	Buscar publicaciones de Reddit por consulta, orden y cursor de paginacion
`POST /api/v1/reddit/post`	2	Obtener una publicacion completa con comentarios en hilo por URL de Reddit

Autenticacion

Cabecera	Valor	Requerido
`Authorization`	`Bearer YOUR_API_KEY`	Si
`Content-Type`	`application/json`	Si

Busqueda de Publicaciones

Bash

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

Busca publicaciones en todo Reddit. Devuelve metadatos de publicaciones incluyendo titulo, URL, subreddit, autor, marca de tiempo y flag NSFW. Soporta paginacion mediante un token de cursor.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`query`	`string`	--	Requerido. Consulta de busqueda (1-500 caracteres).
`sort`	`string`	`relevance`	Orden de resultados. Uno de: `relevance`, `hot`, `top`, `new`, `comments`
`cursor`	`string`	--	Token de paginacion del campo `nextCursor` de la respuesta anterior.

Ejemplo

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"
  }'

Ejemplo de Respuesta

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
}

Paginacion

Para obtener la siguiente pagina, pasa el valor de nextCursor de la respuesta anterior como el parametro cursor en tu siguiente solicitud. Cuando nextCursor es null, no hay mas resultados.

Detalle de Publicacion

Bash

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

Obtiene una publicacion completa de Reddit por su URL, incluyendo el cuerpo de la publicacion, metadatos y el arbol completo de comentarios en hilo. Los comentarios incluyen un campo depth que puedes usar para reconstruir la jerarquia del hilo.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`url`	`string`	--	Requerido. URL completa de la publicacion de Reddit (ej. `https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/`).

Ejemplo

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/"
  }'

Ejemplo de Respuesta

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
}

Reconstruccion del Arbol de Comentarios

Los comentarios se devuelven como un array plano en orden de recorrido. Usa el campo depth (indexado desde 0) para la indentacion visual, o reconstruye el arbol completo mediante el parentId de cada comentario. Las respuestas de nivel superior tienen parentId igual al id de la publicacion (ej. t3_…); las respuestas anidadas tienen parentId igual al id de otro comentario (ej. t1_…).

url vs contentUrl

url es el enlace permanente canonico de Reddit para la publicacion. contentUrl es la URL que Reddit renderiza en el cuerpo de la publicacion -- para publicaciones de enlace sera el articulo externo, para publicaciones de texto es lo mismo que url, y para publicaciones de imagen/video es la URL del medio en i.redd.it o v.redd.it.

Formato de Respuesta

Ambos endpoints devuelven un wrapper de respuesta consistente:

Campo	Tipo	Descripcion
`data`	`object \| null`	El payload de la respuesta. `null` si la solicitud fallo en el origen. La busqueda devuelve `{searchQuery, totalResults, nextCursor, posts}`; la publicacion devuelve `{post, comments}`.
`response_time`	`number`	Tiempo de respuesta del servidor en milisegundos
`credits_used`	`number`	Numero de creditos consumidos (siempre 2 para endpoints de Reddit)
`credits_remaining`	`number`	Creditos restantes en tu periodo de facturacion actual

Respuestas de Error

Estado	Descripcion
`400`	Solicitud invalida -- falta `query` / `url`, cursor invalido o valor de orden no soportado
`401`	No autorizado -- API key faltante o invalida
`429`	Limite de tasa o uso excedido para tu plan
`502`	Error de origen -- reintenta despues de una breve pausa
`503`	Origen no disponible -- reintenta mas tarde
`504`	Timeout de origen -- las solicitudes a Reddit pueden tardar 5-15 segundos; reintenta con un timeout de cliente mas largo

Consulta Errores para la referencia completa de errores y mejores practicas de reintento.

Relacionado

Inicio Rapido -- obtiene tu API key y realiza tu primera solicitud
API de Google Search -- busca en Google con datos SERP estructurados
API de YouTube -- busca videos y extrae metadatos
API de Amazon -- busca productos de Amazon en 12 marketplaces
API de Walmart -- busca productos de Walmart con filtros de fulfillment
Limites de Tasa -- limites por nivel de plan

API de Reddit

Endpoints

Endpoint	Creditos	Descripcion
`POST /api/v1/reddit/search`	2	Buscar publicaciones de Reddit por consulta, orden y cursor de paginacion
`POST /api/v1/reddit/post`	2	Obtener una publicacion completa con comentarios en hilo por URL de Reddit

Autenticacion

Cabecera	Valor	Requerido
`Authorization`	`Bearer YOUR_API_KEY`	Si
`Content-Type`	`application/json`	Si

Busqueda de Publicaciones

Bash

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

Busca publicaciones en todo Reddit. Devuelve metadatos de publicaciones incluyendo titulo, URL, subreddit, autor, marca de tiempo y flag NSFW. Soporta paginacion mediante un token de cursor.

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`query`	`string`	--	Requerido. Consulta de busqueda (1-500 caracteres).
`sort`	`string`	`relevance`	Orden de resultados. Uno de: `relevance`, `hot`, `top`, `new`, `comments`
`cursor`	`string`	--	Token de paginacion del campo `nextCursor` de la respuesta anterior.

Ejemplo

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"
  }'

Ejemplo de Respuesta

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
}

Paginacion

Para obtener la siguiente pagina, pasa el valor de nextCursor de la respuesta anterior como el parametro cursor en tu siguiente solicitud. Cuando nextCursor es null, no hay mas resultados.

Detalle de Publicacion

Bash

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

Cuerpo de la Solicitud

Parametro	Tipo	Por defecto	Descripcion
`url`	`string`	--	Requerido. URL completa de la publicacion de Reddit (ej. `https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/`).

Ejemplo

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/"
  }'

Ejemplo de Respuesta

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
}

Reconstruccion del Arbol de Comentarios

url vs contentUrl

Formato de Respuesta

Ambos endpoints devuelven un wrapper de respuesta consistente:

Campo	Tipo	Descripcion
`data`	`object \| null`	El payload de la respuesta. `null` si la solicitud fallo en el origen. La busqueda devuelve `{searchQuery, totalResults, nextCursor, posts}`; la publicacion devuelve `{post, comments}`.
`response_time`	`number`	Tiempo de respuesta del servidor en milisegundos
`credits_used`	`number`	Numero de creditos consumidos (siempre 2 para endpoints de Reddit)
`credits_remaining`	`number`	Creditos restantes en tu periodo de facturacion actual

Respuestas de Error

Estado	Descripcion
`400`	Solicitud invalida -- falta `query` / `url`, cursor invalido o valor de orden no soportado
`401`	No autorizado -- API key faltante o invalida
`429`	Limite de tasa o uso excedido para tu plan
`502`	Error de origen -- reintenta despues de una breve pausa
`503`	Origen no disponible -- reintenta mas tarde
`504`	Timeout de origen -- las solicitudes a Reddit pueden tardar 5-15 segundos; reintenta con un timeout de cliente mas largo

Consulta Errores para la referencia completa de errores y mejores practicas de reintento.

Relacionado

Inicio Rapido -- obtiene tu API key y realiza tu primera solicitud
API de Google Search -- busca en Google con datos SERP estructurados
API de YouTube -- busca videos y extrae metadatos
API de Amazon -- busca productos de Amazon en 12 marketplaces
API de Walmart -- busca productos de Walmart con filtros de fulfillment
Limites de Tasa -- limites por nivel de plan