Primera muestra: soil en gardening
Prueba GET https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3. q=soil busca ese término, subreddit=gardening restringe la comunidad y limit=3 pide como máximo tres registros, posiblemente menos o ninguno. Usa <clave> como marcador en ejemplos públicos. Después consulta una segunda comunidad por separado manteniendo los demás criterios; el servicio no realiza la comparación por ti.
Ejemplo sintético del contenedor, no resultado real: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. El saldo es ficticio. En los registros recibidos puedes contar vocabulario localmente, distinguiendo significados de soil y decisiones de traducción. La API no ofrece análisis de sentimiento. eq es un total exacto, gte un límite inferior y unknown un total no fiable, posiblemente nulo; ninguna relación prueba representatividad.
Consistencia Histórica y Filtros de Investigación
Subreddit API ofrece acceso a un archivo histórico independiente de Reddit, sin afiliación oficial ni datos en tiempo real. Permite examinar publicaciones y comentarios disponibles para una consulta. La independencia no garantiza cobertura completa, inmutabilidad o acceso permanente. Describe tus resultados como una selección archivada, sin atribuirlos automáticamente al estado actual de una comunidad.
Los usuarios pueden aplicar filtros consistentes para comparar discusiones en diferentes subreddits a lo largo del tiempo. Esta capacidad es fundamental para realizar análisis cualitativos y cuantitativos sobre cómo evolucionaron los temas de interés. Los datos están disponibles mediante una API REST, facilitando la integración con herramientas de análisis existentes para proyectos académicos o periodísticos.
Para comparar dos comunidades, conserva el mismo término, tipo de contenido e intervalo temporal y registra la selección que recibiste. Guarda las respuestas y tus reglas de clasificación local. Volver a enviar los mismos filtros no garantiza datos idénticos; repetir el análisis sobre archivos conservados permite revisar tus decisiones sin afirmar que el archivo remoto permanece congelado.
Flujo de Trabajo Práctico y Rutas de la API
Regístrate con correo y contraseña para obtener una clave antes de pagar. Envía las consultas autenticadas con Authorization: Bearer <clave> o X-API-Key: <clave>, desde tu servidor. La cookie Secure HttpOnly del panel tiene otra función. /v1/status es público y no necesita clave; las demás rutas de recuperación requieren la credencial de este dominio.
La búsqueda acepta q, subreddit, author, kind, from, to, min_score, limit y page. kind usa post o comment; las fechas son YYYY-MM-DD en UTC, con to inclusivo. min_score aplica una puntuación mínima, sin ordenar ni asegurar calidad. Cada petición admite hasta 100 registros y cada consulta hasta 100 páginas; recorrerlas no demuestra una extracción exhaustiva.
Los resultados siguen el orden documental interno _doc, no el cronológico, de relevancia o de puntuación. Son registros planos, sin árboles de conversación montados por el servidor. Puedes agrupar parent_id o link_id si aparecen, pero no hay filtros expuestos por esos campos ni garantía de una conversación completa. Mantén visibles las relaciones y los textos ausentes.
Limitaciones Clave y Estructura de Precios
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. No hay suscripciones y los créditos comprados no caducan. Las peticiones inválidas no descuentan saldo; los fallos del proveedor de búsqueda devuelven la reserva. Una conexión interrumpida en el cliente puede seguir a un éxito cobrado; cada repetición correcta cuesta otro crédito.
Las limitaciones incluyen la ausencia de funciones de escritura, como votar o enviar mensajes privados. El servicio solo permite lecturas de datos archivados. También se carece de garantías de disponibilidad (SLA) o índices de rendimiento específicos. Los errores del servidor upstream provocan un reembolso, pero esto no garantiza la disponibilidad inmediata de los datos o la velocidad de respuesta en momentos de alta carga para proyectos críticos.
La contraseña de registro debe tener 12–72 bytes. La clave aparece una sola vez y puede regenerarse tras iniciar sesión y confirmar la contraseña, invalidando inmediatamente la anterior. No hay restablecimiento de contraseña ni envío de claves por correo. Pueden concederse 100 créditos de prueba sujetos a controles contra abusos de la red, sin garantía de asignación. Clave y saldo pertenecen a subredditapi.com.
