Reddit API Labs
Reddit API Labs
  1. Antes de contar menciones, decide qué significa replication

    Explora replication en r/science con un piloto documentado. Separa la consulta, los registros recibidos y las decisiones de interpretación.

    Obtener clave API

Ejemplo de solicitud

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3"

Una coincidencia textual abre una pregunta

Para un equipo de ingeniería de investigación, replication plantea primero una decisión de lectura: ¿el registro trata de repetir un estudio, de replicación del ADN o carece de contexto suficiente? Reddit API Labs da acceso de lectura a un archivo histórico independiente de Reddit, sin afiliación oficial ni actualizaciones en directo. Proporciona material para examinar; la clasificación científica corresponde a tu equipo.

Escribe el protocolo antes de transformar datos. Distingue los parámetros enviados al archivo de las reglas locales de inclusión, los campos necesarios y las decisiones de limpieza. Define si cada observación es una publicación o un comentario. Si falta texto, autor o fecha, registra el motivo de exclusión o el valor ausente; no lo sustituyas por información inventada para completar una tabla.

Una página para probar el criterio

Utiliza GET https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3. q=replication busca texto, subreddit=science limita la comunidad y limit=3 pide como máximo tres registros. No selecciona una muestra aleatoria ni verifica estudios de replicación. Sin kind pueden aparecer publicaciones y comentarios. Envía X-API-Key: <clave> o Authorization: Bearer <clave> desde tu servidor; ambas formas están admitidas. Excluye la clave de cualquier protocolo compartido.

q busca en title y text. Con varios términos, el operador and exige que aparezcan dentro de un mismo campo coincidente; repartirlos entre título y texto no asegura coincidencia. Pasar de replication a replication crisis cambia la selección. Registra esa prueba por separado, sin asumir que elimina todos los sentidos ajenos a tu pregunta.

Fragmento sintético, solo demostrativo: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. No procede de una llamada real y el saldo es ficticio. Una primera página vacía puede indicar un total exacto cero para esa consulta y aun así cuesta un crédito. No demuestra que nunca se haya discutido replication: los registros de science pueden faltar o no estar disponibles.

Conserva el material y el motivo de selección

Conserva la respuesta real sin sobrescribirla con campos normalizados. En un registro local guarda parámetros, fecha de ejecución de tu cliente y nombre del archivo recibido, sin confundir esa fecha con created_utc. Un hash que calcules del archivo ayuda a identificar tu copia; no certifica la procedencia ni la cobertura del archivo remoto. La documentación explica la estructura data, pagination y credits; la guía desarrolla el protocolo.

Un archivo histórico no es necesariamente una copia congelada. No se garantiza cobertura completa, permanencia, un esquema fijo o respuestas inmutables. Guardar los datos recibidos junto con código, dependencias y parámetros permite examinar y volver a ejecutar tu procesamiento local. No garantiza validez científica, ausencia de sesgo o que otra consulta remota encuentre los mismos registros. La recuperación nueva y el análisis de una copia guardada son operaciones distintas.

Fija el final del piloto antes de ampliarlo: examinar una página, revisar el criterio y decidir si hace falta más material. Cada solicitud admite hasta 100 registros y cada consulta hasta 100 páginas. El orden _doc no es cronológico ni depende de relevancia o puntuación; los tres primeros registros no son los tres más importantes.

Elige entre anotar y volver a consultar

En el cuaderno, distingue el coste de seleccionar textos del trabajo posterior de clasificarlos. Si la consulta replication y una prueba más estrecha con replication crisis terminan con éxito, son dos créditos aunque ambas estén vacías. La tarifa es $1 por 1000 solicitudes exitosas; la compra mínima de $50 aporta 50000 créditos sin suscripción ni caducidad. Una solicitud inválida no descuenta saldo y un fallo del origen devuelve la reserva. Si el cliente pierde la respuesta tras un éxito cobrado, otra recuperación exitosa cuesta otro crédito; la anotación local no revierte ese cargo.

Si el siguiente paso es anotar la copia guardada, continúa localmente. La guía desarrolla las decisiones de inclusión y la documentación aclara los parámetros. Para una nueva recuperación consulta la página de la clave y los precios. Más llamadas no convierten una selección incompleta del archivo en una muestra representativa.