POST/v1/data/reddit/subreddit

Reddit Subreddit

Get subreddit metadata including subscriber count, active users, description, icon, banner, and community type.

Target Latency

1.2s - 4.5s

Credits

1 cr/req

Parameters

Name	Type	Requirement	Description
name	string	REQUIRED	Subreddit name (e.g. 'python' or 'r/python'). 1-100 characters.

cURL Example

curl -X POST "https://api.datablue.dev/v1/data/reddit/subreddit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "python"
}'

System Responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

EXAMPLE RESPONSE

{
  "success": true,
  "time_taken": 1.45,
  "subreddit": {
    "name": "python",
    "title": "Python",
    "description": "News about the programming language Python.",
    "long_description": "Welcome to r/Python! This is a community for all things Python - discussion, tutorials, projects, and news about the programming language.",
    "subscribers": 1340000,
    "active_users": 4200,
    "created": "2008-01-25T00:00:00Z",
    "icon": "https://styles.redditmedia.com/t5_2qh0y/python_icon.png",
    "banner": "https://styles.redditmedia.com/t5_2qh0y/python_banner.png",
    "over_18": false,
    "type": "public",
    "url": "https://www.reddit.com/r/python/"
  }
}