Autenticación y Gestión de Créditos
Para automatizar la recuperación de datos históricos de Reddit, primero debes registrar tu cuenta con correo y contraseña. Tras el registro, se muestra una clave API que debes guardar inmediatamente, ya que no se almacena en el navegador ni se envía por correo. La clave y el saldo corresponden a tu cuenta en apireddit.cc y no funcionan en otros sitios de la red. Puedes autenticar las solicitudes con Authorization: Bearer o X-API-Key.
El sistema de facturación cobra un crédito por cada solicitud de recuperación exitosa, incluyendo aquellas que devuelven resultados vacíos. Los fallos del origen devuelven la reserva a tu saldo; las solicitudes inválidas no consumen créditos. Puedes recargar tu cuenta pagando el monto exacto indicado en la factura del servidor y verificando la transacción con el hash correspondiente. Los créditos pagados no caducan, lo que permite una planificación a largo plazo para tus proyectos de automatización.
Las solicitudes de estado público no consumen créditos y solo verifican que el servidor HTTP responda, no la salud real de la base de datos de búsqueda. Si necesitas regenerar tu clave API por seguridad, deberás confirmar tu contraseña en la página de la clave. Este proceso invalida inmediatamente la clave antigua, por lo que tus scripts de automatización deben actualizarse al instante para evitar interrupciones en la recopilación de datos históricos.
Rutas, Filtros y Estructura de Respuestas
La API ofrece varias rutas principales para acceder al archivo histórico: búsqueda, publicaciones, comentarios, ítems específicos y subreddits. Puedes filtrar por texto, subreddit, autor, tipo (publicación o comentario) y fechas from/to en formato YYYY-MM-DD en UTC, con el día to incluido. q busca en title y text; varios términos se combinan mediante AND dentro de un campo coincidente. La puntuación mínima funciona estrictamente como un filtro numérico y no como un control de ordenación. Es importante recordar que las publicaciones y comentarios no requieren un identificador único para su consulta, a diferencia de los ítems individuales que sí lo necesitan.
Cada solicitud permite recuperar un máximo de cien registros y puedes iterar hasta cien páginas en una sola consulta. El orden de los documentos en el archivo no es cronológico ni se basa en la relevancia, sino en el orden interno del índice. Los totales paginados pueden indicar un número exacto, una cota inferior o ser desconocidos, lo que significa que no debes asumir que el archivo está completamente ingerido ni agotado al iterar todas las páginas disponibles.
Las respuestas de la API contienen registros planos, no árboles de hilos ensamblados por el servidor. Aunque los registros pueden incluir campos como padre o enlace, su agrupación local es opcional y no garantiza una conversación completa. No existen filtros de consulta expuestos para estos campos jerárquicos. Esta estructura simplificada es ideal para la automatización, ya que reduce la complejidad del procesamiento del lado del cliente y permite una integración más rápida y eficiente con tus flujos de trabajo.
Manejo de Errores y Límites de la API
Los errores de protocolo se indican con códigos HTTP de dígitos ASCII literales: 400 para solicitudes inválidas, 401 para clave ausente o inválida, 402 por crédito insuficiente y 429 para límites de tasa superados. Estos códigos numéricos deben leerse tal cual, sin traducciones o escritura en palabras, para garantizar la correcta integración en tus scripts de automatización. Un error 401 indica que tu clave de inquilino no es válida o ha quedado invalidada tras regenerarla, requiriendo una actualización inmediata.
El servicio no garantiza disponibilidad ni cobertura completa del archivo, ya que es un archivo histórico independiente y no la plataforma oficial de Reddit. No hay garantía de que la iteración de todas las páginas recupere todos los registros existentes. Además, no se ofrecen cláusulas de nivel de servicio, ni soporte para mensajes privados, votaciones o publicación de contenido. La privacidad de los datos se gestiona mediante hash de contraseñas y claves, almacenando también la información de IP para prevenir abusos de la API.
El flujo de trabajo de automatización debe considerar que el acceso se basa en créditos y no en suscripciones. Si tu script detecta un error 402, debe pausarse y comprobar el saldo. Es importante no asumir que el archivo está permanentemente disponible o que los registros no pueden perderse. La automatización debe ser robusta para manejar límites de tasa 429 y errores intermitentes, sin usar /v1/status como prueba de disponibilidad de la búsqueda. Si el cliente pierde la respuesta, el servidor puede haber completado y cobrado la solicitud; un reintento correcto consume otro crédito.
