Reddit App Fetch Subreddit Feed

2.07 credits/call
ae_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"}

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
sortenum (BEST | HOT | NEW | TOP | CONTROVERSIAL | RISING)No排序方式/Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL, RISINGBEST
afterstringNo分页参数/Pagination parameter""
languagestringNo返回内容使用的语言,采用 IETF 语言标签;默认 en-US / Preferred response language as an IETF language tag; default: en-USen-US
need_formatbooleanNo是否需要清洗数据/Whether to clean and format the datafalse
filter_postsarrayNo过滤帖子ID列表/Filter post IDs[]
subreddit_namestringYes版块名称/Subreddit name—

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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.