Define la tarea y la unidad de anotación
Antes de recopilar comentarios, escribe qué debe aprender o evaluar el modelo y qué puede decidir una persona a partir de un solo registro. Por ejemplo, puedes preparar una revisión local de comentarios recibidos de MachineLearning para diseñar tus categorías. No conviertas la primera página en una muestra aleatoria de toda la comunidad. Reddit Datasets es un archivo histórico independiente, sin afiliación a Reddit ni cobertura completa garantizada.
Define reglas de inclusión, campos necesarios y una opción para casos que no puedan juzgarse por falta de contexto. min_score aplica un umbral numérico sin ordenar ni certificar calidad; no transforma la puntuación disponible en una etiqueta de sentimiento o de corrección. q es búsqueda textual y puede alterar la selección. Justifica esos filtros en tu ficha para que otra persona entienda qué material quedó fuera por decisión tuya.
Separa la ficha de la colección de los registros originales. En ella puedes guardar ruta, parámetros efectivos, momento de recuperación y versión de tus reglas. Eso es documentación local, no un manifiesto emitido por el servicio. Los campos pueden faltar y el archivo puede cambiar. La trazabilidad de tu trabajo no certifica autenticidad de cada publicación, ausencia de sesgos o idoneidad del resultado para entrenar un modelo.
Recupera una página y conserva la evidencia disponible
Parte de GET https://api.redditdatasets.com/v1/comments?subreddit=MachineLearning&limit=3, el ejemplo de la portada. Solicita hasta tres comentarios de esa comunidad, sin muestreo aleatorio o descarga masiva. Autentica desde servidor mediante X-API-Key: <clave> o Authorization: Bearer <clave>. La página Obtener clave API explica la emisión antes del pago; excluye secretos de fichas públicas y archivos de anotación. posts sirve para publicaciones y search permite ambos tipos si no restringes kind.
Valida HTTP y data antes de incorporar ejemplos. Conserva los valores presentes, marca ausencias y registra por qué excluyes un registro. from y to filtran created_utc con fechas YYYY-MM-DD UTC, incluyendo todo el último día, no el momento de incorporación al archivo. /v1/item requiere id y puede no encontrar un vínculo. parent_id y link_id solo permiten relaciones locales cuando existen; no son filtros de consulta ni garantizan recuperar el contexto completo.
Guarda la respuesta real y su paginación antes de limpiar texto. limit y page admiten de 1 a 100, con una solicitud por página. _doc no ordena por tiempo, relevancia o puntuación. Interpreta total con relation: eq es exacto para la consulta, gte una cota inferior y unknown un total no fiable, posiblemente null. Recorrer páginas, dividir fechas o quitar duplicados no prueba exhaustividad o registros únicos. /v1/subreddits solo busca nombres con prefix y limit, sin page; no verifica cobertura temporal.
Añade etiquetas y particiones como decisiones propias
Guarda texto fuente, etiquetas y motivos de exclusión por separado. Puedes versionar las instrucciones de anotación y registrar desacuerdos para revisarlos con tu equipo. Si decides dividir entrenamiento y evaluación, examina entre los registros recibidos los identificadores repetidos, textos similares y relaciones disponibles antes de asignar grupos. Esa comprobación local puede detectar algunos cruces, pero no garantiza ausencia de filtraciones, relaciones desconocidas o duplicados en todo el archivo.
Para repetir el procesamiento, utiliza la copia guardada junto con las versiones del código y las reglas de anotación. Una nueva recuperación remota es otra colección posible, no una versión inmutable de la anterior. Describe lo que recibiste y tus transformaciones sin anunciar representatividad, validez científica o rendimiento garantizado del modelo. Respeta las leyes aplicables y los derechos de terceros al conservar o compartir materiales; el acceso al API no sustituye esa responsabilidad.
Cada recuperación exitosa cuesta un crédito, incluso vacía o repetida: $1 por 1000 solicitudes y recarga mínima de $50 por 50000 créditos comprados. Los 100 de prueba son condicionales. Las solicitudes inválidas no descuentan; los fallos del origen devuelven la reserva. Una desconexión puede ocultar un éxito cobrado y rechazar ejemplos localmente no lo reembolsa. Consulta precios y documentación: corrige 400, revisa clave con 401, saldo con 402 y limita repeticiones con espera ante 429. /v1/status no certifica el corpus ni comprueba el buscador.
