Autenticación y Estructura de Datos
Envía peticiones GET a api.redditpostsapi.com. Las rutas de recuperación autenticadas aceptan Authorization: Bearer <clave> o X-API-Key: <clave>. /v1/status es público y no requiere clave. La cookie Secure HttpOnly del panel de cuenta cumple una función distinta y no sustituye esos encabezados. Guarda el secreto en el servidor y fuera de los archivos de análisis o diagnósticos públicos.
Las respuestas de la API contienen registros planos en lugar de árboles de hilos ensamblados por el servidor. Cuando los campos parent_id y link_id están presentes, los clientes pueden agruparlos localmente para reconstruir conversaciones. Sin embargo, no hay garantía de un ancestro completo ni de que la jerarquía esté totalmente presente en la respuesta inicial.
El archivo no utiliza un orden cronológico estricto para los documentos. Las iteraciones de página están limitadas a cien registros por solicitud y cien páginas por consulta. Este límite no garantiza una cobertura exhaustiva de todo el archivo, por lo que no se debe asumir que obtener todas las páginas disponibles significa haber ingerido todos los registros disponibles.
Filtros y Semántica de Búsqueda
La búsqueda admite q, subreddit, author, kind, from, to, min_score, limit y page. kind acepta post o comment; /v1/posts selecciona publicaciones y /v1/comments comentarios. Solo /v1/item exige id; /v1/subreddits acepta prefix y limit para explorar comunidades, sin contadores globales exactos garantizados. No hay filtros expuestos por parent_id o link_id para pedir una conversación completa.
El parámetro min_score actúa estrictamente como un filtro y nunca como un control de ordenación por puntuación. El orden de recuperación sigue el orden interno _doc del archivo, que no corresponde ni al orden cronológico ni al de relevancia. Es importante entender que la búsqueda no clasifica los resultados por score, sino que aplica la barrera mínima y devuelve los resultados en su orden de índice nativo.
from y to son fechas YYYY-MM-DD en UTC, con to inclusivo para todo el día. No son filtros de hora local ni aceptan timestamps intradía. Los totales usan eq para exacto, gte para límite inferior y unknown para ausencia de total fiable, posiblemente nulo. Ninguna relación garantiza cobertura completa. Cada petición admite hasta 100 registros y cada consulta hasta 100 páginas.
Errores y Límites de Recurso
400 indica una petición inválida, 401 una clave ausente o inválida, 402 saldo insuficiente y 429 límite de frecuencia. Las peticiones inválidas no descuentan saldo y los fallos del proveedor de búsqueda devuelven la reserva. Una conexión interrumpida en el cliente puede seguir a un éxito cobrado en el servidor; una repetición correcta cuesta otro crédito. Limita los intentos y registra la causa.
La página de estado /v1/status es pública y no cobra crédito alguno. Solo indica que el servidor HTTP responde y devuelve una divulgación estática del archivo histórico independiente. No verifica la salud del motor de búsqueda ni la disponibilidad de registros específicos. Por lo tanto, no asuma que una respuesta 200 implique que la búsqueda esté operativa internamente.
Cada recuperación correcta cuesta un crédito, incluso vacía: $1 por 1000 peticiones. La recarga mínima de $50 compra 50000 créditos, sin suscripciones ni caducidad de los créditos comprados. Para pagar, inicia sesión y crea una factura, sigue su destinatario e importe exactos y solicita verificación con el hash. Un pago auténtico confirmado añade saldo sin plazo garantizado, no mediante un contrato de token como destinatario.
Revisar la muestra photography
Prueba /v1/posts?subreddit=photography&min_score=10&limit=3 antes de ampliar el intervalo. min_score no garantiza relevancia o calidad: decide localmente si cada texto trata de equipo. Mantén separadas las palabras del autor y tus etiquetas. Conserva respuestas, filtros, fecha de ejecución y versión de las reglas para repetir el procesamiento local, sin prometer resultados idénticos en nuevas consultas.
