Fundamentos del Archivo Independiente
Subreddit API permite consultar un archivo histórico independiente, sin afiliación oficial ni datos en tiempo real. No ofrece publicación, votos o mensajes privados. Un registro histórico no describe necesariamente el estado actual de Reddit. Define qué pregunta puedes explorar con la selección disponible, sin presentar sus textos como la voz de todos los miembros de una comunidad.
La consistencia debe estar en tu procedimiento, no en una supuesta inmutabilidad del servicio. Conserva respuestas originales, parámetros, fecha de ejecución y versión de las reglas de análisis. Repetir la transformación sobre esos archivos permite revisar tus decisiones. Repetir la consulta remota no garantiza idénticos registros, y una selección conservada no demuestra cobertura completa del archivo.
Empieza con GET https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3. q=soil busca el término, subreddit=gardening limita la comunidad y limit=3 pide como máximo tres registros. Puede haber menos o ninguno. La muestra no establece uniformidad de cobertura, representatividad o ausencia del tema en las conversaciones no recuperadas. Define la segunda comunidad por separado y anota por qué la elegiste.
Filtros para la Comparación de Discusiones
Para la segunda consulta, conserva el término y cambia subreddit si esa es la variable de comparación. soil puede tener distintos usos y no recoge automáticamente todas sus traducciones o sinónimos. Examina los textos obtenidos y documenta cómo decides cuáles hablan del suelo de cultivo. Una búsqueda por palabra no elimina por sí sola todo el contenido ajeno a tu pregunta.
Mantén iguales from y to, en YYYY-MM-DD UTC con to inclusivo, y kind como post o comment. Si mezclas publicaciones y comentarios, explica cómo los cuentas para que un cambio de unidad no parezca una diferencia de vocabulario. Conserva criterios de inclusión y exclusión antes de calcular frecuencias, sin atribuir una diferencia observada a toda la comunidad.
min_score selecciona un umbral numérico y no ordena ni mide objetivamente la calidad del contenido. Aplicarlo puede cambiar la composición de cada muestra. Si lo utilizas, registra el valor y considera ese sesgo al interpretar las diferencias. El servicio recupera registros; una clasificación de tono o sentimiento debe proceder de tu propio método local y explicitar sus límites.
Mejores Prácticas y Limitaciones
Explora nombres con /v1/subreddits?prefix=gar, sin tratar sus agregados como cuentas globales exactas. Luego consulta /v1/search por separado con q, subreddit, author, kind y los demás filtros admitidos. Los filtros author o kind no pertenecen a /v1/subreddits. Las respuestas son planas; agrupa parent_id o link_id solo cuando aparezcan, sin garantizar una conversación completa.
Hay hasta 100 registros por petición y 100 páginas por consulta, en orden _doc, no cronológico ni de relevancia. eq indica un total exacto, gte un límite inferior y unknown un total no fiable, posiblemente nulo. Ni esos estados ni el recorrido de páginas acreditan recuperación exhaustiva, muestras equivalentes o ausencia de duplicados. Guarda estas limitaciones junto con los resultados.
Control de acceso y presupuesto
Envía Authorization: Bearer <clave> o X-API-Key: <clave> desde tu servidor. 400 indica parámetros inválidos, 401 problema de clave, 402 saldo insuficiente y 429 límite de frecuencia. Las peticiones inválidas no descuentan saldo; los fallos del proveedor devuelven la reserva. Una conexión interrumpida puede seguir a un éxito cobrado y cada repetición correcta cuesta otro crédito.
Consulta Documentación para verificar filtros, Precios para contar las páginas y Obtener clave API para gestionar acceso y saldo. /v1/status no se cobra, pero solo devuelve una declaración estática y confirma una respuesta HTTP, sin comprobar la búsqueda. Al presentar una comparación, distingue recuentos locales, ejemplos textuales y conclusiones interpretativas; la API no proporciona un informe de sentimiento ni una medida de consenso.
