q, subreddit, author, kind, from, to, min_score, limit, page
GET
/v1/posts
q, subreddit, author, kind, from, to, min_score, limit, page
GET
/v1/comments
q, subreddit, author, kind, from, to, min_score, limit, page
GET
/v1/item
id
GET
/v1/subreddits
prefix, limit
GET
/v1/status
—
Paramètres de requête
Paramètre
Valeur / type / plage
q
text
subreddit
keyword
author
keyword
kind
post | comment
from
ISO date
to
ISO date
min_score
integer
limit
1–100
page
1–100
id
item ID
prefix
subreddit prefix
Authentification et routes disponibles
Les routes de récupération utilisent GET sur https://api.redditscraping.com avec X-API-Key: <clé> ou Authorization: Bearer <clé>. Les deux en-têtes sont acceptés. Gardez le secret sur votre serveur. La session Secure HttpOnly du panneau du compte est indépendante et ne remplace pas l’en-tête de récupération. Le service interroge des archives ; il ne reçoit pas d’instructions pour explorer des pages actuelles ou contourner les restrictions d’un autre site.
/v1/search recherche publications et commentaires ; /v1/posts se limite aux publications et /v1/comments aux commentaires. Ces routes acceptent q, subreddit, author, kind, from, to, min_score, limit et page, sans filtre id. kind utilise les valeurs littérales post et comment. q effectue une recherche textuelle, sans langage arbitraire de requêtes ni classification des sentiments.
/v1/item?id=... exige id et recherche un enregistrement individuel, sans autres filtres ni parcours récursif. /v1/subreddits accepte seulement prefix et limit pour découvrir des communautés ; les comptages ne sont pas un recensement global exact garanti. /v1/status est public et gratuit. Sa déclaration statique confirme que l’application HTTP répond, sans sonder la recherche ou vérifier la disponibilité des données.
Dates et structure des données
from et to utilisent YYYY-MM-DD en UTC et s’appliquent à created_utc. Le jour to est entièrement inclus. Ces paramètres n’acceptent ni heures ni secondes et ne sélectionnent pas le moment d’entrée dans l’archive. min_score définit un seuil numérique, sans trier les résultats ou choisir automatiquement des publications utiles. Vérifiez la validité des paramètres avant de programmer les pages suivantes.
Les données retournées sous forme de tableaux plats sont essentielles pour une manipulation directe. Les champs parent_id et link_id sont facultatifs et servent uniquement à un regroupement local par le client. Le serveur ne reconstruit pas d'arbres de discussion complets. Cette approche simplifie le traitement tout en maintenant la flexibilité d'affichage pour les applications modernes.
Une réponse contient data, pagination et credits. Les champs des documents de data peuvent varier : texte, dates et identifiants ne sont pas garantis dans chaque enregistrement. Il n’existe pas de filtre parent_id ou link_id. Enregistrez le corps original avant la normalisation et distinguez champ absent, texte vide et zéro ; ces situations n’ont pas nécessairement le même sens dans votre application.
Pagination, incidents et crédits
limit et page acceptent des valeurs de 1 à 100. Chaque requête reçoit une page de 100 enregistrements au maximum ; une interrogation permet de demander jusqu’à 100 pages. L’ordre interne _doc n’est ni chronologique ni fondé sur la pertinence ou le score. Diviser les périodes ou parcourir les pages peut organiser la collecte, sans garantir exhaustivité, unicité ou résultats identiques lors d’une nouvelle requête distante.
Lisez pagination.total avec relation : eq indique un total exact de la requête, gte une borne inférieure et unknown l’absence de total fiable, éventuellement null. Inconnu n’est pas zéro. Même un total exact ne prouve pas que tous les résultats sont téléchargés ni que l’archive contient toute l’histoire. Conservez les indicateurs et les limites avec les réponses enregistrées.
HTTP 400 indique des paramètres invalides, 401 une clé absente ou invalide, 402 un solde insuffisant et 429 une limite de fréquence. Une récupération réussie coûte un crédit, même vide. Une requête invalide ne débite pas le solde ; un échec du service source restitue la réservation. La déconnexion du client peut suivre une réussite facturée et une nouvelle tentative réussie coûte un autre crédit. Enregistrez la réponse avant d’avancer votre suivi local.
