Developer tutorial

How to scrape Reddit search results with cURL (2026)

This tutorial shows how to scrape Reddit search results in cURL using the SocialCrawl API. You get matching posts with title, subreddit, author, score, comment count, and permalink for any search query, with no OAuth app required from one GET request, with no Reddit developer account, proxies, or HTML parsing. The code below is runnable as-is, and the response underneath it is a real, unedited call.

Code tested July 2026

Get your free API key Read the API docs

How it works

1
Get a free API keyCreate a SocialCrawl account and copy your API key from the dashboard. Every new account starts with free credits.
2
Set up cURLUse curl, which ships with macOS, Linux, and Windows 10 and later.
3
Call the Reddit Search endpointSend a GET request to /v1/reddit/search with your API key in the x-api-key header and the `query` parameter.
4
Read the responseParse the JSON. SocialCrawl returns matching posts with title, subreddit, author, score, comment count, and permalink for any search query, with no OAuth app required in one normalized schema, so you write no HTML parsing or proxy code.

The code

A real, unedited response from the request above.

curl -G "https://www.socialcrawl.dev/v1/reddit/search" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "query=best programming languages 2024"

[ RESPONSE ]

{
  "success": true,
  "platform": "reddit",
  "endpoint": "/v1/reddit/search",
  "data": {
    "items": [
      {
        "post": {
          "id": "1u1143i",
          "url": "https://www.reddit.com/r/AskTechnology/comments/1u1143i/which_programming_language_do_you_think_will_be/",
          "content": {
            "text": "Which programming language do you think will be most relevant in the next 5 years, and why?",
            "media_urls": null,
            "thumbnail_url": null,
            "duration_seconds": null
          },
          "author": {
            "username": "Any_Self_2605",
            "display_name": "t2_25au9h5u7w",
            "avatar_url": null,
            "verified": null
          },
          "engagement": {
            "views": null,
            "likes": 14,
            "comments": 40,
            "shares": null,
            "saves": null
          },
          "flags": {
            "nsfw": false,
            "spoiler": false,
            "pinned": null,
            "deleted": false
          },
          "published_at": "2026-06-09T10:27:28.000Z",
          "ext": {
            "subreddit": "AskTechnology",
            "published_at_epoch": 1781000848
          }
        },
        "computed": {
          "engagement_rate": null,
          "language": "en",
          "content_category": "other",
          "estimated_reach": null
        }
      },
      {
        "post": {
          "id": "1uyqq8k",
          "url": "https://www.reddit.com/r/AlignmentChartFills/comments/1uyqq8k/and_finally_which_programming_language_is_joy_and/",
          "content": {
            "text": "And finally: which programming language is joy and powers the world?",
            "media_urls": null,
            "thumbnail_url": null,
            "duration_seconds": null
          },
          "author": {
            "username": "WildXogos",
            "display_name": "t2_r71luddl",
            "avatar_url": null,
            "verified": null
          },
          "engagement": {
            "views": null,
            "likes": 1108,
            "comments": 739,
            "shares": null,
            "saves": null
          },
          "flags": {
            "nsfw": false,
            "spoiler": false,
            "pinned": null,
            "deleted": false
          },
          "published_at": "2026-07-17T05:35:33.000Z",
          "ext": {
            "subreddit": "AlignmentChartFills",
            "published_at_epoch": 1784266533
          }
        },
        "computed": {
          "engagement_rate": null,
          "language": "en",
          "content_category": "other",
          "estimated_reach": null
        }
      }
    ],
    "next_cursor": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiM1wiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIzXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfMTBfcXVlcnlfc3VnZ2VzdGlvbnNcIjpcIjZcIixcInNlY3Rpb25fMl9waXBlbGluZV84X2R5bmFtaWNfMF9hbnN3ZXJzX3ByZXZpZXdcIjpcIjBcIixcInNlY3Rpb25fMl9waXBlbGluZV84X2R5bmFtaWNfMV9wb3N0X3NlYXJjaFwiOlwiN1wiLFwic2VjdGlvbl8zX3BpcGVsaW5lXzBfZHluYW1pY18wX3N1YnJlZGRpdF9zZWFyY2hcIjpcIjVcIixcInNlY3Rpb25fM19waXBlbGluZV8wX2R5bmFtaWNfMV9hdXRob3Jfc2VhcmNoXCI6XCI1XCJ9IiwiZHluYW1pY19hbGxfcmFua2VyIjoibGVnYWN5X2Fuc3dlcnMiLCJleHBlcmllbmNlX3NlbGVjdGlvbiI6ImR5bmFtaWNfYWxsIiwiZXhwZXJpZW5jZV92ZXJzaW9uIjoiZGVza3RvcCIsInNlY3Rpb25fMl9waXBlbGluZV84X2R5bmFtaWNfMV9wb3N0X3NlYXJjaCI6IjcifQ==",
    "total": null,
    "dropped": 0
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_example000000",
  "cached": false,
  "pagination": {
    "next_cursor": "sc.eyJ2IjoyLCJjIjoiZXlKallXNWthV1JoZEdWelgzSmxkSFZ5Ym1Wa0lqb2llMXdpYzJWamRHbHZibDh4WDNCcGNHVnNhVzVsWHpCZloyeHZZbUZzWDIxdlpHbG1hV1Z5YzF3aU9sd2lNMXdpTEZ3aWMyVmpkR2x2Ymw4eFgzQnBjR1ZzYVc1bFh6RmZiRzlqWVd4ZmJXOWthV1pwWlhKelhDSTZYQ0l6WENJc1hDSnpaV04wYVc5dVh6SmZjR2x3Wld4cGJtVmZNVEJmY1hWbGNubGZjM1ZuWjJWemRHbHZibk5jSWpwY0lqWmNJaXhjSW5ObFkzUnBiMjVmTWw5d2FYQmxiR2x1WlY4NFgyUjVibUZ0YVdOZk1GOWhibk4zWlhKelgzQnlaWFpwWlhkY0lqcGNJakJjSWl4Y0luTmxZM1JwYjI1Zk1sOXdhWEJsYkdsdVpWODRYMlI1Ym1GdGFXTmZNVjl3YjNOMFgzTmxZWEpqYUZ3aU9sd2lOMXdpTEZ3aWMyVmpkR2x2Ymw4elgzQnBjR1ZzYVc1bFh6QmZaSGx1WVcxcFkxOHdYM04xWW5KbFpHUnBkRjl6WldGeVkyaGNJanBjSWpWY0lpeGNJbk5sWTNScGIyNWZNMTl3YVhCbGJHbHVaVjh3WDJSNWJtRnRhV05mTVY5aGRYUm9iM0pmYzJWaGNtTm9YQ0k2WENJMVhDSjlJaXdpWkhsdVlXMXBZMTloYkd4ZmNtRnVhMlZ5SWpvaWJHVm5ZV041WDJGdWMzZGxjbk1pTENKbGVIQmxjbWxsYm1ObFgzTmxiR1ZqZEdsdmJpSTZJbVI1Ym1GdGFXTmZZV3hzSWl3aVpYaHdaWEpwWlc1alpWOTJaWEp6YVc5dUlqb2laR1Z6YTNSdmNDSXNJbk5sWTNScGIyNWZNbDl3YVhCbGJHbHVaVjg0WDJSNWJtRnRhV05mTVY5d2IzTjBYM05sWVhKamFDSTZJamNpZlE9PSIsInAiOiJhZnRlciJ9",
    "has_more": true,
    "page_size": 7
  }
}

API reference for this endpoint

Prefer another language?

Python Node.js cURL

자주 묻는 질문

궁금한 점이 있으신가요? 답변해 드립니다

SocialCrawl의 API, 요금제, 기능에 대한 자주 묻는 질문을 확인하세요.

문의하기

Do I need a Reddit developer account to scrape Reddit search results?

No. SocialCrawl handles authentication and proxies upstream, so you never register a Reddit app, manage OAuth tokens, or run your own scrapers. One API key returns Reddit data directly.

What does the Reddit Search endpoint return?

It returns matching posts with title, subreddit, author, score, comment count, and permalink for any search query, with no OAuth app required. The response is normalized into SocialCrawl's unified schema, identical in shape across every platform.

How much does it cost to scrape Reddit search results?

Each call costs a small number of credits, and new accounts start with free credits. There are no monthly minimums, so you pay only for the calls you make.

Can I use this cURL code in production?

Yes. The snippet on this page is the real request against the live API. For production, add error handling and follow the response cursor to paginate through large result sets.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기 Perplexity에 물어보기 Gemini에 물어보기 Claude에 물어보기 Grok에 물어보기

Get your free API key