Collecter des questions en expliquant ses choix

API de collecte Reddit pour étudier AskSocialScience : définir la question, examiner trois publications et documenter la sélection sur deux semaines.

Obtenir une clé API

Exemple de requête

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3"

Qu’est-ce qu’une question de recherche dans ce corpus ?

Supposons que votre équipe étudie la manière de demander des explications fondées sur les sciences sociales dans AskSocialScience pendant deux semaines. L’unité retenue est la publication initiale, pas l’ensemble de ses réponses. Décidez d’abord si un message sollicitant des études sans question explicite entre dans le corpus. Reddit Collector propose une API de collecte de données issue d’archives historiques indépendantes de Reddit ; ce n’est ni un service officiel ni une source en direct. L’exercice produit un ensemble délimité de publications reçues avec des décisions de sélection documentées. Il permet d’examiner des formulations, sans mesurer l’opinion de toute la communauté.

Les archives ne garantissent ni la conservation de toutes les publications ni des résultats immuables. Une sélection filtrée ne constitue pas non plus un échantillon aléatoire ou représentatif. Consignez les raisons du choix d’AskSocialScience et les cas exclus de l’étude. Séparez la date de création d’un enregistrement de la date à laquelle votre programme le récupère. Cette dernière décrit une opération de votre équipe ; elle ne situe pas la conversation dans la période historique retenue.

Trois publications pour découvrir le matériau

La requête initiale est GET https://api.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3. subreddit désigne la communauté et limit demande au plus trois publications, sans commentaires. Cette requête ne contient aucune date : elle ne délimite donc pas encore une période d’étude. Envoyez X-API-Key: <clé> ou Authorization: Bearer <clé> depuis votre serveur ; les deux en-têtes sont acceptés. Ajoutez from et to pour définir la période, selon la documentation et l’exercice du guide.

Exemple synthétique, sans requête exécutée : {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. Le solde est fictif et ne décrit ni votre compte ni la disponibilité d’AskSocialScience. Une réponse vide réussie coûte un crédit. Conservez la réponse réelle avec les filtres et l’heure de récupération ; vérifiez ensuite les champs présents et préparez vos propres annotations. La première page suit l’ordre interne _doc, sans chronologie ni tirage aléatoire garantis.

Décider quels cas peuvent être écartés

Gardez la première inspection assez ouverte pour découvrir le vocabulaire des auteurs. Une publication peut décrire une étude sans contenir le mot prévu. Un seuil de score peut éliminer une question peu connue. Ajoutez q ou min_score lorsque vous savez expliquer quels cas chaque critère exclut et pourquoi. Si la lecture vous amène à modifier la règle, conservez une nouvelle version du protocole pour distinguer les sélections.

Pour comparer les semaines, appliquez les mêmes critères d’inclusion et fixez un budget de requêtes pour chaque période. Des budgets égaux ne garantissent pas une couverture égale. Si une semaine atteint la limite de pagination et que l’autre fournit peu de matériau, décrivez ces deux situations. La différence dans les données reçues ne démontre pas à elle seule une différence dans l’activité de la communauté.

Passer du protocole aux requêtes

Conservez avec les réponses une fiche précisant communauté, dates, unité, exclusions et motif d’arrêt. Le guide transforme cette fiche en deux fenêtres UTC ; la documentation explique les paramètres. Préparez l’accès sur la page de la clé. Le tarif est de $1 pour 1000 requêtes réussies, même vides ; le rechargement minimal de $50 ajoute 50000 crédits payés. Comptez les requêtes séparément des publications retenues.