Connection check
verified live · 27h ago
pa1m-reddit
Pay-per-call Reddit agent: post reading, voting, commenting, DM and OAuth flows. x402, USDC on Base.
Tools
10
GitHub stars
—
Installs / wk
—
Licence
—
Transport
sse
Last checked
27h ago
Tools & capabilities
10 toolsRead from the running server on 27h ago.
get_comments_by_id
post_id*
Post Comments by Post ID — $0.01 Fetch the full comment tree for a Reddit post using its short alphanumeric post ID. Same response as the permalink endpoint — use this when you ha… Post Comments by Post ID — $0.01 Fetch the full comment tree for a Reddit post using its short alphanumeric post ID. Same response as the permalink endpoint — use this when you have the ID, not the full URL. Post IDs can be extracted from Reddit URLs: reddit.com/r/x/comments/{post_id}/... Example: GET /comments/1abc123 ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json
get_comments_by_permalink
permalink*
Post Comments by Permalink — $0.01 Fetch the full comment tree for a Reddit post using its permalink URL. Returns top-level comments with nested replies, upvote counts, and author… Post Comments by Permalink — $0.01 Fetch the full comment tree for a Reddit post using its permalink URL. Returns top-level comments with nested replies, upvote counts, and author metadata. Use this when you have the full Reddit URL. Permalink format: /r/{subreddit}/comments/{post_id}/{title}/ Example: GET /comments?permalink=/r/python/comments/1abc123/my_post_title/ ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json
get_posts
tsortafterlimitsubreddit*
Subreddit Posts — $0.01 Fetch posts from any subreddit with sorting and pagination. No Reddit account needed. Sorting options: hot (trending now), new (most recent), top (most upv… Subreddit Posts — $0.01 Fetch posts from any subreddit with sorting and pagination. No Reddit account needed. Sorting options: hot (trending now), new (most recent), top (most upvoted), rising (gaining momentum), controversial (most debated), best (Reddit's personalized ranking). Use t= parameter (hour/day/week/month/year/all) with sort=top or sort=controversial. Paginate by passing the 'after' cursor from the previous response. Up to 100 posts per call. Example: GET /posts?subreddit=MachineLearning&sort=top&t=week&limit=50 ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json
get_user
username*
User Profile — $0.01 Fetch a Reddit user's public profile. Returns link karma, comment karma, account age, gold/mod/employee status flags, verified email flag, icon URL, and profi… User Profile — $0.01 Fetch a Reddit user's public profile. Returns link karma, comment karma, account age, gold/mod/employee status flags, verified email flag, icon URL, and profile description. Example: GET /user/spez ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json
get_user_comments
sortafterlimitusername*
User Comment History — $0.01 Fetch a Reddit user's recent comments. Each item includes subreddit, upvote score, parent post title, comment body, and creation timestamp. Sort by ne… User Comment History — $0.01 Fetch a Reddit user's recent comments. Each item includes subreddit, upvote score, parent post title, comment body, and creation timestamp. Sort by new (default), top, or controversial. Paginate with the 'after' cursor. Example: GET /user/spez/comments?sort=top&limit=10 ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json
login
password*username*totp_secret
Reddit Login — $0.05 Authenticate a Reddit account and receive session cookies needed for write operations (comment, vote, DM). Cookies are valid until revoked by Reddit. For acco… Reddit Login — $0.05 Authenticate a Reddit account and receive session cookies needed for write operations (comment, vote, DM). Cookies are valid until revoked by Reddit. For accounts with 2FA, pass totp_secret to generate the TOTP code automatically. Body: {"username": "...", "password": "...", "totp_secret": "..." (optional)} ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json
post_comment
loid*text*post_url*token_v2csrf_tokenreddit_session*
Post Comment — $0.05 Submit a top-level comment on a Reddit post. Requires session cookies from POST /login (reddit_session + loid fields). Body: {"post_url": "https://reddit.com/… Post Comment — $0.05 Submit a top-level comment on a Reddit post. Requires session cookies from POST /login (reddit_session + loid fields). Body: {"post_url": "https://reddit.com/r/...", "text": "...", "reddit_session": "...", "loid": "..."} ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json
search_posts
q*tnsfwsortafterlimit
+1
Search Reddit Posts — $0.01 Search Reddit posts globally or restrict to a specific subreddit. Mirrors the Posts tab on reddit.com/search. Sorting: relevance (default — highest upv… Search Reddit Posts — $0.01 Search Reddit posts globally or restrict to a specific subreddit. Mirrors the Posts tab on reddit.com/search. Sorting: relevance (default — highest upvoted may outrank closest match on broad queries), new (strict chronological), hot, top, comments. Tip: use sort=new with t=week for recent topical results; sort=relevance for best match. Set nsfw=true to include adult content. Paginate with 'after' cursor. Example: GET /search?q=Claude+API&sort=new&t=month&limit=25 ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json
send_dm
loid*message*csrf_tokento_user_t2to_usernamereddit_session*
Send Direct Message — $0.10 Send a private message to a Reddit user. Pass to_username (e.g. 'spez') or to_user_t2 (Reddit internal ID like t2_xxx). Requires session cookies from P… Send Direct Message — $0.10 Send a private message to a Reddit user. Pass to_username (e.g. 'spez') or to_user_t2 (Reddit internal ID like t2_xxx). Requires session cookies from POST /login. Body: {"to_username": "spez", "message": "Hello!", "reddit_session": "...", "loid": "..."} ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json
vote
loid*thing_id*direction*csrf_tokenreddit_session*