Reddit App Fetch Subreddit Feed
Retrieve a page of posts from a Reddit subreddit, with optional sorting, post exclusions, and pagination. Inputs: - subreddit_name (required): Bare subreddit name without r/ or a URL, for example AskReddit. Must contain 2–21 ASCII letters, digits, or underscores. - sort (optional): BEST (default), HOT, NEW, TOP, CONTROVERSIAL, or RISING. - filter_posts (optional): Post IDs to exclude, default []. Accepts up to 100 IDs, each 4–20 characters long and matching t3_ followed by lowercase letters or digits. - after (optional): Cursor for the next page, using pagination information from a previous result. Defaults to an empty string; maximum 4096 characters. - language (optional): Preferred response language as an IETF language tag, such as en-US (default). Must be 2–16 characters, starting with 2–3 letters and optionally followed by hyphen-separated segments of 2–8 letters or digits. - need_format (optional): Whether to clean and format the data; defaults to false. Returns: JSON with feed data describing the post list, post details, subreddit metadata, and pagination information when available. The data payload may be null, and its detailed field structure is not fixed by the documented response schema. This is a feed retrieval tool, not a keyword search or comment retrieval tool. Example: {"subreddit_name":"AskReddit","sort":"HOT"}
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
2.07 credits/call applies to normal successful calls; this amount is not an absolute minimum charge for cases such as empty results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
sort | enum (BEST | HOT | NEW | TOP | CONTROVERSIAL | RISING) | No | 排序方式/Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL, RISING | BEST |
after | string | No | 分页参数/Pagination parameter | "" |
language | string | No | 返回内容使用的语言,采用 IETF 语言标签;默认 en-US / Preferred response language as an IETF language tag; default: en-US | en-US |
need_format | boolean | No | 是否需要清洗数据/Whether to clean and format the data | false |
filter_posts | array | No | 过滤帖子ID列表/Filter post IDs | [] |
subreddit_name | string | Yes | 版块名称/Subreddit name | — |
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_subreddit_feed' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"subreddit_name": "xxx"
}
}'No response example available yet.

