Posts & videosRedditSubreddit Post · List
Reddit community posts
Read one current public page of posts for a subreddit and explicit sort.
POST
/v1/reddit/subreddits/postsChinese name: Reddit 社区帖子 · 社区帖子 · 列表 按社区与排序读取一页当前公开帖子。reddit.subreddits.posts@v1
Price per call
¥0.02/ call
Complete and confirmed empty results are charged; partial results and failures are not.
Checking live statusTry it
This API is coming soon
We are running launch checks. Once live, you can try it right here at the price shown above; nothing is charged before then. You can already read the parameters and response example.
Available now on the same platform
- Reddit post detail
- Reddit batch post details
- Reddit community profile
- Reddit community highlights
- Reddit community post flairs
- Reddit post search
- Reddit post comments
- Reddit public user profile
- Reddit trending searches
- Reddit user posts
- Reddit search suggestions
- Reddit user comments
- Reddit user active communities
Sign in and run one real call. The result and charge appear right here.
Security check
Loading the security check…
Checking live execution status…
Execution result
// Result
Request parameters
subredditstringrequiredpattern: "^(?:r\\/)?[a-z0-9_]{2,21}$"
Example:
"OpenAI"sortstringoptionalenum: "BEST" | "HOT" | "NEW" | "TOP" | "CONTROVERSIAL" | "RISING"
Example:
"HOT"cursorstringoptionalminLength: 1
Request JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"subreddit": {
"type": "string",
"pattern": "^(?:r\\/)?[a-z0-9_]{2,21}$"
},
"sort": {
"type": "string",
"enum": [
"BEST",
"HOT",
"NEW",
"TOP",
"CONTROVERSIAL",
"RISING"
]
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"required": [
"subreddit"
],
"additionalProperties": false
}Code samples
Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.
curl -X POST https://api.dataxapi.com/v1/reddit/subreddits/posts \
-H "Authorization: Bearer $DATAXAPI_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"subreddit":"OpenAI","sort":"HOT"}'import { ExactApiClient } from "@dataxapi/sdk";
const client = new ExactApiClient({
baseUrl: "https://api.dataxapi.com",
apiKey: process.env.DATAXAPI_API_KEY,
});
const result = await client.call("reddit_subreddits_posts_v1", {
"subreddit": "OpenAI",
"sort": "HOT"
});
console.log(result.data);import os
from dataxapi import ExactApiClient
client = ExactApiClient("https://api.dataxapi.com", os.environ["DATAXAPI_API_KEY"])
result = client.call("reddit_subreddits_posts_v1", {
"subreddit": "OpenAI",
"sort": "HOT",
})
print(result["data"])[mcp_servers.dataxapi]
url = "https://api.dataxapi.com/mcp"
bearer_token_env_var = "DATAXAPI_API_KEY"Response example
200 · application/json
{
"code": 200,
"request_id": "req_example_reddit_public_expansion",
"message": "success",
"data": {
"items": [
{
"id": "t3_fixturepost1",
"title": "Public Reddit fixture title",
"body": "Public Reddit fixture body",
"created_at": "2026-08-01T12:00:00Z",
"author": {
"id": "t2_fixtureuser",
"name": "fixture_user"
},
"subreddit": {
"id": "t5_openai",
"name": "OpenAI",
"title": "OpenAI"
},
"metrics": {
"score": 42,
"comment_count": 7,
"upvote_ratio": 0.95,
"share_count": 2
},
"flair": null,
"post_hint": "self",
"domain": "self.OpenAI",
"url": "https://www.reddit.com/r/OpenAI/comments/fixturepost1/example/",
"permalink": "/r/OpenAI/comments/fixturepost1/example/",
"reddit_url": "https://www.reddit.com/r/OpenAI/comments/fixturepost1/example/",
"is_nsfw": false,
"is_removed": false,
"is_score_hidden": false
}
]
},
"page": {
"next_cursor": "cursor_example"
},
"warnings": [],
"meta": {
"listing_id": "reddit.subreddits.posts",
"version": "v1",
"catalog_release_id": "catalog-production-2026-09-19.b069be57",
"price_book_version": "pricebook-production-2026-09-19.4487e352",
"result_status": "complete",
"charged_amount": "0.02",
"balance_after": "49.70",
"currency": "CNY"
}
}Response fields
codenumber- const: 200
request_idstringmessagestring- const: "success"
dataobjectpageobjectwarningsarraymetaobject
Response JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"code": {
"type": "number",
"const": 200
},
"request_id": {
"type": "string"
},
"message": {
"type": "string",
"const": "success"
},
"data": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"body": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"author": {
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"subreddit": {
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"name",
"title"
],
"additionalProperties": false
},
"metrics": {
"type": "object",
"properties": {
"score": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"comment_count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"upvote_ratio": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"share_count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"comment_count",
"upvote_ratio",
"share_count"
],
"additionalProperties": false
},
"flair": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"post_hint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"permalink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reddit_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_nsfw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"is_removed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"is_score_hidden": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"title",
"body",
"created_at",
"author",
"subreddit",
"metrics",
"flair",
"post_hint",
"domain",
"url",
"permalink",
"reddit_url",
"is_nsfw",
"is_removed",
"is_score_hidden"
],
"additionalProperties": false
}
}
},
"required": [
"items"
],
"additionalProperties": false
},
"page": {
"type": "object",
"properties": {
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"next_cursor"
],
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"meta": {
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"const": "reddit.subreddits.posts"
},
"version": {
"type": "string",
"const": "v1"
},
"catalog_release_id": {
"type": "string",
"minLength": 1
},
"price_book_version": {
"type": "string",
"minLength": 1
},
"result_status": {
"type": "string",
"enum": [
"complete",
"empty",
"partial"
]
},
"charged_amount": {
"type": "string"
},
"balance_after": {
"type": "string"
},
"currency": {
"type": "string",
"const": "CNY"
}
},
"required": [
"listing_id",
"version",
"catalog_release_id",
"price_book_version",
"result_status",
"charged_amount",
"balance_after",
"currency"
],
"additionalProperties": false
}
},
"required": [
"code",
"request_id",
"message",
"data",
"page",
"warnings",
"meta"
],
"additionalProperties": false
}Usage notes
Good for
- Use it to inspect a known community under HOT, NEW, TOP, or another explicit sort.
Not for
- Do not treat one page as exhaustive or representative community opinion.
Known limitations
- Ordering follows Reddit's current public surface.
- Promoted items are removed and disclosed with a warning.
- Only the returned DataXAPI cursor can continue the same query.
Billing
¥0.02 per call. Complete and confirmed empty results are charged; partial results and failures are not.
See all pricing →