Reddit post API
One post without its comments: title, body text, author, subreddit, score, upvote ratio, counts and flags.
GET /v1/reddit/post
GET /v1/reddit/post
One post without its comments: title, body text, author, subreddit, score, upvote ratio, counts and flags. Accepts canonical URLs and mobile share URLs.
- Cost: 1 credit
- Cache: Results are kept up to 30 days; send
max_age_daysto reuse them for free. - Timeout: A request still running after about 25 seconds answers
202with a job to poll (Batch and jobs).
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
url | URL | yes | Post URL (reddit.com/r/.../comments/..., redd.it/..., mobile share links). Accepted hosts: reddit.com, redd.it. |
Every request also accepts:
trim:truefor a smaller response withoutnullfields andextra.raw:trueto also get the platform's original object asraw.max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).
Example request#
Set your key in the environment first (see Authentication).
1curl -G "https://api.socialscrape.dev/v1/reddit/post" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3 --data-urlencode "url=https://www.reddit.com/r/webscraping/comments/1q6pxwn/just_started_web_scraping_is_this_a_good_start/"1import os2import requests34params = {5 "url": "https://www.reddit.com/r/webscraping/comments/1q6pxwn/just_started_web_scraping_is_this_a_good_start/",6}7res = requests.get(8 "https://api.socialscrape.dev/v1/reddit/post",9 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10 params=params,11)12body = res.json()1314if body["ok"]:15 print(body["data"])16else:17 print(body["error"]["code"], body["error"]["message"])1const url = new URL("https://api.socialscrape.dev/v1/reddit/post");2url.search = new URLSearchParams({3 "url": "https://www.reddit.com/r/webscraping/comments/1q6pxwn/just_started_web_scraping_is_this_a_good_start/"4}).toString();5const res = await fetch(url, {6 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11 console.log(body.data);12} else {13 console.error(body.error.code, body.error.message);14}1{2 "nodes": [3 {4 "name": "SocialScrape Reddit post",5 "type": "n8n-nodes-base.httpRequest",6 "typeVersion": 4.2,7 "position": [8 0,9 010 ],11 "parameters": {12 "method": "GET",13 "url": "https://api.socialscrape.dev/v1/reddit/post",14 "sendQuery": true,15 "queryParameters": {16 "parameters": [17 {18 "name": "url",19 "value": "https://www.reddit.com/r/webscraping/comments/1q6pxwn/just_started_web_scraping_is_this_a_good_start/"20 }21 ]22 },23 "sendHeaders": true,24 "headerParameters": {25 "parameters": [26 {27 "name": "x-api-key",28 "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"29 }30 ]31 }32 }33 }34 ],35 "connections": {}36}Example response#
This is a sample from a recorded response, lists and long text are shortened, dash characters in the text are replaced with hyphens. Status 200.
200 OKSample response
1{2 "ok": true,3 "credits_charged": 1,4 "credits_remaining": 4999,5 "cached": false,6 "cached_at": null,7 "request_id": "req_04c597fad667450c5f9d311e",8 "data": {9 "object": "post",10 "platform": "reddit",11 "id": "1q6pxwn",12 "url": "https://www.reddit.com/r/webscraping/comments/1q6pxwn/just_started_web_scraping_is_this_a_good_start/",13 "type": "text",14 "author": {15 "id": "t2_16xbknfp71",16 "handle": "franik33",17 "name": "franik33",18 "url": "https://www.reddit.com/user/franik33/",19 "avatar_url": "https://preview.redd.it/snoovatar/avatars/5c702f7f-567b-460a-8bac-c91f154da646-headshot.png?width=64&height=64&crop=smart&auto=webp&s=5bbfe08fa505dabc7fd2ede595f19cb0e5b28502",20 "verified": null21 },22 "title": "Just Started Web Scraping - Is This a Good Start?",23 "text": "Hi everyone,\n\nI started getting into web scraping about 3-4 days ago. I already have some solid experience with Python, and my first scraping project was a public website. I managed to collect around 7,000 records and everything worked as e...",24 "published_at": "2026-01-07T20:01:30.561000Z",25 "duration_seconds": null,26 "language": null,27 "hashtags": null,28 "mentions": null,29 "stats": {30 "views": null,31 "likes": 33,32 "comments": 53,33 "shares": null,34 "saves": null,35 "dislikes": null36 },37 "media": {38 "thumbnail_url": null,39 "video_url": null,40 "audio_url": null,41 "image_urls": null,42 "width": null,43 "height": null44 },45 "song": null,46 "location": null,47 "is_pinned": null,48 "is_sponsored": null,49 "extra": {50 "award_count": 0,51 "domain": "self.webscraping",52 "post_type": "text",53 "score": 33,54 "subreddit": "webscraping",55 "subreddit_id": "t5_318ly",56 "upvote_ratio": 0.923076923076923157 }58 },59 "cursor": null,60 "has_more": null61}Response#
A Post object in data.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
unsupported_url | 400 | no | The URL is not one this endpoint accepts (wrong platform or form). |
not_found | 404 | no | The platform says this profile, post or item does not exist. |
Every request can also fail with the account and platform errors listed on the Errors page.
Example error:
1{2 "ok": false,3 "error": {4 "code": "not_found",5 "message": "The platform says this profile, post or item does not exist.",6 "retryable": false7 },8 "credits_charged": 0,9 "request_id": "req_63334af2890045ea272c39ee"10}Related endpoints#
- Subreddit details (
GET /v1/reddit/subreddit/details) - Subreddit posts (
GET /v1/reddit/subreddit/posts) - Search within a subreddit (
GET /v1/reddit/subreddit/search) - Reddit post comments (
GET /v1/reddit/post/comments) - Reddit post comments (POST body) (
POST /v1/reddit/post/comments) - Reddit video post transcript (
GET /v1/reddit/post/transcript) - Reddit search (
GET /v1/reddit/search)