crawlbaseDocs
Se connecter

Recherche Reddit

Analysez une page de résultats de recherche Reddit en JSON structuré avec les publications correspondantes, le titre, l'auteur, le subreddit, le score, le nombre de commentaires, l'horodatage, le domaine du lien, les subreddits associés et la pagination de chaque publication.

Utilisation de l'API

Ajoutez &scraper=reddit-serp à 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/search/?q=web+scraping' \
  --data-urlencode 'scraper=reddit-serp' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://www.reddit.com/search/?q=web+scraping',
    {'scraper': 'reddit-serp'}
)

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/search/?q=web+scraping',
  { scraper: 'reddit-serp' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://www.reddit.com/search/?q=web+scraping', scraper: 'reddit-serp')
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/search/?q=web+scraping

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.

query
string
Requête de recherche qui a produit ces résultats.
sort
string
Ordre de tri appliqué à la recherche (par exemple relevance, new, top).
time
string
Fenêtre temporelle appliquée à la recherche (par exemple all, day, week).
restrictSubreddit
boolean
True lorsque la recherche était limitée à un seul subreddit.
resultCount
integer
Nombre de résultats renvoyés dans results.
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 résultats, ou null sur la dernière page.
pagination.previous_page_url
string | null
URL de la page précédente de résultats, ou null sur la première page.
pagination.has_next
boolean
True lorsqu'une page suivante est disponible.
results
array
Résultats de recherche, dans l'ordre de classement.
results[].position
integer
Position du résultat dans la liste renvoyée (à partir de 1).
results[].id
string
Fullname Reddit de la publication (par exemple t3_...).
results[].title
string
Titre de la publication.
results[].url
string
URL du résultat sur Reddit.
results[].author
string
Nom d'utilisateur de l'auteur de la publication.
results[].subreddit
string
Subreddit auquel appartient la publication (sans le préfixe r/).
results[].score
integer
Score de la publication (upvotes moins downvotes).
results[].commentsCount
integer
Nombre de commentaires sur la publication.
results[].createdAt
string
Heure de création de la publication (ISO 8601).
results[].linkUrl
string
Lien sortant vers lequel pointe la publication.
results[].domain
string
Domaine du lien sortant.
subreddits
array
Subreddits associés présentés à côté des résultats.
subreddits[].name
string
Nom du subreddit (sans le préfixe r/).
subreddits[].url
string
URL canonique du subreddit.
subreddits[].subscribers
integer | null
Nombre d'abonnés du subreddit.
subreddits[].description
string | null
Brève description du subreddit.

Exemple de réponse

{
  "query": "web scraping",
  "sort": "relevance",
  "time": "all",
  "restrictSubreddit": false,
  "resultCount": 2,
  "pagination": {
    "next_page_url": "https://old.reddit.com/search?q=web+scraping&count=25&after=t3_1c7aaaa",
    "previous_page_url": null,
    "has_next": true
  },
  "results": [
    {
      "position": 1,
      "id": "t3_1c7aaaa",
      "title": "What is the most reliable way to do web scraping at scale in 2026?",
      "url": "https://old.reddit.com/r/webdev/comments/1c7aaaa/what_is_the_most_reliable_way_to_do_web_scraping/",
      "author": "datawrangler",
      "subreddit": "webdev",
      "score": 486,
      "commentsCount": 133,
      "createdAt": "2026-06-30T14:22:10+00:00",
      "linkUrl": "https://old.reddit.com/r/webdev/comments/1c7aaaa/what_is_the_most_reliable_way_to_do_web_scraping/",
      "domain": "old.reddit.com"
    }
  ],
  "subreddits": [
    {
      "name": "webscraping",
      "url": "https://old.reddit.com/r/webscraping/",
      "subscribers": 84210,
      "description": "A community for web scraping, crawling and data extraction."
    }
  ]
}