crawlbaseDocs
Se connecter

Utilisation de l'API

Ajoutez &scraper=reddit-subreddit à une requête Crawling API. Encodez en URL l'URL cible dans le paramètre url.

curl 'https://api.crawlbase.com/?token=YOUR_TOKEN' \
  --data-urlencode 'url=https://www.reddit.com/r/programming/' \
  --data-urlencode 'scraper=reddit-subreddit' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://www.reddit.com/r/programming/',
    {'scraper': 'reddit-subreddit'}
)

import json
data = json.loads(res['body'])
const { CrawlingAPI } = require('crawlbase');
const api = new CrawlingAPI({ token: 'YOUR_TOKEN' });

const res = await api.get(
  'https://www.reddit.com/r/programming/',
  { scraper: 'reddit-subreddit' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://www.reddit.com/r/programming/', scraper: 'reddit-subreddit')
data = JSON.parse(res.body)

Exemple d'URL en entrée

L'URL passée dans le paramètre url (décodée pour plus de lisibilité) :

https://www.reddit.com/r/programming/

Structure de la réponse

Corps de la réponse JSON. Les types de champs peuvent être null lorsque la page source omet la valeur.

subreddit
string
Nom du subreddit (sans le préfixe r/).
url
string
URL canonique du subreddit.
sort
string
Ordre de tri du listing (par exemple hot, new, top).
postCount
integer
Nombre de publications renvoyées dans posts.
pagination
object
Curseur de pagination pour les pages suivante et précédente.
pagination.next_page_url
string | null
URL de la page suivante de publications, ou null sur la dernière page.
pagination.previous_page_url
string | null
URL de la page précédente de publications, ou null sur la première page.
pagination.has_next
boolean
True lorsqu'une page suivante est disponible.
posts
array
Publications du listing, dans l'ordre d'affichage.
posts[].position
integer
Position de la publication dans la liste renvoyée (à partir de 1).
posts[].id
string
Fullname Reddit de la publication (par exemple t3_...).
posts[].rank
integer
Rang de la publication dans le listing du subreddit.
posts[].title
string
Titre de la publication.
posts[].author
string
Nom d'utilisateur de l'auteur de la publication.
posts[].score
integer
Score de la publication (upvotes moins downvotes).
posts[].commentsCount
integer
Nombre de commentaires sur la publication.
posts[].createdAt
string
Heure de création de la publication (ISO 8601).
posts[].permalink
string
Permalink vers la publication sur Reddit.
posts[].url
string | null
Lien sortant vers lequel pointe la publication (null pour les publications textuelles).
posts[].domain
string | null
Domaine du lien sortant.
posts[].flair
string | null
Texte du flair de la publication, lorsqu'il est défini.
posts[].isNsfw
boolean
True lorsque la publication est marquée NSFW.
posts[].isStickied
boolean
True lorsque la publication est épinglée en haut du subreddit.
posts[].thumbnail
string | null
URL de l'image miniature, lorsqu'elle est présente.

Exemple de réponse

{
  "subreddit": "programming",
  "url": "https://old.reddit.com/r/programming/",
  "sort": "hot",
  "postCount": 3,
  "pagination": {
    "next_page_url": "https://old.reddit.com/r/programming/?count=25&after=t3_1c8x9aa",
    "previous_page_url": null,
    "has_next": true
  },
  "posts": [
    {
      "position": 1,
      "id": "t3_1c8a1bb",
      "rank": 1,
      "title": "The hidden cost of deep dependency trees",
      "author": "buildmaster",
      "score": 2417,
      "commentsCount": 312,
      "createdAt": "2026-07-14T09:12:44+00:00",
      "permalink": "https://old.reddit.com/r/programming/comments/1c8a1bb/the_hidden_cost_of_deep_dependency_trees/",
      "url": "https://example.com/blog/dependency-trees",
      "domain": "example.com",
      "flair": null,
      "isNsfw": false,
      "isStickied": false,
      "thumbnail": "https://b.thumbs.redditmedia.com/abc.jpg"
    }
  ]
}