Tutorial

How to Scrape Reddit with PHP

Step-by-step guide to scraping Reddit search results using PHP and the Scavio API. Get posts, comments, subreddits as structured JSON.

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 PHP and the Scavio API. By the end, you will have a working PHP script that fetches real-time Reddit data and parses the results.

Prerequisites

  • PHP installed on your machine
  • A Scavio API key (free tier includes 500 credits/month — no credit card required)

Step 1: Install Dependencies

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

Bash
# cURL extension is built into PHP

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.

<?php
$apiKey = "your_scavio_api_key";

$ch = curl_init("https://api.scavio.dev/api/v1/reddit/search");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "x-api-key: $apiKey",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode(["query" => $query, "sort" => "new"]),
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

Step 3: Example Response

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

JSON
{
  "data": {
    "searchQuery": "best python web frameworks 2026",
    "totalResults": 14,
    "nextCursor": "eyJjYW5kaWRhdGVzX3JldH...",
    "posts": [
      {
        "position": 0,
        "id": "t3_1smb9du",
        "title": "FastAPI vs Django in 2026 — what the teams are actually using",
        "url": "https://www.reddit.com/r/Python/comments/1smb9du/fastapi_vs_django/",
        "subreddit": "Python",
        "author": "python_dev",
        "timestamp": "2026-04-15T16:34:40.389000+0000",
        "nsfw": false
      }
    ]
  },
  "response_time": 5200,
  "credits_used": 2,
  "credits_remaining": 498
}

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

Step 4: Full Working Example

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

<?php
/**
 * Scrape Reddit search results using Scavio API.
 * Returns structured JSON with posts, comments, subreddits, and more.
 */

function searchReddit(string $query): array {
    $apiKey = getenv("SCAVIO_API_KEY");

    $ch = curl_init("https://api.scavio.dev/api/v1/reddit/search");
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            "x-api-key: $apiKey",
            "Content-Type: application/json",
        ],
        CURLOPT_POSTFIELDS => json_encode(["query" => $query, "sort" => "new"]),
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode !== 200) {
        throw new Exception("Scavio API error: $httpCode");
    }

    return json_decode($response, true);
}

$results = searchReddit("best python web frameworks 2026");
echo json_encode($results, JSON_PRETTY_PRINT);

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. 500 credits/month with no credit card required. Each search costs 1 credit.

Frequently Asked Questions

Scraping publicly available data from Reddit is generally legal, but you should review Reddit's Terms of Service. Using the Scavio API avoids the legal gray areas of direct scraping since Scavio handles all data collection through proper channels and returns structured results via API.

Direct scraping of Reddit requires managing proxies, CAPTCHAs, rate limits, and anti-bot detection. The Scavio API handles all of this for you. Send a POST request with your query and get structured JSON back — no proxy management or browser automation needed.

The Scavio API returns structured JSON with posts, comments, subreddits, authors, scores, awards, flair, media. All data is returned in a clean, consistent format that is easy to parse in PHP.

Scavio offers a free tier with 500 credits per month. Each API request costs 1 credit regardless of which platform you search. No credit card required to start. Paid plans start at $30/month for higher volumes.

Scavio returns Reddit results in 1-3 seconds on average. Results are fetched in real time from Reddit — there is no caching layer or stale data. Every request returns live results.

Start Scraping Reddit with PHP

Get your free Scavio API key and start fetching Reddit data in PHP. 500 free credits/month — no credit card required.