Écrire la comparaison avant de consulter
Posez une comparaison concrète : comment demande-t-on une explication étayée scientifiquement dans AskSocialScience pendant deux semaines consécutives ? Prenez la publication initiale comme unité. Décidez à l’avance si un message sans question explicite ou sans référence à une étude respecte le critère. Consignez cette décision avant de voir les résultats pour qu’un exemple frappant ne change pas discrètement la règle appliquée à l’autre semaine.
Consignez séparément created_utc, lorsqu’il est présent, et la date de récupération notée par votre programme. from et to filtrent la création de l’enregistrement en UTC, non son entrée dans les archives ou le jour d’exécution du script. Écrire un fichier local aujourd’hui ne transforme pas son contenu en conversations d’aujourd’hui. Si un champ nécessaire à la vérification du périmètre temporel manque, conservez cette absence et prévoyez son traitement dans le protocole ; ne déduisez pas une date de la position dans la page.
Attribuer des bornes UTC à chaque semaine
Partez de GET https://api.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3 et ajoutez &from=2025-03-01&to=2025-03-07 pour la première fenêtre illustrative. Pour la seconde, utilisez from=2025-03-08&to=2025-03-14 et repartez de page=1. Ces dates définissent un exercice, pas une couverture connue des archives. Le format est YYYY-MM-DD en UTC, avec le jour to inclus entièrement. La requête d’accueil sans ces dates n’est pas délimitée dans le temps. Gardez la route, la communauté et le critère d’inclusion identiques entre les fenêtres.
Avant d’élargir la collecte, fixez le nombre de pages à tenter, la personne chargée des cas douteux et le lieu de sauvegarde des réponses. limit et page vont de 1 à 100 sur les routes de contenu, à raison d’une page par requête. _doc ne trie pas par création ; la première page ne représente ni le début ni la fin du mois. Gardez ensemble paramètres, page, heure de récupération et réponse originale. Relancer la requête peut produire d’autres données ; partager une copie enregistrée permet d’examiner cette copie précise, sans garantir la reproduction de la sélection distante.
Séparer les filtres du codage de recherche
Examinez d’abord le vocabulaire sans q ni min_score. Si q devient nécessaire, il recherche dans title et text et exige que tous les termes correspondent dans l’un de ces champs ; il ne répartit pas les correspondances entre titre et corps. min_score applique seulement un seuil, sans classer par qualité ou par date. Conservez vos codes de recherche et motifs d’exclusion dans des champs locaux, séparés des champs d’origine. Les archives ne fournissent pas ces appréciations.
Déclarer le point d’arrêt
Lors de la révision locale, distinguez une publication reçue, acceptée pour l’analyse ou exclue selon vos critères. Une exclusion thématique n’est pas une défaillance de l’API et ne rembourse pas le crédit consommé. min_score est seulement un seuil numérique, pas une appréciation de qualité scientifique. Lisez total avec relation : eq indique le total exact de la requête, gte une borne inférieure et unknown un total non fiable, éventuellement null. Aucun ne prouve le téléchargement de toute l’histoire de la communauté. Découper les mois ou supprimer les doublons ne prouve pas davantage l’exhaustivité.
Consultez la documentation, les tarifs et Obtenir une clé API avant une collecte plus large. Chaque récupération réussie, vide ou répétée, coûte un crédit ; $1 correspond à 1000 réussites et la recharge minimale payante est de $50. Les requêtes invalides ne sont pas débitées et une défaillance du service en amont restitue la réservation. Perdre une réponse peut masquer une réussite facturée : une nouvelle tentative réussie coûte un autre crédit. Fixez un plafond local de tentatives et décrivez les interruptions dans le rapport, avec les données reçues et les limites de sélection, sans présenter le corpus comme un recensement.
Laisser une note de méthode compréhensible
Terminez par une note expliquant pourquoi ces semaines et ces publications initiales ont été retenues, quels filtres ont été appliqués et pourquoi la collecte s’est arrêtée. Distinguez les effectifs reçus des cas acceptés et signalez les dates ou contextes manquants. Une durée identique et des budgets égaux ne rendent pas les sélections représentatives. Une différence de thèmes dans les textes examinés concerne ce matériau ; elle ne démontre pas à elle seule un changement dans toute la communauté.
