Reddit User Post Feed (by Username)
omnial/reddit-app-fetch-user-posts
Given a Reddit username, returns that account's own post feed: each post's title, self-text, subreddit or profile, score, comment count, flair, and any embedded image, video, or crosspost, sortable by new/top/hot/controversial with a cursor for paging through older posts. Returns a `null` feed when the username does not exist on Reddit.
Price
Up to $0.00205 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.
Data source
Data from Reddit.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/reddit-app-fetch-user-posts" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/reddit-app-fetch-user-posts" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/reddit-app-fetch-user-posts", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/reddit-app-fetch-user-posts", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.00205 |
- Updated
- Oct 25, 2026
Input and output schemas
Input schema
{
"type": "object",
"required": [
"username"
],
"properties": {
"sort": {
"enum": [
"NEW",
"TOP",
"HOT",
"CONTROVERSIAL"
],
"type": "string",
"default": "NEW",
"examples": [
"NEW"
],
"description": "Sort method: NEW, TOP, HOT, CONTROVERSIAL"
},
"after": {
"type": "string",
"maxLength": 4096,
"description": "Pagination parameter"
},
"language": {
"type": "string",
"default": "en-US",
"pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
"maxLength": 16,
"minLength": 2,
"description": "Preferred response language as an IETF language tag; default: en-US"
},
"username": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"examples": [
"spez"
],
"maxLength": 20,
"minLength": 1,
"description": "Username"
},
"need_format": {
"type": "boolean",
"default": false,
"description": "Whether to clean and format the data"
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"properties": {
"identity": {
"type": "object",
"properties": {
"settings": {
"type": "object",
"properties": {
"postSetSettings": {
"type": "object",
"properties": {
"maxPostsPerPostSet": {
"type": "number",
"description": "An internal batching config value observed as `5` on both real calls made -- its exact effect on the returned feed is unconfirmed."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"postFeed": {
"type": [
"object",
"null"
],
"properties": {
"profile": {
"type": "object",
"properties": {
"stickyPosts": {
"type": "array",
"items": {},
"description": "Usually an empty array `[]` -- item shape not documented, no populated example has been observed."
}
},
"additionalProperties": true
},
"elements": {
"type": "object",
"properties": {
"edges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"node": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Reddit's own post id, e.g. 't3_...'."
},
"url": {
"type": [
"string",
"null"
],
"description": "Withheld (returned as `null` regardless of the real destination) -- only whether the post has a link is observable, not the URL itself."
},
"flair": {
"type": [
"object",
"null"
],
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
},
"textColor": {
"type": "string"
}
},
"additionalProperties": true
},
"media": {
"type": [
"object",
"null"
],
"properties": {
"still": {
"type": "object",
"properties": {
"large": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"dimensions": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"source": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"dimensions": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "A static image, at two of the sizes the endpoint returns.",
"additionalProperties": true
},
"video": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"embedHtml": {
"type": [
"string",
"null"
]
},
"dimensions": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
},
"attribution": {
"type": "object",
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"authorUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"authorName": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"providerUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"providerName": {
"type": [
"string",
"null"
],
"description": "e.g. 'YouTube'."
}
},
"description": "Attribution for an embedded external video (e.g. YouTube).",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "`null` for a plain text/link post with no attached media.",
"additionalProperties": true
},
"score": {
"type": "number"
},
"domain": {
"type": "string",
"description": "e.g. 'self.spez', 'reddit.com'."
},
"isNsfw": {
"type": "boolean"
},
"content": {
"type": [
"object",
"null"
],
"properties": {
"html": {
"type": "string"
},
"markdown": {
"type": "string"
},
"richtextMedia": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"hlsUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"status": {
"type": "string"
},
"dashUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"mimetype": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Images embedded inline in the post's own body text."
}
},
"description": "The post's own self-text, when it is a text post. `null` for a link/announcement post with no self-text.",
"additionalProperties": true
},
"profile": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": "string",
"description": "e.g. 'u_spez'."
},
"isNsfw": {
"type": "boolean"
},
"subscribersCount": {
"type": "number"
}
},
"description": "Present when this post lives in the author's own profile ('u_username') rather than a community subreddit; mutually exclusive with `subreddit` in practice on every post observed.",
"additionalProperties": true
},
"editedAt": {
"type": [
"string",
"null"
]
},
"isLocked": {
"type": "boolean"
},
"postHint": {
"type": [
"string",
"null"
],
"description": "e.g. 'SELF' for a text post."
},
"createdAt": {
"type": "string",
"description": "ISO 8601 with UTC offset."
},
"isSpoiler": {
"type": "boolean"
},
"permalink": {
"type": "string",
"description": "Relative path on reddit.com."
},
"postStats": {
"type": [
"object",
"null"
],
"properties": {
"shareAllTotal": {
"type": "number"
},
"viewCountTotal": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": true
},
"postTitle": {
"type": "string"
},
"subreddit": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string",
"description": "e.g. 'PUBLIC', 'RESTRICTED'."
},
"title": {
"type": "string"
},
"isNsfw": {
"type": "boolean"
},
"prefixedName": {
"type": "string",
"description": "e.g. 'r/RDDT'."
},
"isQuarantined": {
"type": "boolean"
},
"subscribersCount": {
"type": "number"
}
},
"description": "Present when this post lives in a community subreddit rather than the author's own profile.",
"additionalProperties": true
},
"thumbnail": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"dimensions": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"viewCount": {
"type": [
"number",
"null"
],
"description": "Usually `null`."
},
"authorInfo": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The author's public Reddit username."
},
"profile": {
"type": "object",
"properties": {
"isNsfw": {
"type": "boolean"
}
},
"additionalProperties": true
},
"isBlocked": {
"type": "boolean"
},
"accountType": {
"type": "string",
"description": "e.g. 'USER'."
},
"isCakeDayNow": {
"type": "boolean"
}
},
"description": "The post's own author (may differ from the queried username on a shared/multi-user feed).",
"additionalProperties": true
},
"isArchived": {
"type": "boolean"
},
"isSelfPost": {
"type": "boolean"
},
"isStickied": {
"type": "boolean"
},
"authorFlair": {
"type": [
"object",
"null"
],
"properties": {
"text": {
"type": "string"
},
"textColor": {
"type": "string"
}
},
"additionalProperties": true
},
"upvoteRatio": {
"type": "number"
},
"commentCount": {
"type": "number"
},
"languageCode": {
"type": [
"string",
"null"
],
"description": "Can be `null`."
},
"outboundLink": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"expiresAt": {
"type": "string"
}
},
"additionalProperties": true
},
"crosspostRoot": {
"type": [
"object",
"null"
],
"properties": {
"post": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"score": {
"type": "number"
},
"domain": {
"type": "string"
},
"isNsfw": {
"type": "boolean"
},
"content": {
"type": [
"object",
"null"
],
"properties": {
"html": {
"type": "string"
},
"markdown": {
"type": "string"
},
"richtextMedia": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"hlsUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"status": {
"type": "string"
},
"dashUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"mimetype": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"editedAt": {
"type": [
"string",
"null"
]
},
"isLocked": {
"type": "boolean"
},
"postHint": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"isSpoiler": {
"type": "boolean"
},
"permalink": {
"type": "string"
},
"postStats": {
"type": [
"object",
"null"
],
"properties": {
"shareAllTotal": {
"type": "number"
},
"viewCountTotal": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": true
},
"postTitle": {
"type": "string"
},
"subreddit": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"isNsfw": {
"type": "boolean"
},
"prefixedName": {
"type": "string"
},
"isQuarantined": {
"type": "boolean"
},
"subscribersCount": {
"type": "number"
}
},
"additionalProperties": true
},
"thumbnail": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"dimensions": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"viewCount": {
"type": [
"number",
"null"
]
},
"authorInfo": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The original post's author's public Reddit username."
},
"profile": {
"type": "object",
"properties": {
"isNsfw": {
"type": "boolean"
}
},
"additionalProperties": true
},
"isBlocked": {
"type": "boolean"
},
"accountType": {
"type": "string"
},
"isCakeDayNow": {
"type": "boolean"
}
},
"additionalProperties": true
},
"isArchived": {
"type": "boolean"
},
"isSelfPost": {
"type": "boolean"
},
"isStickied": {
"type": "boolean"
},
"upvoteRatio": {
"type": "number"
},
"commentCount": {
"type": "number"
},
"languageCode": {
"type": "string"
},
"outboundLink": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"expiresAt": {
"type": "string"
}
},
"additionalProperties": true
},
"isContestMode": {
"type": "boolean"
},
"postEventInfo": {
"type": [
"object",
"null"
],
"properties": {
"endsAt": {
"type": "string"
},
"startsAt": {
"type": "string"
},
"eventType": {
"type": "string",
"description": "e.g. 'AMA'."
},
"isEventAdmin": {
"type": "boolean"
},
"collaborators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"redditor": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"displayName": {
"type": "string",
"description": "The co-host's public Reddit username."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "The event's other public co-hosts, when any."
},
"remindeesCount": {
"type": "number"
}
},
"description": "Present when the original post is a scheduled event/AMA announcement.",
"additionalProperties": true
},
"distinguishedAs": {
"type": [
"string",
"null"
]
},
"crowdControlLevel": {
"type": "string"
},
"removedByCategory": {
"type": [
"string",
"null"
]
},
"isCommercialCommunication": {
"type": "boolean"
}
},
"additionalProperties": true
}
},
"description": "Present when this feed entry is a repost/crosspost of another post -- the original post's own details. `null` for an original post.",
"additionalProperties": true
},
"isContestMode": {
"type": "boolean"
},
"distinguishedAs": {
"type": [
"string",
"null"
],
"description": "e.g. 'ADMIN' when the author posted with a special badge."
},
"crowdControlLevel": {
"type": "string",
"description": "e.g. 'OFF'."
},
"removedByCategory": {
"type": [
"string",
"null"
],
"description": "Moderation-removal reason, when removed. Observed `null` (not removed) on most posts."
},
"isCommercialCommunication": {
"type": "boolean"
}
},
"description": "One post.",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"pageInfo": {
"type": "object",
"properties": {
"endCursor": {
"type": [
"string",
"null"
],
"description": "Opaque paging token; pass back as `after` to fetch older posts."
},
"hasNextPage": {
"type": "boolean"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "Observed `null` when the given `username` does not resolve to an existing Reddit account.",
"additionalProperties": true
}
},
"description": "The post-feed record.",
"additionalProperties": true
}