Rutas y autenticación
Dirige las peticiones a api.redditsearchapi.com y utiliza la clave de este sitio para las consultas autenticadas. Mantén la credencial en tu servidor y evita incluirla en enlaces públicos o registros de diagnóstico. La clave y el saldo pertenecen a este dominio; no sirven como acceso compartido a otras marcas.
La ruta /v1/search permite combinar los filtros de búsqueda. Usa /v1/posts para publicaciones y /v1/comments para comentarios; ninguna de estas dos rutas exige id. Para recuperar un registro por identificador, utiliza /v1/item con id. Escoge la ruta según la tarea, sin suponer que todas aceptan los mismos parámetros.
Con /v1/subreddits puedes explorar comunidades mediante prefix. La ruta pública /v1/status no requiere clave ni consume créditos: devuelve una declaración estática sobre el alcance histórico del servicio e indica que la aplicación HTTP responde. No comprueba el motor de búsqueda ni confirma disponibilidad, cobertura o latencia del archivo.
Filtros, fechas y forma de los resultados
Los filtros de búsqueda son q, subreddit, author, kind, from, to, min_score, limit y page. Los valores de kind son post y comment. Usa fechas YYYY-MM-DD en UTC; el límite to es inclusivo. Al traducir las etiquetas de tu interfaz, conserva los nombres y valores literales de los parámetros enviados.
limit admite de 1 a 100 registros y page de 1 a 100 páginas por consulta. Los resultados siguen el orden interno _doc del archivo: no es orden cronológico, de relevancia ni de puntuación. min_score solo filtra. No hay una interfaz para consultas arbitrarias ni una función de exportación masiva exhaustiva.
La respuesta contiene registros planos, no árboles de conversación montados por el servidor. Si aparecen parent_id o link_id, puedes agrupar los registros localmente, sin garantizar que estén todos sus antecesores. Esos identificadores de relación no son filtros de consulta disponibles. Comprueba qué campos están presentes antes de construir tu vista.
Totales, errores y consumo
Interpreta el total junto a su relación: eq indica un valor exacto para la consulta, gte un límite inferior y unknown la ausencia de un total fiable, que puede ser nulo. Ninguno de estos valores acredita la cobertura completa de Reddit. Tampoco presupongas que los recuentos agregados de comunidades son globalmente exactos.
El código 400 indica una petición inválida; 401, una clave ausente o incorrecta; 402, saldo insuficiente; y 429, un límite de frecuencia alcanzado. Corrige la causa antes de repetir la operación. En particular, no resuelvas un error de autenticación aumentando la paginación ni un saldo agotado repitiendo la misma petición.
Cada recuperación correcta consume un crédito, también si está vacía. Las peticiones inválidas no descuentan créditos y los fallos del proveedor de búsqueda devuelven la reserva. Un fallo de conexión del cliente puede ocurrir después de una respuesta correcta del servidor; repetirla correctamente vuelve a consumir crédito. Limita los reintentos y registra su motivo.
