Define pregunta, unidad y criterios de inclusión
Antes de recuperar datos, formula una pregunta que puedas relacionar con contenido observable. Por ejemplo, puedes explorar cómo se usa la palabra sampling en registros recibidos de AskStatistics. Esa pregunta describe una búsqueda de texto en un archivo histórico independiente, no una muestra aleatoria de usuarios de Reddit. Define si analizarás publicaciones, comentarios o ambos, y qué limitaciones deberán acompañar la tabla final.
Anota por qué elegiste una comunidad y unos términos. Cambiar esos criterios cambia la selección; min_score añade una condición de puntuación, no una certificación de relevancia, fiabilidad o significación estadística. El archivo puede omitir registros y contexto. Una pregunta precisa ayuda a documentar decisiones, pero no garantiza cobertura, ausencia de sesgos o resultados adecuados para cualquier inferencia sobre toda la comunidad.
Elige /v1/search para ambos tipos, /v1/posts solo para publicaciones y /v1/comments solo para comentarios. kind usa los literales post y comment. Para un identificador conocido, /v1/item?id=... busca un registro individual, que puede faltar. /v1/subreddits admite prefix y limit para nombres que empiezan por un prefijo, no para descubrir automáticamente comunidades temáticamente relacionadas o enumerar un catálogo completo. La documentación detalla los parámetros de cada ruta.
Construye la consulta y conserva lo que llegó
Empieza por https://api.getredditdata.com/v1/search?q=sampling&subreddit=AskStatistics&limit=3, el ejemplo de inicio. q busca sampling, subreddit fija AskStatistics y limit solicita hasta tres registros. Usa GET con X-API-Key: <clave> o Authorization: Bearer <clave> desde tu servidor. Obtener clave API explica registro y panel de cuenta. La cookie Secure HttpOnly de ese panel es independiente de la autenticación que usa tu script para recuperar datos.
Puedes añadir from y to como fechas YYYY-MM-DD en UTC para filtrar created_utc. El día final se incluye completo; no se trata de la fecha de incorporación al archivo. Conserva los parámetros y la respuesta antes de transformar los campos en filas locales. Si otro analista recibe tu copia guardada, estará trabajando con esa copia; repetir la consulta remota no garantiza los mismos registros, campos u orden.
Define las columnas que necesita tu propio análisis y comprueba si cada campo está presente. Mantén separadas la información del registro, los parámetros de consulta y tus anotaciones. Los datos son planos; parent_id o link_id presentes permiten asociaciones locales, sin conversación completa garantizada ni filtros de consulta para esos campos. Una fila sin texto no debe convertirse en una cita inventada, y una referencia no resuelta no demuestra que se haya recuperado el mensaje referido.
Revisa totales, orden y presupuesto antes de ampliar
En las búsquedas de contenido limit y page van de 1 a 100, con una página por solicitud. Lee total con relation: eq expresa total exacto de la consulta, gte una cota inferior y unknown ausencia de total fiable, posiblemente null. Ninguno prueba que todos los resultados se hayan descargado ni que el archivo contenga toda la historia. Conserva los límites encontrados junto a la tabla en lugar de declarar una extracción completa.
_doc no representa orden temporal, relevancia, puntuación o aleatoriedad. Un orden local cambia la presentación, no el mecanismo de selección remoto. Dividir períodos o eliminar duplicados puede organizar tu trabajo, sin demostrar exhaustividad o unicidad. Trata HTTP 400 corrigiendo parámetros, 401 revisando clave, 402 consultando saldo y 429 limitando y espaciando intentos. /v1/status es público y gratuito, pero solo confirma HTTP y una declaración estática, no salud de búsqueda o saldo.
Cada recuperación exitosa cuesta un crédito, incluso vacía o repetida. Pedidos inválidos no descuentan saldo; un fallo del origen devuelve la reserva. Perder la respuesta en el cliente puede ocultar un éxito cobrado y otra tentativa exitosa cuesta otro crédito. Un error de limpieza o escritura local no cancela el coste remoto. Consulta los precios antes de ampliar: $1 por 1000 éxitos, recarga pagada mínima de $50 y 100 créditos de prueba condicionales a controles contra abusos.
