crawlbase文档
登录

Reddit 子版块

将子版块列表页面解析为结构化 JSON，包含排名后的帖子、每条帖子的标题、作者、得分、评论数、时间戳、永久链接、链接域名、flair 以及分页。

API 用法

在 Crawling API 请求中添加 &scraper=reddit-subreddit。在 url 参数中对目标 URL 进行 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)

示例输入 URL

传入 url 参数的 URL（为便于阅读已 URL 解码）：

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

响应结构

JSON 响应体。当源页面省略对应值时，字段类型可能为 null。

subreddit
string
子版块名称（不含 r/ 前缀）。
url
string
规范的子版块 URL。
sort
string
列表的排序方式（例如 hot、new、top）。
postCount
integer
posts 中返回的帖子数量。
pagination
object
用于下一页和上一页的分页游标。
pagination.next_page_url
string | null
下一页帖子的 URL，如果是最后一页则为 null。
pagination.previous_page_url
string | null
上一页帖子的 URL，如果是第一页则为 null。
pagination.has_next
boolean
当有下一页可用时为 true。
posts
array
列表中的帖子，按显示顺序排列。
posts[].position
integer
帖子在返回列表中的位置（从 1 开始）。
posts[].id
string
帖子的 Reddit 全名（例如 t3_...）。
posts[].rank
integer
帖子在子版块列表中的排名。
posts[].title
string
帖子标题。
posts[].author
string
帖子作者的用户名。
posts[].score
integer
帖子得分（顶数减去踩数）。
posts[].commentsCount
integer
帖子的评论数量。
posts[].createdAt
string
帖子创建时间（ISO 8601）。
posts[].permalink
string
帖子在 Reddit 上的永久链接。
posts[].url
string | null
帖子指向的外部链接（文本帖为 null）。
posts[].domain
string | null
外部链接的域名。
posts[].flair
string | null
帖子的 flair 文本（如已设置）。
posts[].isNsfw
boolean
当帖子被标记为 NSFW 时为 true。
posts[].isStickied
boolean
当帖子被置顶到子版块顶部时为 true。
posts[].thumbnail
string | null
缩略图图片 URL（如存在）。

示例响应

{
  "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"
    }
  ]
}