{"version":2,"name":"Pa1m Reddit","description":"Reddit reads and authenticated writes for AI agents.","payTo":"0xE43b08f2031e3332ce97C0E0EA6E8bB00bd04fB4","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","endpoints":[{"path":"/posts","method":"GET","price":"0.01","description":"Fetch posts from any subreddit with sorting and pagination. Up to 100 posts per call, no Reddit account needed.","input":{"queryParams":{"subreddit":{"type":"string","description":"Subreddit name without the r/ prefix","required":true,"sample":"MachineLearning"},"sort":{"type":"string","description":"hot, new, top, rising, controversial or best","required":false,"sample":"top"},"t":{"type":"string","description":"Time window for top/controversial: hour, day, week, month, year or all","required":false,"sample":"week"},"limit":{"type":"integer","description":"1-100, default 25","required":false,"sample":25},"after":{"type":"string","description":"Pagination cursor from the previous response","required":false,"sample":"t3_1abc123"}},"pathParams":{}}},{"path":"/search","method":"GET","price":"0.01","description":"Full-text search across Reddit posts, globally or within one subreddit, with sort and time filters.","input":{"queryParams":{"q":{"type":"string","description":"Search query","required":true,"sample":"Claude API"},"subreddit":{"type":"string","description":"Restrict to one subreddit, without the r/ prefix","required":false,"sample":"python"},"sort":{"type":"string","description":"relevance, new, hot, top or comments","required":false,"sample":"new"},"t":{"type":"string","description":"hour, day, week, month, year or all","required":false,"sample":"month"},"nsfw":{"type":"boolean","description":"Include adult content","required":false,"sample":false},"limit":{"type":"integer","description":"1-100, default 25","required":false,"sample":25},"after":{"type":"string","description":"Pagination cursor","required":false,"sample":"t3_1abc123"}},"pathParams":{}}},{"path":"/comments","method":"GET","price":"0.01","description":"Fetch the full comment tree for a post by its permalink URL, with nested replies, scores and author metadata.","input":{"queryParams":{"permalink":{"type":"string","description":"Reddit permalink, /r/{subreddit}/comments/{post_id}/{title}/","required":true,"sample":"/r/python/comments/1abc123/my_post_title/"}},"pathParams":{}}},{"path":"/comments/{post_id}","method":"GET","price":"0.01","description":"Fetch the full comment tree for a post by its short post ID. Same response as the permalink route.","input":{"queryParams":{},"pathParams":{"post_id":{"type":"string","description":"Reddit post ID, e.g. 1sgjld3","required":true,"sample":"1sgjld3"}}}},{"path":"/user/{username}","method":"GET","price":"0.01","description":"Fetch a Reddit user's public profile: link and comment karma, account age, status flags and profile description.","input":{"queryParams":{},"pathParams":{"username":{"type":"string","description":"Reddit username without the u/ prefix","required":true,"sample":"spez"}}}},{"path":"/user/{username}/comments","method":"GET","price":"0.01","description":"Fetch a user's recent comments with subreddit, score, parent post title, body and timestamp.","input":{"queryParams":{"sort":{"type":"string","description":"new, top or controversial","required":false,"sample":"top"},"limit":{"type":"integer","description":"1-100, default 25","required":false,"sample":25},"after":{"type":"string","description":"Pagination cursor","required":false,"sample":"t1_1abc123"}},"pathParams":{"username":{"type":"string","description":"Reddit username without the u/ prefix","required":true,"sample":"spez"}}}},{"path":"/login","method":"POST","price":"0.05","description":"Exchange Reddit credentials for the session cookies the write endpoints require. Credentials are used for this call only and are not stored.","input":{"body":{"type":"object","properties":{"username":{"type":"string","description":"Reddit account username"},"password":{"type":"string","description":"Reddit account password"},"totp_secret":{"type":"string","description":"TOTP secret, only if 2FA is enabled"}},"required":["username","password"]}}},{"path":"/comment","method":"POST","price":"0.05","description":"Post a comment on a Reddit thread using session cookies from /login.","input":{"body":{"type":"object","properties":{"post_url":{"type":"string","description":"Full URL of the post to comment on"},"text":{"type":"string","description":"Comment body"},"reddit_session":{"type":"string","description":"Session cookie from /login"},"loid":{"type":"string","description":"loid cookie from /login"},"csrf_token":{"type":"string","description":"Optional CSRF token"},"token_v2":{"type":"string","description":"Optional token_v2 cookie"}},"required":["post_url","text","reddit_session","loid"]}}},{"path":"/vote","method":"POST","price":"0.02","description":"Upvote, downvote or clear a vote on a post or comment using session cookies from /login.","input":{"body":{"type":"object","properties":{"thing_id":{"type":"string","description":"Fullname of the target, e.g. t3_ for a post or t1_ for a comment"},"direction":{"type":"string","description":"1 to upvote, -1 to downvote, 0 to clear"},"reddit_session":{"type":"string","description":"Session cookie from /login"},"loid":{"type":"string","description":"loid cookie from /login"},"csrf_token":{"type":"string","description":"Optional CSRF token"}},"required":["thing_id","direction","reddit_session","loid"]}}},{"path":"/dm","method":"POST","price":"0.10","description":"Send a Reddit direct message using session cookies from /login. Target by username or by t2 user ID.","input":{"body":{"type":"object","properties":{"to_username":{"type":"string","description":"Recipient username, without the u/ prefix"},"to_user_t2":{"type":"string","description":"Recipient t2 user ID, as an alternative to to_username"},"message":{"type":"string","description":"Message body"},"reddit_session":{"type":"string","description":"Session cookie from /login"},"loid":{"type":"string","description":"loid cookie from /login"},"csrf_token":{"type":"string","description":"Optional CSRF token"}},"required":["message","reddit_session","loid"]}}},{"path":"/health","method":"GET","price":"0","description":"Liveness check. Free."}],"openapi":"https://reddit.hypa1m.xyz/openapi.json","llms_txt":"https://reddit.hypa1m.xyz/llms.txt"}