Selecciona registros
Consulta /v1/search con q=search y subreddit=SideProject; empieza con limit=3.
Datos históricos de Reddit · API JSON
Añade búsqueda de conversaciones Reddit a tu aplicación
Usa registros archivados de Reddit para añadir búsqueda de conversaciones a una aplicación web o móvil. Este ejemplo solicita una página de hasta tres registros.
GETJSONHTTPS
Anatomía de la solicitud
/v1/searchSideProject01Cada solicitud correcta cuesta un crédito, incluso si el resultado está vacío.
100Páginas y límites
$1 / 1,000Facturación por solicitud
01 / Reddit App API
Reddit App API — De la consulta a datos útiles
Empieza con una selección pequeña. Conserva los campos y parámetros necesarios para el siguiente paso y procesa el resultado en tu aplicación.
Prepara la respuesta
Mantén la clave API en tu backend; envía al navegador o app móvil solo los datos seleccionados.
Úsala en tu proyecto
Guarda el permalink disponible con tus notas como referencia; la página enlazada podría dejar de estar disponible.
Una solicitud que puedes adaptar
curl --get --fail-with-body 'https://api.redditapp.com/v1/search' \
-H "Authorization: Bearer ${REDDIT_API_KEY}" \
--data-urlencode 'q=search' \
--data-urlencode 'subreddit=SideProject' \
--data-urlencode 'limit=3' \
--data-urlencode 'page=1'Este ejemplo solicita una página de hasta tres registros.
URL base de la API
https://api.redditapp.com/v1Controla el alcance de cada solicitud
Texto y comunidad
Combina q con subreddit o author para acotar la selección.
Fechas en UTC
Usa from y to con fechas YYYY-MM-DD. La fecha final incluye todo el día UTC.
Páginas y límites
Define limit y page y guarda los metadatos de paginación junto a los resultados.
Paga por solicitud correcta
Cada solicitud correcta cuesta un crédito, incluso si el resultado está vacío.
$1 por 1.000 solicitudes correctas
Recarga mínima: $50 · 50.000 créditos
FAQ / 08
Antes de integrar
¿Qué es Reddit App API?
Reddit App API es una API JSON independiente para registros históricos de Reddit. Ofrece rutas de lectura para búsquedas, publicaciones, comentarios, registros individuales y descubrimiento de subreddits. Reddit no opera este servicio ni está afiliado a él. Usa registros archivados de Reddit para añadir búsqueda de conversaciones a una aplicación web o móvil. Este ejemplo solicita una página de hasta tres registros.
¿Cómo obtengo una clave API?
Crea una cuenta con email y contraseña en este sitio. La clave aparece tras el registro, antes de tener que pagar; guárdala de forma segura porque se muestra una sola vez. Envíala desde tu servidor mediante X-API-Key o Authorization: Bearer. Regenerarla invalida la clave anterior.
¿Cuánto cuesta Reddit App API?
El precio es $1 por 1.000 solicitudes correctas. La recarga mínima es $50 por 50.000 créditos. Cada solicitud correcta consume un crédito, incluso sin coincidencias. Las solicitudes inválidas no se cobran; los fallos del origen activan un reembolso que puede requerir conciliación. Un timeout no determina por sí solo el cargo final.
¿Qué filtros puedo usar para buscar registros de Reddit?
Usa q para búsqueda de texto analizado junto con subreddit, author, kind, from, to o min_score. Las palabras se combinan con AND; no es búsqueda semántica ni un DSL arbitrario. Las fechas usan YYYY-MM-DD en UTC y to incluye todo el día final. Empieza con los parámetros documentados.
¿Ofrece Reddit App API acceso a Reddit en directo?
No. El servicio consulta un archivo histórico, no el feed en directo de Reddit. No publica, vota, envía mensajes privados ni realiza acciones de Reddit OAuth. La ruta pública /v1/status describe el alcance del servicio; no demuestra la salud del archivo, su cobertura completa ni la disponibilidad actual de una página original.
¿Puedo exportar todos los registros que coincidan?
No necesariamente. Cada solicitud devuelve hasta 100 registros y page admite valores de 1 a 100. Lee total con pagination.relation: exacto, límite inferior o desconocido. El orden es el del archivo, sin garantía cronológica ni de relevancia. Alcanzar la última página accesible no demuestra que la muestra sea exhaustiva.
¿Puedo usar la misma clave en otro dominio?
No. Las cuentas, claves API y saldos están separados por sitio. Usa la clave emitida para este dominio con su propio host API HTTPS. Guárdala en la configuración del servidor, nunca en JavaScript del navegador, repositorios públicos o registros compartidos. Una clave de otro sitio no sustituye una cuenta local.
¿Qué solicitud debería probar primero?
Empieza con /v1/search, q=search, subreddit=SideProject, limit=3 y page=1. Esta solicitud pequeña permite revisar campos antes de desarrollar una importación o interfaz. Si es correcta, cuesta un crédito incluso con resultado vacío. Ajusta el tema y la comunidad a tu tarea: el ejemplo no promete una cantidad fija de registros.
API / Reddit App API
Obtener clave API Crea la primera solicitud
Crea una cuenta, guarda la clave y adapta el ejemplo a tu tarea.
Continúa con una guía
Añade una pausa de lectura a la preparación del viajeNo dejes que una lista vacía explique todos los resultadosQuien camina necesita un buscador, no tu clave del archivoMostrar más debe significar una sola página siguientePresupuesta lo que solicita la app, no lo que ve el lectorLa fecha debe explicar la evidencia, no adornar la tarjetaHaz que cada tarjeta explique el registro recibidoGuarda una referencia sin prometer que siempre estará disponibleConstruye la funciónGuías
