Reddit — APIFuse Bounty

SocialPlatform secret

reddit.com

Reddit public listing and search API provider.

Tier: 🥉 Bronze
Reward: ₩50,000
Auth: Platform secret
Operations: 3
Working now: 0 contributors
Status: Open

Scope

Read subreddit feeds and search Reddit over plain HTTP with no browser. Listing supports limit and after paging; search supports query, sort, and time window. Results expose real post fields such as title, score, num_comments, permalink, and author, plus an after cursor for the next page.

Expected operations

list-subreddit-postsList subreddit postsreadDifficulty: easy

List a subreddit feed as JSON and page through results with limit and after. Backed by Reddit JSON.

Inputs

subredditstringrequired

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Subreddit name without the leading r/.

sortstringrequired

Feed sort order such as hot, new, top, or rising.

hot

limitnumberoptional

Maximum number of posts to return in one page.

afterstringoptional

Pagination token from the previous page's data.after value.

t3_abc123

Outputs

datachildrenaftertitlescorenum_commentspermalinkauthor

Acceptance

Returns subreddit posts as normalized post records rather than a fabricated wrapper.
Supports limit and after paging and surfaces the returned after token for the next page.
Each post record includes real fields such as title, score, num_comments, permalink, and author.

No account auth required for this operation.

search-postsSearch postsreadDifficulty: easy

Search public Reddit content with the requested query, sort, and time filter. Backed by Reddit JSON.

Inputs

querystringrequired
Search query text.
rust async
sortstringoptional
Search sort order such as relevance, hot, top, new, or comments.
relevance
tstringoptional
Time filter such as hour, day, week, month, year, or all.
month
limitnumberoptional
Maximum number of search hits per page.
10
afterstringoptional
Pagination token returned from a previous search page.
t3_def456

Outputs

datachildrenaftertitlescorenum_comments

get-post-detailsGet post detailsreadDifficulty: easy

Read a single post record from a subreddit listing or search result and expose the same Reddit data fields found in the JSON payload. Backed by Reddit JSON.

Inputs

permalinkstringrequired
Reddit permalink path for the target post.
/r/python/comments/abc123/example_post/

Outputs

titlescorenum_commentspermalinkauthorsubreddit

Acceptance

Applies query, sort, and time-window filters instead of returning generic placeholders.
Returns listing-style results with a usable after cursor when more pages exist.
Each result exposes real post metadata including title, score, num_comments, permalink, and author.

No account auth required for this operation.

Acceptance

Targets a real post permalink and returns the matching post record, not a synthetic detail schema.
Includes canonical post identifiers and counters such as title, score, num_comments, permalink, and author.
Can be derived from a feed or search result without inventing fields the source does not return.

No account auth required for this operation.