{"uid":"cap_tg1KWxjOLJIxZtYMozuiw","slug":"api-direct-reddit-user-posts-4fb4b970","name":"API Direct – Reddit User Posts","description":"Get a Reddit user's submitted posts by username or profile URL.","url":"https://x402.apidirect.io/v1/reddit/user/posts?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"url":{"type":"string","maxLength":500,"description":"Reddit profile URL, e.g. https://www.reddit.com/user/spez (max 500 characters). Provide exactly one of username or url."},"pages":{"type":"integer","default":1,"maximum":40,"minimum":1,"description":"Number of pages to fetch, 1-40 (default: 1). Each page returns up to 25 posts."},"sort_by":{"enum":["most_recent","hot","top","controversial"],"type":"string","default":"most_recent","description":"Sort order: most_recent, hot, top, or controversial (default: most_recent)"},"username":{"type":"string","maxLength":26,"description":"Reddit username, with or without u/ (3-20 characters). Provide exactly one of username or url."},"posted_ago":{"enum":["1h","24h","7d","30d","12m","all"],"type":"string","description":"Time window for sort_by=top or sort_by=controversial: 1h, 24h, 7d, 30d, 12m, or all (default: all). Rejected with any other sort_by."},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each post (returned in the `posts` array). Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, "}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_67nerRb0fOrR97viEjkwT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a Reddit user's submitted posts by username or profile URL, with optional sorting, time filtering, and AI sentiment analysis.","exampleAgentPrompt":"Pull the top 50 posts from Reddit user u/spez sorted by top posts of all time, and include AI sentiment analysis on each one.","exampleUseCases":[{"title":"Research a Reddit user's activity","prompt":"Can you get the last 2 pages of posts from Reddit user u/gallowboob sorted by most recent so I can see what they've been posting lately?"},{"title":"Sentiment analysis of a user's posts","prompt":"Fetch the top posts from Reddit user u/science from the past 30 days and include the AI emotion analysis so I can see the emotional tone of their submissions."},{"title":"Track controversial posts from a profile","prompt":"Get me the most controversial posts of all time from this Reddit profile — https://www.reddit.com/user/Unidan — sorted by controversial across all time."}],"resultDescription":"Returns an array of Reddit posts submitted by the specified user, each containing post metadata (title, URL, score, comments, subreddit, timestamp, etc.). When get_sentiment is enabled, each post also includes a sentiment object with emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0–100), dominant emotion, emotional intensity (0–10), and polarity. Up to 25 posts per page, up to 40 pages.","failureModes":["Invalid or non-existent username returns an error or empty result","Providing both username and url simultaneously causes a validation error","Using posted_ago with sort_by values other than top or controversial returns a rejection","Requesting more than 40 pages returns a validation error","Private or suspended Reddit accounts may return empty or error responses","Rate limiting or payment failure returns a 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need to retrieve the post history of a specific Reddit user by username or profile URL. It is the right choice when you need paginated access to up to 1000 posts with flexible sorting (most recent, hot, top, controversial), optional time windowing, and optional per-post AI sentiment/emotion analysis. Prefer it over general Reddit search when you already know the target user and want their submission history rather than content matching a keyword.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:00.745Z","isFirstParty":false,"canonicalSlug":"api-direct-reddit-user-posts-4fb4b970"}