Adresse, clé et choix des routes
Les appels utilisent api.redditsearchapi.com. Pour les récupérations authentifiées, employez la clé délivrée sur ce site et conservez-la sur votre serveur. Ne l’insérez ni dans des liens publics ni dans le code distribué aux navigateurs des utilisateurs. La clé et le solde sont propres à ce domaine, sans accès partagé aux autres marques.
La route /v1/search sert aux recherches combinant plusieurs filtres. /v1/posts et /v1/comments ciblent respectivement les publications et les commentaires sans exiger id. Pour un enregistrement identifié, utilisez /v1/item avec id. Le choix de la route précède celui des paramètres : toutes les routes n’acceptent pas nécessairement les mêmes critères de recherche.
Utilisez /v1/subreddits avec prefix pour explorer les noms de communautés. La route publique /v1/status ne nécessite pas de clé et ne consomme aucun crédit. Elle présente une déclaration statique sur le périmètre historique du service et indique que l’application HTTP répond ; elle ne teste pas le moteur de recherche ni la disponibilité des archives.
Paramètres et représentation des données
Les paramètres de recherche sont q, subreddit, author, kind, from, to, min_score, limit et page. kind accepte les valeurs littérales post et comment. Les dates utilisent YYYY-MM-DD en UTC, avec une borne to inclusive. Traduisez les libellés de votre formulaire, mais conservez les noms techniques et les valeurs attendues lors de l’envoi.
limit va de 1 à 100 enregistrements par requête et page de 1 à 100 pages par recherche. L’ordre _doc est l’ordre documentaire interne des archives, pas un classement chronologique, par pertinence ou par score. min_score filtre seulement les résultats. Aucune requête DSL arbitraire ni exportation massive exhaustive n’est proposée.
Les réponses contiennent des enregistrements plats, pas des arbres de discussion assemblés par le serveur. Si parent_id ou link_id sont présents, votre application peut les utiliser pour un regroupement local. Ces champs ne sont pas des filtres de recherche disponibles et leur présence ne garantit pas que toute l’ascendance d’une discussion soit récupérée.
Totaux, erreurs et facturation
La relation eq indique un total exact pour la recherche ; gte indique une borne inférieure ; unknown signifie qu’aucun total fiable n’est disponible, éventuellement avec une valeur nulle. Un total ne prouve pas la couverture complète des archives. Ne présentez pas non plus les décomptes agrégés de subreddits comme des chiffres globaux garantis exacts.
Le code 400 signale une requête invalide, 401 une clé absente ou invalide, 402 un solde insuffisant et 429 une limite de fréquence atteinte. Traitez chaque cause séparément avant de recommencer. Une nouvelle tentative ne corrige ni un paramètre incorrect ni une clé périmée ; limitez les répétitions et rendez leur cause observable.
Une récupération réussie consomme un crédit, même vide. Une requête invalide ne débite pas le solde ; une défaillance du fournisseur de recherche entraîne la restitution de la réserve. Une interruption côté client peut suivre une récupération réussie côté serveur. Une nouvelle tentative réussie est alors une nouvelle opération payante, même si le client n’a pas reçu la première réponse.
