Reddit App API
FR

Données historiques Reddit · API JSON

Ajoutez la recherche Reddit à votre application

Utilisez les données Reddit archivées pour ajouter une recherche de discussions à une application web ou mobile. Cet exemple demande une page de trois enregistrements au maximum.

GETJSONHTTPS
Anatomie de la requête
Anatomie de la requête/v1/searchidkindcreated_utctextr/SideProject
/v1/searchSideProject
01Chaque requête réussie coûte un crédit, même si le résultat est vide.
100Pages et limites
$1 / 1,000Facturation par requête
01 / Reddit App API

Reddit App API — De la requête aux données utiles

Commencez par une petite sélection. Conservez les champs et paramètres nécessaires à la suite, puis traitez le résultat dans votre application.

01

Sélectionnez les données

Interrogez /v1/search avec q=search et subreddit=SideProject ; commencez avec limit=3.

02

Préparez la réponse

Gardez la clé API sur votre backend ; transmettez seulement les données choisies au navigateur ou à l’application mobile.

03

Utilisez-la dans votre projet

Conservez le permalink disponible avec vos notes comme référence ; la page liée peut devenir indisponible.

Une requête à adapter

GET /v1/search · cURL
curl --get --fail-with-body 'https://api.redditapp.com/v1/search' \
  -H "Authorization: Bearer ${REDDIT_API_KEY}" \
  --data-urlencode 'q=search' \
  --data-urlencode 'subreddit=SideProject' \
  --data-urlencode 'limit=3' \
  --data-urlencode 'page=1'

Cet exemple demande une page de trois enregistrements au maximum.

URL de base de l’APIhttps://api.redditapp.com/v1

Définissez le périmètre de chaque requête

Texte et communauté

Combinez q avec subreddit ou author pour affiner la sélection.

Dates en UTC

Utilisez from et to au format YYYY-MM-DD. La date de fin inclut toute la journée UTC.

Pages et limites

Définissez limit et page, puis conservez les métadonnées de pagination avec les résultats.

Paiement par requête réussie

Chaque requête réussie coûte un crédit, même si le résultat est vide.

$1 pour 1 000 requêtes réussies

Recharge minimale : $50 · 50 000 crédits

FAQ / 08

Avant l’intégration

Qu’est-ce que Reddit App API ?

Reddit App API est une API JSON indépendante donnant accès à des données Reddit historiques. Elle propose des routes de lecture pour la recherche, les publications, les commentaires, les éléments individuels et les subreddits. Reddit ne gère pas ce service et ne lui est pas affilié. Utilisez les données Reddit archivées pour ajouter une recherche de discussions à une application web ou mobile. Cet exemple demande une page de trois enregistrements au maximum.

Comment obtenir une clé API ?

Créez un compte avec email et mot de passe sur ce site. La clé apparaît après l’inscription, avant tout paiement requis ; conservez-la en sécurité car elle n’est affichée qu’une fois. Envoyez-la depuis votre serveur via X-API-Key ou Authorization: Bearer. Sa régénération invalide la clé précédente.

Combien coûte Reddit App API ?

Le tarif est de $1 pour 1 000 requêtes réussies. La recharge minimale est de $50 pour 50 000 crédits. Chaque requête réussie consomme un crédit, même sans résultat. Les requêtes invalides ne sont pas facturées ; une panne en amont déclenche un remboursement pouvant nécessiter une réconciliation. Un délai dépassé ne détermine pas seul la facturation finale.

Quels filtres permettent de rechercher les données Reddit ?

Utilisez q pour une recherche textuelle analysée avec subreddit, author, kind, from, to ou min_score. Les mots sont combinés avec AND ; ce n’est ni une recherche sémantique ni un DSL libre. Les dates suivent YYYY-MM-DD en UTC, avec toute la journée finale incluse par to. Consultez les paramètres documentés.

Est-ce que Reddit App API fournit un accès Reddit en direct ?

Non. Le service lit une archive historique, pas le flux Reddit en direct. Il ne publie pas, ne vote pas, n’envoie pas de messages privés et n’effectue pas d’actions Reddit OAuth. La route publique /v1/status décrit son périmètre ; elle ne prouve ni la santé de l’archive, ni son exhaustivité, ni la disponibilité actuelle d’une page source.

Puis-je exporter tous les résultats d’une recherche ?

Pas nécessairement. Une requête renvoie jusqu’à 100 enregistrements et page va de 1 à 100. Lisez total avec pagination.relation : exact, borne inférieure ou inconnu. L’ordre est celui de l’archive, sans garantie chronologique ou de pertinence. Atteindre la dernière page accessible ne prouve pas l’exhaustivité de l’échantillon.

Puis-je réutiliser la même clé sur un autre domaine ?

Non. Comptes, clés API et soldes sont séparés par site. Utilisez la clé de ce domaine avec son propre hôte API HTTPS. Conservez-la dans la configuration serveur, jamais dans le JavaScript du navigateur, un dépôt public ou des journaux partagés. Une clé d’un autre site ne remplace pas un compte local.

Quelle requête essayer en premier ?

Commencez avec /v1/search, q=search, subreddit=SideProject, limit=3 et page=1. Cette petite requête permet d’examiner les champs avant de développer un import ou une interface. Elle coûte un crédit si elle réussit, même sans résultat. Adaptez sujet et communauté à votre tâche : l’exemple ne promet aucun nombre fixe de résultats.

API / Reddit App API

Créez la première requête

Créez un compte, conservez la clé et adaptez l’exemple à votre tâche.

Obtenir une clé API