Skip to content
Eden Engine

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.

activeper callv2

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

Reddit

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.

agent
// 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 do

Not 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.

ChargePrice
Per call
$0.00205
Updated
Oct 25, 2026

Input and output schemas

Input schema
input_schema.json
{
  "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
output_schema.json
{
  "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
}