tubestat

API Reference

Reddit endpoints

User, subreddit, post and comment metrics. Post responses include the upvote ratio and crosspost count alongside the score.

All 4 endpoints below take a single url parameter and return the same field vocabulary used across every platform. A full object costs 2 credits; a single field costs 1.
GET /api/v1/reddit/user
2 credits cache 1m

Reddit user

Total, post and comment karma for a Reddit account.

Parameters

url required
Example: https://www.reddit.com/user/username/
field optional
Return a single value for 1 credit instead of 2.

Fields

userId · name · karma · postKarma · commentKarma · createdAt · verified

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/reddit/user?url=https%3A%2F%2Fwww.reddit.com%2Fuser%2Fusername%2F"
GET /api/v1/reddit/subreddit
2 credits cache 1m

Subreddit

Subscriber count, type and NSFW flag for a subreddit.

Parameters

url required
Example: https://www.reddit.com/r/subreddit/
field optional
Return a single value for 1 credit instead of 2.

Fields

subredditId · name · followers · type · nsfw · createdAt

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/reddit/subreddit?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fsubreddit%2F"
GET /api/v1/reddit/post
2 credits cache 1m

Reddit post

Score, comment count, crosspost count and upvote ratio for a Reddit post.

Parameters

url required
Example: https://www.reddit.com/r/subreddit/comments/POST_ID/
field optional
Return a single value for 1 credit instead of 2.

Fields

postId · authorId · authorName · subredditId · subreddit · title · score · scoreHidden · comments · crossposts · upvoteRatio · flair · createdAt

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/reddit/post?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fsubreddit%2Fcomments%2FPOST_ID%2F"
GET /api/v1/reddit/comment
2 credits cache 1m

Reddit comment

Score and thread position for a Reddit comment.

Parameters

url required
Example: https://www.reddit.com/r/subreddit/comments/POST_ID/comment/COMMENT_ID/
field optional
Return a single value for 1 credit instead of 2.

Fields

commentId · authorId · authorName · score · scoreHidden · topLevel · parentId · postId · subredditId · createdAt

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/reddit/comment?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fsubreddit%2Fcomments%2FPOST_ID%2Fcomment%2FCOMMENT_ID%2F"