How to Scrape Reddit with cURL

Reddit contains valuable data -- posts, comments, subreddits, authors, and more. Scraping this data directly means dealing with anti-bot detection, CAPTCHAs, IP rotation, and constantly breaking selectors. The Scavio API handles all of that and returns clean, structured JSON from a single POST request.

This tutorial shows you how to scrape Reddit using cURL and the Scavio API. By the end, you will have a working cURL script that fetches real-time Reddit data and parses the results.

Prerequisites

• A terminal with cURL installed (pre-installed on macOS, Linux, and Windows 10+)
• A Scavio API key (free tier includes 50 credits on signup -- no credit card required)

Step 1: Install Dependencies

curl is built into cURL, so there is nothing to install.

# cURL is pre-installed on macOS, Linux, and Windows 10+

Step 2: Make Your First Reddit Search

Send a POST request to the Scavio Reddit API endpoint with your query. The API returns structured JSON with posts, comments, subreddits, and more.

# Reddit search takes query and an optional cursor only - there is no sort parameter here.
# For sorted feeds use POST /api/v1/reddit/subreddit/posts.
curl -X POST "https://api.scavio.dev/api/v1/reddit/search" \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"query":"best python web frameworks 2026"}'

Step 3: Example Response

The API returns structured JSON. Here is an example response for a Reddit search:

{
  "data": {
    "results": [
      {
        "post_id": "t3_1u1143i",
        "title": "Which programming language do you think will be most relevant in the next 5 years?",
        "url": "https://www.reddit.com/r/AskTechnology/comments/1u1143i/",
        "subreddit": "AskTechnology",
        "author": "Any_Self_2605",
        "score": 15,
        "num_comments": 40,
        "created_at": "2026-06-09T10:27:28.594000+0000"
      }
    ],
    "next_cursor": "eyJjYW5kaWRhdGVzX3JldH...",
    "has_more": true
  },
  "response_time": 1980,
  "credits_used": 1,
  "credits_remaining": 4819
}

Every field is structured and typed -- no HTML parsing, no CSS selectors, no regex extraction. Your cURL code can access any field directly.

Step 4: Full Working Example

Here is a complete, runnable cURL script that searches Reddit and prints the results:

#!/bin/bash
# Search Reddit data with the Scavio API.
# POST /api/v1/reddit/search - rows come back under data.results.
# Reddit search takes query and an optional cursor only - there is no sort parameter here.
# For sorted feeds use POST /api/v1/reddit/subreddit/posts.

SCAVIO_API_KEY="${SCAVIO_API_KEY:-sk_live_your_key}"
INPUT="${1:-best python web frameworks 2026}"

curl -s -X POST "https://api.scavio.dev/api/v1/reddit/search" \
  -H "Authorization: Bearer $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$INPUT\"}" | python3 -m json.tool

Why Use Scavio Instead of Scraping Reddit Directly?

• No proxy management. Direct scraping requires rotating proxies to avoid IP bans. Scavio handles all of this server-side.
• No CAPTCHA solving. Reddit aggressively blocks automated requests. Scavio returns clean data every time.
• Structured JSON output. No HTML parsing or CSS selector maintenance. Get typed, consistent data from every request.
• Multi-platform in one API. Search Google, Amazon, YouTube, and Walmart from the same API key with the same authentication pattern.
• Free tier included. 50 credits on signup with no credit card required. Each search costs 1 credit.