Reddit App Fetch Popular Feed
Fetch Reddit's site-wide popular feed for browsing popular or trending posts. All inputs are optional: - sort: BEST (default), HOT, NEW, TOP, CONTROVERSIAL, or RISING. - time: ALL (default), HOUR, DAY, WEEK, MONTH, or YEAR. - after: Pagination cursor, default empty string for the first request. Use the returned after cursor to request the next page when available; maximum 4096 characters. - filter_posts: Post IDs to exclude to help avoid duplicates, default []. Accepts up to 100 IDs in the form t3_ followed by lowercase letters or digits, with a total length of 4–20 characters per ID. - language: Preferred response language as a language tag such as en-US (default). Length: 2–16 characters; starts with 2–3 letters and may include hyphen-separated segments of 2–8 letters or digits. - need_format: Whether to request cleaned/formatted data; default false. Returns a JSON response whose data payload is documented to contain popular posts, details such as titles, content, upvotes and comment counts, and pagination information. The payload's detailed structure is not fixed by the response schema and it may be null; available post fields and a next-page cursor can vary. Example: {"sort":"HOT","time":"DAY","filter_posts":[],"after":"","language":"en-US","need_format":false}
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.
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 |
time | enum (ALL | HOUR | DAY | WEEK | MONTH | YEAR) | No | 时间范围/Time range: ALL, HOUR, DAY, WEEK, MONTH, YEAR | ALL |
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 | [] |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_reddit_app_fetch_popular_feed' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"after": "",
"filter_posts": [],
"language": "en-US",
"need_format": true,
"sort": "CONTROVERSIAL",
"time": "DAY"
}
}'{
"code": 200,
"data": {
"posts": [
{
"authorInfo": {
"accountType": "USER",
"iconSmall": {
"dimensions": {},
"url": "https://styles.redditmedia.com/t5_ags2q/styles/profileIcon_snoo-nftv2_bmZ0X2VpcDE1NToxMzdfNmFjYjhmYjgyODgwZDM5YzJiODQ0NmY4Nzc4YTE0ZDM0ZWU2Y2ZiN18zNDE1MjI_rare_9279aaf9-806c-4d15-8337-bf4f01c33f28-headshot.png?width=50&height=50&frame=1&auto=webp&crop=50%3A"
},
"id": "t2_lcuyd",
"isBlocked": false,
"isCakeDayNow": false,
"name": "Itherial"
},
"commentCount": 528,
"content": {
"html": "I just received a one month suspension from Blizzard due to my \"indirect involvement\" for RMT.\nI lead a mid-size guild with 500ish members. Obviously I get a large influx of gold/items to fund the guild.\nWell it turns out, receiving any amount of gold from",
"markdown": "I just received a one month suspension from Blizzard due to my \"indirect involvement\" for RMT.\n\nI lead a mid-size guild with 500ish members. Obviously I get a large influx of gold/items to fund the guild.\n\nWell it turns out, receiving any amount of gold fr",
"preview": "I just received a one month suspension from Blizzard due to my \"indirect involvement\" for RMT. I lead a mid-size guild with 500ish members. Obviously I get a large influx of gold/items to fund the guild. Well it turns out, receiving any amount of gold from",
"richtext": "{\"document\":[{\"c\":[{\"e\":\"text\",\"t\":\"I just received a one month suspension from Blizzard due to my \\\"indirect involvement\\\" for RMT.\"}],\"e\":\"par\"},{\"c\":[{\"e\":\"text\",\"t\":\"I lead a mid-size guild with 500ish members. Obviously I get a large influx of gold/it"
},
"createdAt": "2026-11-14T16:35:33.269000+0000",
"crowdControlLevel": "OFF",
"id": "t3_1xw6q94"
}
]
},
"docs": "https://api.tikhub.io/#/Reddit-APP-API/fetch_popular_feed_api_v1_reddit_app_fetch_popular_feed_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "0f03d4da-a555-479e-87c7-8dd8735081fa"
}This example shows part of the response. Copied content is valid JSON.

