Définir la question et préserver la sélection
Subreddit API donne accès à des archives historiques indépendantes, sans affiliation officielle avec Reddit et sans données en temps réel. Ni couverture complète, ni immutabilité, ni disponibilité permanente ne sont garanties. Définissez la question que les textes reçus permettent d’explorer, sans les présenter comme les opinions de tous les participants ou comme la situation actuelle de la plateforme.
Conservez les réponses originales, les paramètres, la date d’exécution et la version des règles locales. Vous pourrez répéter vos transformations sur ces fichiers pour examiner une classification. Cela ne prouve pas une couverture complète : une nouvelle requête avec les mêmes filtres peut renvoyer une autre sélection. Les points de contrôle ne figent pas la pagination du fournisseur.
La structure de réponse est plate, offrant des enregistrements simples sans arborescence de fils assemblée par le serveur. Bien que les champs parent_id et link_id puissent exister, le regroupement local est recommandé. Cela permet aux clients d'analyser les données brutes telles qu'elles sont stockées, sans supposer une hiérarchie narrative complète ou une cohérence sémantique garantie.
Un exemple de comparaison autour de soil
Commencez par GET https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3. q=soil recherche le terme, subreddit=gardening choisit la communauté et limit=3 demande jusqu’à trois enregistrements, éventuellement moins ou aucun. Pour une autre communauté, faites une requête séparée en conservant les autres critères. soil possède différents sens et n’inclut pas automatiquement ses synonymes ou traductions.
Maintenez les mêmes kind, from et to : kind vaut post ou comment et les dates sont YYYY-MM-DD en UTC, avec to inclusif. Précisez comment vous comptez publications et commentaires. Notez les textes absents et les exclusions. Des paramètres constants ne produisent pas automatiquement des échantillons équivalents, aléatoires ou représentatifs de chaque communauté.
min_score applique un seuil numérique, sans trier ni mesurer objectivement la qualité des discussions. Ce choix peut modifier la composition des deux sélections. Documentez le seuil et ses conséquences possibles avant d’interpréter une différence de vocabulaire. Les comptes de mots ou classifications de ton sont vos méthodes locales ; l’API n’offre pas de service d’analyse de sentiment.
Découverte, pagination et limites
Explorez des noms avec /v1/subreddits?prefix=gar, sans traiter les agrégations comme des comptes globaux exacts. Utilisez ensuite /v1/search avec q, subreddit, author, kind et les autres filtres de recherche. author et kind ne sont pas des paramètres de /v1/subreddits. Regroupez parent_id ou link_id uniquement lorsqu’ils apparaissent, sans supposer une conversation complète.
Chaque requête admet jusqu’à 100 enregistrements et chaque recherche jusqu’à 100 pages, en ordre documentaire _doc, ni chronologique ni fondé sur la pertinence. eq indique un total exact, gte une borne inférieure et unknown l’absence de total fiable, éventuellement nul. Aucune relation ou segmentation par dates ne démontre une collecte exhaustive ou sans doublons.
Envoyez Authorization: Bearer <clé> ou X-API-Key: <clé> depuis le serveur. 400 indique des paramètres invalides, 401 un problème de clé, 402 un solde insuffisant et 429 une limite de fréquence. Les requêtes invalides ne débitent pas le solde ; les erreurs du fournisseur restituent la réserve. Une rupture du client peut suivre un succès facturé et chaque nouvelle tentative réussie coûte un autre crédit.
Consultez Documentation pour les filtres, Tarifs pour budgéter les pages et Obtenir une clé API pour l’accès. /v1/status est public et gratuit, mais sa déclaration statique et sa réponse HTTP ne testent pas la recherche. Distinguez les recoupements observés dans vos textes, les fréquences locales et vos conclusions interprétatives ; aucun de ces éléments ne démontre à lui seul un consensus communautaire.
