Post

GET/v1/reddit/post1 credit

Returns a single Reddit post: title, author, text, score, comment count, media and links. Comments are not included; use `/v1/reddit/post/comments` for them.

01Query parameters

Name	Type	Description
urlrequired	string	The post URL (`https://www.reddit.com/r/<subreddit>/comments/<id>/...`) or a share URL (`https://www.reddit.com/r/<subreddit>/s/<share_id>`).

02Request

curl "https://api.scrapesocial.ai/v1/reddit/post?url=https%3A%2F%2Fwww.reddit.com%2Fr%2FAskReddit%2Fcomments%2Fablzuq%2Fpeople_who_havent_pooped_in_2019_yet_why_are_you%2F" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/reddit/post?url=https%3A%2F%2Fwww.reddit.com%2Fr%2FAskReddit%2Fcomments%2Fablzuq%2Fpeople_who_havent_pooped_in_2019_yet_why_are_you%2F

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "ablzuq",
  "author": "ShoddySubstance",
  "author_fullname": null,
  "subreddit": "AskReddit",
  "title": "People who haven't pooped in 2019 yet, why are you still holding on to last years shit?",
  "selftext": null,
  "selftext_html": null,
  "downs": 0,
  "name": "t3_ablzuq",
  "upvote_ratio": null,
  "ups": 221993,
  "total_awards_received": null,
  "score": 221993,
  "created": 1546376787,
  "created_utc": 1546376787,
  "created_at_iso": "2019-01-01T21:06:27.000Z",
  "num_comments": 7896,
  "url": "https://www.reddit.com/r/AskReddit/comments/ablzuq/people_who_havent_pooped_in_2019_yet_why_are_you/",
  "permalink": "/r/AskReddit/comments/ablzuq/people_who_havent_pooped_in_2019_yet_why_are_you/",
  "subreddit_subscribers": null,
  "is_video": false,
  "archived": true,
  "locked": null,
  "over_18": false,
  "spoiler": false
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

`upvote_ratio`, `total_awards_received` and `locked` are always null (no logged-out source has them); `author_fullname`, `archived` and `spoiler` are filled. `ups` and `score` hold the same vote count. An unknown post is a free 404 (`Post not found`). A URL in another form (also `/comments/<id>` without a subreddit, or a redd.it link) is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.