Reddit

Reddit Scraper API

Real-time Reddit data — posts, comments, subreddit info, user profiles, and search. All data is scraped directly from Reddit and returned as structured JSON.

5 Endpoints REST API JSON 99.9% Uptime
Start Free on RapidAPI → View Endpoints ↓

Try it instantly

See real data shapes from every endpoint — no signup required.

Request
GET /reddit/post
post_id 1jqz2k0 required 
curl -G "https://api.pullapi.com/reddit/post" \
  -H "x-rapidapi-key: YOUR_API_KEY"
Response 200 OK 
{
  "success": true,
  "data": {
    "post_id": "1jqz2k0",
    "title": "Scientists discover high-temperature superconductor breakthrough",
    "author": "science_fan_42",
    "subreddit": "science",
    "score": 24531,
    "upvote_ratio": 0.96,
    "num_comments": 1843,
    "created_utc": 1710504000.0,
    "permalink": "/r/science/comments/1jqz2k0/scientists_discover_high_temperature/",
    "url": "https://example.com/article",
    "selftext": null,
    "selftext_html": null,
    "is_self": false,
    "is_video": false,
    "is_nsfw": false,
    "is_spoiler": false,
    "is_stickied": false,
    "link_flair_text": "Physics",
    "thumbnail": "https://b.thumbs.redditmedia.com/example.jpg",
    "media_url": null,
    "domain": "example.com",
    "awards_count": 12
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

API Endpoints

5 endpoints across 4 categories.

Post

GET /reddit/post

Get full details for a Reddit post including title, author, score, comments count, text content, media, and metadata. Accepts a post ID, full Reddit URL, or redd.it short link.

Parameters

Name Type Required Description Example
post_id string Yes Reddit post ID, full URL, or redd.it short link. Examples: "abc123",... 1jqz2k0

Example Response

{
  "success": true,
  "data": {
    "post_id": "1jqz2k0",
    "title": "Scientists discover high-temperature superconductor breakthrough",
    "author": "science_fan_42",
    "subreddit": "science",
    "score": 24531,
    "upvote_ratio": 0.96,
    "num_comments": 1843,
    "created_utc": 1710504000.0,
    "permalink": "/r/science/comments/1jqz2k0/scientists_discover_high_temperature/",
    "url": "https://example.com/article",
    "selftext": null,
    "selftext_html": null,
    "is_self": false,
    "is_video": false,
    "is_nsfw": false,
    "is_spoiler": false,
    "is_stickied": false,
    "link_flair_text": "Physics",
    "thumbnail": "https://b.thumbs.redditmedia.com/example.jpg",
    "media_url": null,
    "domain": "example.com",
    "awards_count": 12
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}
GET /reddit/comments

Get comments for a Reddit post with threading (parent_id and depth). Supports sorting by best, top, new, controversial, old, or Q&A. Returns up to 500 comments per request.

Parameters

Name Type Required Description Example
post_id string Yes Reddit post ID, full URL, or redd.it short link. Examples: "abc123",... 1jqz2k0
sort string No Sort order for comments best, top, new, controversial, old, qa
limit integer No Maximum number of comments to return (1-500) 100

Example Response

{
  "success": true,
  "data": {
    "post_id": "1jqz2k0",
    "post_title": "Scientists discover high-temperature superconductor breakthrough",
    "subreddit": "science",
    "comments": [
      {
        "comment_id": "m3xk9f2",
        "author": "physics_prof",
        "body": "This is a significant finding. The implications for room-temperature superconductivity are enormous.",
        "body_html": "<p>This is a significant finding. The implications for room-temperature superconductivity are enormous.</p>",
        "score": 3420,
        "created_utc": 1710507600.0,
        "is_submitter": false,
        "is_stickied": false,
        "parent_id": "t3_1jqz2k0",
        "depth": 0,
        "awards_count": 3,
        "reply_count": 14
      },
      {
        "comment_id": "m3xm1a7",
        "author": "curious_reader",
        "body": "Can you explain what this means for practical applications?",
        "body_html": "<p>Can you explain what this means for practical applications?</p>",
        "score": 892,
        "created_utc": 1710508200.0,
        "is_submitter": false,
        "is_stickied": false,
        "parent_id": "t1_m3xk9f2",
        "depth": 1,
        "awards_count": 0,
        "reply_count": 5
      }
    ],
    "total_comments": 1843
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Subreddit

GET /reddit/subreddit

Get subreddit metadata (subscribers, description, icon) and its current posts sorted by hot, new, top, or rising. Returns up to 100 posts per request.

Parameters

Name Type Required Description Example
subreddit string Yes Subreddit name, r/name, or full URL. Examples: "technology", "r/technology",... technology
sort string No Sort order for posts hot, new, top, rising
limit integer No Number of posts to return (1-100) 25

Example Response

{
  "success": true,
  "data": {
    "subreddit": {
      "name": "technology",
      "title": "Technology",
      "description": "Subreddit dedicated to the news and discussion of technology...",
      "public_description": "A subreddit for technology news and discussion.",
      "subscribers": 15420000,
      "active_users": 8340,
      "created_utc": 1201233135.0,
      "is_nsfw": false,
      "icon_url": "https://styles.redditmedia.com/t5_2qh16/icon.png",
      "banner_url": "https://styles.redditmedia.com/t5_2qh16/banner.png",
      "url": "/r/technology/"
    },
    "posts": [
      {
        "post_id": "1jqz2k0",
        "title": "Scientists discover high-temperature superconductor breakthrough",
        "author": "science_fan_42",
        "subreddit": "technology",
        "score": 24531,
        "upvote_ratio": 0.96,
        "num_comments": 1843,
        "created_utc": 1710504000.0,
        "permalink": "/r/technology/comments/1jqz2k0/scientists_discover_high_temperature/",
        "url": "https://example.com/article",
        "selftext": null,
        "selftext_html": null,
        "is_self": false,
        "is_video": false,
        "is_nsfw": false,
        "is_spoiler": false,
        "is_stickied": false,
        "link_flair_text": "Science",
        "thumbnail": "https://b.thumbs.redditmedia.com/example.jpg",
        "media_url": null,
        "domain": "example.com",
        "awards_count": 12
      }
    ],
    "total_posts": 25
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

User

GET /reddit/user

Get a Reddit user's profile (karma, account age, verification status) and their recent posts. Accepts a username, u/name, or full profile URL.

Parameters

Name Type Required Description Example
username string Yes Reddit username, u/name, or full profile URL. Examples: "spez", "u/spez",... spez
sort string No Sort order for the user's posts new, hot, top
limit integer No Number of posts to return (1-100) 25

Example Response

{
  "success": true,
  "data": {
    "user": {
      "username": "spez",
      "display_name": "spez",
      "description": "CEO of Reddit",
      "link_karma": 148205,
      "comment_karma": 751043,
      "total_karma": 899248,
      "created_utc": 1118030400.0,
      "is_verified": true,
      "is_gold": true,
      "is_mod": true,
      "icon_url": "https://styles.redditmedia.com/t5_6/icon.png",
      "banner_url": null,
      "url": "/user/spez/"
    },
    "posts": [
      {
        "post_id": "1jr5a4b",
        "title": "Reddit's 2026 recap",
        "author": "spez",
        "subreddit": "blog",
        "score": 8432,
        "upvote_ratio": 0.72,
        "num_comments": 5621,
        "created_utc": 1710590400.0,
        "permalink": "/r/blog/comments/1jr5a4b/reddits_2026_recap/",
        "url": "https://www.reddit.com/r/blog/comments/1jr5a4b/reddits_2026_recap/",
        "selftext": "Hey everyone, here is our annual recap...",
        "selftext_html": "<p>Hey everyone, here is our annual recap...</p>",
        "is_self": true,
        "is_video": false,
        "is_nsfw": false,
        "is_spoiler": false,
        "is_stickied": false,
        "link_flair_text": "Announcement",
        "thumbnail": "self",
        "media_url": null,
        "domain": "self.blog",
        "awards_count": 45
      }
    ],
    "total_posts": 25
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Search

GET /reddit/search

Search Reddit posts by keyword across all subreddits or within a specific subreddit. Supports sorting by relevance, hot, top, new, or comments, and filtering by time period.

Parameters

Name Type Required Description Example
query string Yes Search query string. Supports Reddit search syntax (e.g. "machine learning", "author:spez",... machine learning
sort string No Sort order for search results relevance, hot, top, new, comments
time_filter string No Filter results by time period hour, day, week, month, year, all
subreddit string No Limit search to a specific subreddit. Omit to search all of Reddit. Examples: "python", "technology" python
limit integer No Number of results to return (1-100) 25

Example Response

{
  "success": true,
  "data": {
    "query": "machine learning",
    "sort": "relevance",
    "time_filter": "all",
    "results": [
      {
        "post_id": "1jq8m3n",
        "title": "A beginner's guide to machine learning in 2026",
        "author": "ml_enthusiast",
        "subreddit": "MachineLearning",
        "score": 5621,
        "upvote_ratio": 0.98,
        "num_comments": 342,
        "created_utc": 1710417600.0,
        "permalink": "/r/MachineLearning/comments/1jq8m3n/a_beginners_guide_to_machine_learning_in_2026/",
        "url": "https://www.reddit.com/r/MachineLearning/comments/1jq8m3n/a_beginners_guide_to_machine_learning_in_2026/",
        "selftext": "Here is a comprehensive guide for anyone getting started...",
        "selftext_html": "<p>Here is a comprehensive guide for anyone getting started...</p>",
        "is_self": true,
        "is_video": false,
        "is_nsfw": false,
        "is_spoiler": false,
        "is_stickied": false,
        "link_flair_text": "Discussion",
        "thumbnail": "self",
        "media_url": null,
        "domain": "self.MachineLearning",
        "awards_count": 8
      }
    ],
    "total_results": 25
  },
  "credits_used": 1,
  "cache_hit": false,
  "timestamp": "2026-03-15T12: 00: 00+00: 00"
}

Code Examples

Get started in seconds with your preferred language.

Terminal 
curl -G "https://api.pullapi.com/reddit/post?post_id=1jqz2k0" \
  -H "x-rapidapi-host: reddit-scraper-api.p.rapidapi.com" \
  -H "x-rapidapi-key: YOUR_API_KEY"

Why PullAPI

</>

No Browser Needed

HTTP-based API. No Selenium, no Puppeteer, no headless browsers to manage.

⇄

Built-in Proxy Rotation

Automatic residential proxy rotation handles anti-bot detection for you.

⚡

Cached Responses

Smart Redis caching means faster repeated queries and lower costs.

$

Pay Per Request

No monthly commitment. Free tier included. Pay only for what you use.

Use Cases

What developers build with the Reddit Scraper API.

1

Sentiment Analysis

2

Trend Detection

3

Brand Monitoring

4

Community Research

Related Scrapers

More APIs in Social Media.

Instagram

Instagram Scraper

Influencer Analytics · Content Monitoring
TikTok

TikTok Scraper

Creator Analytics · Trend Tracking
YouTube

YouTube Scraper

Channel Analytics · Video Research
Facebook

Facebook Scraper

Page Analytics · Marketplace Monitoring
Twitter/X

Twitter/X Scraper

Sentiment Analysis · Influencer Monitoring
Twitch

Twitch Scraper

Streamer Analytics · Content Discovery

Ready to scrape Reddit data?

Start with the free tier. No credit card required.

Subscribe on RapidAPI →