Reddit App Fetch User Posts
Fetch posts submitted by a specific Reddit user, with sorting and pagination. Inputs: - username (required): Reddit username, 1–20 characters; letters, digits, underscores, and hyphens only. - sort (optional): NEW (newest, default), TOP (top rated), HOT (hot), or CONTROVERSIAL. - after (optional): Cursor for the next page, obtained from the response's pagination information. Defaults to an empty string; maximum 4096 characters. - language (optional): Preferred response language as an IETF language tag, such as en-US; 2–16 characters, default en-US. - need_format (optional): Whether to clean and format the returned data; defaults to false. Returns a JSON response containing the user's submitted posts and pagination information. Post information may include title, content, submission time, subreddit, upvote and comment counts, post type (text, image, video, or link), and media when available. Detailed data fields can vary; the response does not define a fixed post schema. This tool retrieves posts, not user comments. Example: {"username":"spez","sort":"NEW","after":"","language":"en-US","need_format":false}
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
The fixed fee is 2.07 credits per call. Charges are per query. A successful query is billed even if it returns no results.
Fetching the next page using a pagination cursor is a new call and is charged separately.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
sort | enum (NEW | TOP | HOT | CONTROVERSIAL) | No | 排序方式/Sort method: NEW, TOP, HOT, CONTROVERSIAL | NEW |
after | string | No | 分页参数/Pagination parameter | "" |
language | string | No | 返回内容使用的语言,采用 IETF 语言标签;默认 en-US / Preferred response language as an IETF language tag; default: en-US | en-US |
username | string | Yes | 用户名/Username | — |
need_format | boolean | No | 是否需要清洗数据/Whether to clean and format the data | false |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_reddit_app_fetch_user_posts' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"username": "xxx"
}
}'No response example available yet.

