Arquitectura y Rutas Principales
La API permite consultar registros históricos de Reddit mediante rutas de lectura: /v1/search para buscar texto, /v1/posts para publicaciones y /v1/comments para comentarios. /v1/item requiere el id de un registro, mientras que /v1/subreddits permite buscar nombres de comunidades mediante prefix y limit. /v1/status es público y no consume créditos; devuelve una descripción estática del servicio y confirma únicamente que la aplicación HTTP responde.
Cada ruta tiene una función distinta en la recuperación del archivo, que no refleja la actividad en directo de Reddit. Al comparar transit y housing, conserva la misma ruta y el mismo tipo de registro para que esas decisiones no expliquen por sí solas las diferencias entre las selecciones. El endpoint público de estado no comprueba el motor de búsqueda, la disponibilidad de registros ni la cobertura del archivo; no sustituye la lectura del resultado real de una consulta.
Las rutas no utilizan esquemas de autenticación OAuth tradicionales, lo que simplifica la conexión para servicios automatizados. En su lugar, se emplea una clave de API única generada durante el registro. Esta clave se muestra una sola vez inmediatamente después de la creación de la cuenta, antes del pago. Es fundamental conservar este identificador en un lugar seguro, ya que no se envía por correo electrónico y no se puede recuperar si se pierde, asegurando que cada solicitud sea auditada correctamente.
Filtros, Límites y Navegación de Resultados
Los filtros permiten refinar las consultas mediante parámetros como q para búsqueda de texto, subreddit, author, y fechas ISO en formato from y to. También se puede filtrar por min_score y especificar kind como post o comment. Los límites de paginación son estrictos: cada solicitud puede recuperar como máximo 100 registros y una consulta puede navegar hasta 100 páginas. Estos límites previenen la sobreutilización del servicio y aseguran respuestas consistentes para aplicaciones que requieren volúmenes de datos manejables.
El orden de los documentos en el archivo no es necesariamente cronológico, lo que es crucial para el análisis temporal preciso. La paginación acotada no garantiza una cobertura completa del archivo ni una ingestión exhaustiva de todos los registros disponibles. Los totales de paginación indican cuántos resultados existen, pero estos números pueden ser exactos, un límite inferior o desconocidos, dependiendo de la implementación interna. Esto significa que no se puede asumir que alcanzar el final de las páginas signifique haber visto todos los datos posibles.
La especificación de límites entre uno y cien registros por página permite un control granular sobre el procesamiento de datos. Al iterar páginas, los analistas deben considerar que un total de registros puede ser simplemente un límite inferior, no un conteo exacto. Esto evita errores en la lógica de aplicaciones que asumen que la última página es el final absoluto. La navegación debe manejarse con precaución, verificando si la página siguiente existe antes de solicitarla, optimizando así el rendimiento de la red.
Errores, Autenticación y Estructura de Cuenta
La autenticación devuelve HTTP 401 si falta la clave o es inválida; 402 indica saldo insuficiente y 429 un límite de frecuencia. Corrige la causa antes de repetir. Las solicitudes inválidas no descuentan créditos y los fallos del servicio de origen devuelven el crédito reservado. Una respuesta perdida en el cliente puede corresponder a un éxito ya cobrado; un reintento exitoso consume otro crédito. El endpoint de estado es público y gratuito, pero no verifica la salud del archivo.
El registro utiliza correo electrónico y una contraseña de 12–72 bytes UTF-8. No hay inicio de sesión con Google ni conexión de cartera. La clave se muestra una vez, inmediatamente después del registro y antes de pagar. Los posibles 100 créditos de prueba dependen de la elegibilidad contra abusos de toda la red. Una recarga de pago tiene un mínimo de $50 y añade 50000 créditos, que no expiran. La factura vence una hora después de crearse; no hay un plazo de confirmación o abono garantizado.
La cuenta conserva el correo electrónico, hashes de contraseña y clave API, el prefijo de la clave, información de uso de créditos, datos de IP para prevenir abusos y registros de pagos. No se ha establecido un plazo fijo de conservación de los datos de cuenta. Guarda tus credenciales fuera de la tabla compartida y respeta las leyes aplicables y los derechos de terceros al utilizar los textos. El panel permite gestionar el acceso y las facturas; no debe presentarse como un canal de contacto o asistencia.
