Escribe qué cuenta como observación
Formula una decisión revisable: entre los registros recibidos de r/science con replication, ¿cuáles hablan de repetir un estudio? Elige el registro como unidad y decide si incluirás publicaciones, comentarios o ambos. La consulta selecciona texto candidato; la lectura local asigna categorías. Una coincidencia no demuestra que un resultado científico se haya replicado.
Para el ejemplo de este sitio, estudia el uso del término replication en los registros recibidos de science. Define una observación por registro y justifica cualquier filtro por autor, tipo o puntuación. q es una búsqueda textual, no un muestreo aleatorio ni una clasificación científica del contenido. min_score impone un umbral numérico sin ordenar o certificar calidad; puede cambiar qué textos entran en tu análisis.
Fija también las reglas locales: cómo tratar campos ausentes, duplicados recibidos y referencias que no puedas resolver. Separa estas reglas de los parámetros del API. Registra sus cambios como versiones del protocolo en vez de ajustar silenciosamente los criterios después de ver los resultados. Tu documentación debe permitir revisar las decisiones, sin afirmar que el archivo sea completo o que el experimento carezca de sesgos.
Registra la consulta que ejecutaste
Parte de GET https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3, el ejemplo de la portada. Guarda la ruta y los parámetros efectivos, con los valores predeterminados que utilices. Autentica desde servidor mediante X-API-Key: <clave> o Authorization: Bearer <clave>, pero elimina secretos de los archivos compartidos. La página Obtener clave API explica la emisión antes de pagar y la gestión del acceso.
Al probar replication crisis, añade una modificación al registro de consultas. q busca en title y text con operador and dentro del campo coincidente; no se limita a combinar una palabra del título con otra del cuerpo. Conserva por separado las respuestas de ambas formulaciones. Ninguna cubre todo el vocabulario de la replicación científica.
Guarda cada respuesta recibida antes de limpiar o agregar campos. Anota por separado la hora de ejecución del cliente, el estado HTTP y los límites de paginación encontrados. from y to filtran created_utc con YYYY-MM-DD UTC e incluyen todo el día final; no describen el momento de entrada en el archivo. Los registros son planos y pueden variar: parent_id o link_id presentes permiten relaciones locales, sin garantizar una conversación completa ni admitir filtros por esos identificadores.
Anota el significado sin cambiar el original
Crea una tabla local con el identificador disponible, una categoría y el motivo. Para empezar, distingue repetición de estudios, replicación biológica y contexto insuficiente. Son etiquetas tuyas, no campos del API. Deja los casos ambiguos pendientes de revisión y conserva el texto original junto a la versión preparada para el análisis.
Puedes calcular un hash del archivo guardado y registrar su nombre junto con la versión del código y sus dependencias. Ese hash identifica los bytes de tu copia; no demuestra autenticidad del contenido, representatividad o integridad del archivo remoto. Mantén un archivo original y otro derivado, y documenta qué transformación los conecta. Esta organización es trabajo de tu equipo, no una función de almacenamiento o versionado suministrada por el API.
Compara una modificación cada vez
Al revisar el análisis, usa primero los archivos guardados y la versión documentada del código. Si tu propio método utiliza aleatoriedad, anota su configuración y las condiciones del entorno. Comprueba si las diferencias proceden de datos, reglas o herramientas. Esto permite investigar discrepancias; conservar un archivo por sí solo no garantiza resultados idénticos en cualquier entorno ni certifica la validez de una conclusión científica.
Primero mantén fija la copia guardada y cambia solo la regla de anotación. Explica qué decisiones cambiaron y por qué. Una nueva recuperación remota merece su propia entrada. Si cambian a la vez los datos y las reglas, la diferencia de recuentos no puede atribuirse únicamente a uno de esos cambios.
Una recuperación nueva es otra observación del archivo. limit y page van de 1 a 100, con una página por solicitud; _doc no es cronología, relevancia o puntuación. Lee 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 ni inmutabilidad. /v1/subreddits solo acepta prefix y limit para nombres, sin page.
Cierra la ejecución con sus límites
Cierra con parámetros, páginas recibidas, registros conservados, exclusiones y casos sin resolver. Indica por qué paraste y qué versión del criterio produjo los recuentos. Limita las conclusiones a ese material: un total desconocido, contexto ausente o un vacío del archivo no demuestra silencio de la comunidad.
Presupuesta un crédito por cada recuperación exitosa, incluso vacía o repetida: $1 por 1000 solicitudes y recarga mínima de $50. Los 100 créditos de prueba son condicionales. Las solicitudes inválidas no descuentan saldo; los fallos del origen devuelven la reserva. Perder la respuesta puede ocultar un éxito cobrado y un fallo local 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 comprueba el buscador ni reproduce resultados.
