Premier échantillon : soil dans gardening
Commencez par GET https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3. q=soil recherche le terme, subreddit=gardening sélectionne la communauté et limit=3 demande au maximum trois enregistrements, éventuellement moins ou aucun. Envoyez Authorization: Bearer <clé> ou X-API-Key: <clé> depuis votre serveur. Le marqueur représente votre secret, jamais une clé publique utilisable.
Extrait JSON synthétique, sans résultat réel : {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. Le solde est fictif et aucun champ de contenu n’est présumé. Examinez les textes effectivement reçus, puis interrogez séparément une autre communauté en conservant les autres critères. Le serveur ne calcule pas cette comparaison.
Des archives pour une question de recherche
Subreddit API donne accès à des archives historiques indépendantes, sans affiliation officielle avec Reddit et sans données en temps réel. Elles ne garantissent ni couverture complète ni immutabilité ou disponibilité permanente. Les résultats décrivent une sélection accessible lors de votre requête, sans représenter automatiquement les membres actuels ou toutes les discussions d’une communauté.
Pour comparer le vocabulaire, conservez le même terme, le même type de contenu et le même intervalle temporel. Définissez comment vous comptez un mot et traitez ses différents sens. soil ne couvre pas automatiquement tous ses synonymes ou traductions. Des critères identiques ne rendent pas deux sélections équivalentes, aléatoires ou représentatives ; expliquez les exclusions avant de tirer une conclusion.
Les réponses sont plates, sans arbre de discussion assemblé par le serveur. Si parent_id ou link_id apparaissent, vous pouvez regrouper localement les enregistrements, sans garantie de conversation complète. Ces champs ne sont pas des filtres exposés. Les comptes de vocabulaire et classifications de ton relèvent de votre méthode locale ; l’API ne fournit pas d’analyse de sentiment.
Filtres et limites observables
La recherche accepte q, subreddit, author, kind, from, to, min_score, limit et page. kind accepte post ou comment ; les dates sont YYYY-MM-DD en UTC, avec to inclusif. min_score applique un seuil sans trier ou mesurer la qualité. L’ordre _doc est documentaire interne, ni chronologique ni fondé sur la pertinence ou le score.
Les limites sont de 100 enregistrements par requête et 100 pages par recherche. eq indique un total exact, gte une borne inférieure et unknown l’absence de total fiable, éventuellement nul. Aucun état ni parcours des pages ne prouve une récupération exhaustive ou sans doublons. Conservez réponses, paramètres et règles pour répéter votre analyse locale, sans supposer des résultats futurs identiques.
Compte, crédits et paiement
Chaque récupération réussie coûte un crédit, même vide : $1 pour 1000 requêtes. Le minimum de $50 achète 50000 crédits, sans abonnement ni expiration des crédits achetés. La clé apparaît à l’inscription avant paiement. Un essai de 100 crédits peut être accordé selon les contrôles anti-abus du réseau, sans attribution garantie. Clé et solde sont propres au domaine.
Connectez-vous et créez une facture avant de transférer. Suivez son destinataire et son montant exacts avec USDT sur TRON TRC20 ou USDC sur Ethereum mainnet ERC20, puis demandez la vérification avec le hash. Seul un transfert authentique confirmé ajoute des crédits, sans délai garanti. L’identifiant unique ne signifie pas une nouvelle adresse par facture.
Les requêtes invalides ne débitent pas le solde ; les erreurs du fournisseur de recherche restituent la réserve. Une interruption côté client peut suivre un succès facturé et une nouvelle tentative réussie coûte un autre crédit. /v1/status est public et gratuit : sa déclaration statique et sa réponse HTTP ne vérifient pas la recherche ou la disponibilité des archives.
