Reddit API

Subreddits, posts, and user profiles.

Subreddit sort: hot (default), new, top, rising
Search sort: relevance (default), hot, top, new, comments
Returns up to 100 posts per request
NSFW subreddits are accessible but flagged in the response
Private subreddits are not accessible

Subreddits

`GET /reddit/subreddits/:name` — 2 credits

Get subreddit info.

Param	Type	Required	Default	Description
`name`	string	Yes	—	Subreddit name

cURL


curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/reddit/subreddits/programming

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/reddit/subreddits/programming",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/reddit/subreddits/programming",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "name": "programming",
  "title": "programming",
  "description": "Computer Programming",
  "subscribers": 6847410,
  "activeUsers": null,
  "createdAt": "2006-02-28T18:19:29.000Z",
  "isNsfw": false,
  "icon": "https://...",
  "banner": ""
}

`GET /reddit/subreddits/:name/posts` — 2 credits

Get posts from a subreddit.

Param	Type	Required	Default	Description
`name`	string	Yes	—	Subreddit name
`sort`	string	No	hot	`hot`, `new`, `top`, `rising`
`t`	string	No	all	Time filter (for `sort=top`): `hour`, `day`, `week`, `month`, `year`, `all`
`count`	integer	No	25	Number of posts (max 100)
`after`	string	No	—	Pagination cursor from previous response

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/reddit/subreddits/programming/posts?sort=top&count=10"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/reddit/subreddits/programming/posts?sort=top&count=10",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/reddit/subreddits/programming/posts?sort=top&count=10",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "posts": [
    {
      "id": "1qoxwdt",
      "title": "State of the Subreddit (January 2027): Mo...",
      "author": "ketralnis",
      "subreddit": "programming",
      "score": 113,
      "upvoteRatio": 0.94,
      "commentCount": 78,
      "createdAt": "2026-01-28T01:54:14.000Z",
      "url": "https://www.reddit.com/r/programming/comments/1qoxwdt/...",
      "permalink": "https://www.reddit.com/r/programming/comments/1qoxwdt/...",
      "selftext": "tl;dr: mods applications and minor rules ch...",
      "media": []
    }
    // ... more posts
  ],
  "after": "t3_1rn5az3"
}

Posts

`GET /reddit/posts/:postId` — 2 credits

Get a single Reddit post by ID.

Param	Type	Required	Default	Description
`postId`	string	Yes	—	Reddit post ID

cURL


curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/reddit/posts/1qoxwdt

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/reddit/posts/1qoxwdt",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch("https://api.bycrawl.com/reddit/posts/1qoxwdt", {
  headers: { "x-api-key": "sk_byc_xxx" },
});
console.log(await response.json());

Response


{
  "id": "1qoxwdt",
  "title": "State of the Subreddit (January 2027): Mo...",
  "author": "ketralnis",
  "subreddit": "programming",
  "score": 113,
  "upvoteRatio": 0.94,
  "commentCount": 78,
  "createdAt": "2026-01-28T01:54:14.000Z",
  "url": "https://www.reddit.com/r/programming/comments/1qoxwdt/...",
  "permalink": "https://www.reddit.com/r/programming/comments/1qoxwdt/...",
  "selftext": "tl;dr: mods applications and minor rules ch...",
  "media": []
}

`GET /reddit/posts/search?q=xxx` — 2 credits

Search Reddit posts.

Param	Type	Required	Default	Description
`q`	string	Yes	—	Search query
`sort`	string	No	relevance	`relevance`, `hot`, `top`, `new`, `comments`
`t`	string	No	all	Time filter (for `sort=top`): `hour`, `day`, `week`, `month`, `year`, `all`
`count`	integer	No	25	Number of results (max 100)
`after`	string	No	—	Pagination cursor from previous response

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/reddit/posts/search?q=bitcoin&count=5"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/reddit/posts/search?q=bitcoin&count=5",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/reddit/posts/search?q=bitcoin&count=5",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "posts": [
    {
      "id": "1rciij4",
      "title": "Bitcoin is a trap",
      "author": "tururururur134",
      "subreddit": "Buttcoin",
      "score": 123,
      "upvoteRatio": 0.89,
      "commentCount": 141,
      "createdAt": "2026-02-23T14:13:05.000Z",
      "url": "https://www.reddit.com/r/Buttcoin/comments/1rciij4/...",
      "permalink": "https://www.reddit.com/r/Buttcoin/comments/1rciij4/...",
      "selftext": "Bitcoin is a speculative and volatile trap...",
      "media": []
    }
    // ... more posts
  ],
  "after": "t3_1r262za"
}

Users

`GET /reddit/users/:username` — 2 credits

Get Reddit user profile.

Param	Type	Required	Default	Description
`username`	string	Yes	—	Reddit username

cURL


curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/reddit/users/spez

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/reddit/users/spez",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch("https://api.bycrawl.com/reddit/users/spez", {
  headers: { "x-api-key": "sk_byc_xxx" },
});
console.log(await response.json());

Response


{
  "name": "spez",
  "id": "1w72",
  "createdAt": "2005-06-06T04:00:00.000Z",
  "linkKarma": 181185,
  "commentKarma": 754451,
  "totalKarma": 935636,
  "icon": "https://...",
  "isGold": true,
  "isMod": true
}

`GET /reddit/users/:username/posts` — 2 credits

Get posts submitted by a Reddit user.

Param	Type	Required	Default	Description
`username`	string	Yes	—	Reddit username
`sort`	string	No	new	`new`, `hot`, `top`
`t`	string	No	all	Time filter (for `sort=top`): `hour`, `day`, `week`, `month`, `year`, `all`
`count`	integer	No	25	Number of posts (max 100)
`after`	string	No	—	Pagination cursor from previous response

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/reddit/users/spez/posts?sort=top&count=10"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/reddit/users/spez/posts?sort=top&count=10",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/reddit/users/spez/posts?sort=top&count=10",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "posts": [
    {
      "id": "1qoxwdt",
      "title": "State of the Subreddit (January 2027): Mo...",
      "author": "spez",
      "subreddit": "reddit",
      "score": 113,
      "upvoteRatio": 0.94,
      "commentCount": 78,
      "createdAt": "2026-01-28T01:54:14.000Z",
      "url": "https://www.reddit.com/r/reddit/comments/1qoxwdt/...",
      "permalink": "https://www.reddit.com/r/reddit/comments/1qoxwdt/...",
      "selftext": "...",
      "media": []
    }
    // ... more posts
  ],
  "after": "t3_1rn5az3"
}

Reddit API

Subreddits

GET /reddit/subreddits/:name — 2 credits

cURL

Python

JavaScript

GET /reddit/subreddits/:name/posts — 2 credits

cURL

Python

JavaScript

Posts

GET /reddit/posts/:postId — 2 credits

cURL

Python

JavaScript

GET /reddit/posts/search?q=xxx — 2 credits

cURL

Python

JavaScript

Users

GET /reddit/users/:username — 2 credits

cURL

Python

JavaScript

GET /reddit/users/:username/posts — 2 credits

cURL

Python

JavaScript

`GET /reddit/subreddits/:name` — 2 credits

`GET /reddit/subreddits/:name/posts` — 2 credits

`GET /reddit/posts/:postId` — 2 credits

`GET /reddit/posts/search?q=xxx` — 2 credits

`GET /reddit/users/:username` — 2 credits

`GET /reddit/users/:username/posts` — 2 credits