{"uid":"cap_aJ8U3W1ML_2p_KNySeepR","slug":"api-direct-threads-user-posts-feed-fb7c7c6a","name":"API Direct – Threads User Posts Feed","description":"Get a single Threads user's recent posts (their feed) by username.","url":"https://x402.apidirect.io/v1/threads/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":["username"],"properties":{"pages":{"type":"integer","default":1,"maximum":60,"minimum":1,"description":"Number of pages to fetch, 1-60 (default: 1). Each page returns up to about 35 posts, newest first; you are billed per page returned."},"username":{"type":"string","maxLength":100,"description":"Threads username, with or without leading @ (max 100 characters)"},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each result (+$0.001/request)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DKOLtNj7X3TUbSpodxKXL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a Threads user's recent posts (their feed) by username, optionally with AI sentiment analysis.","exampleAgentPrompt":"Pull the last 2 pages of recent Threads posts from @zuck — so about 70 posts newest first — and include the AI sentiment analysis for each one.","exampleUseCases":[{"title":"Monitor brand mentions on Threads","prompt":"Fetch the last 3 pages of posts from the Threads account @nikesportswear and include sentiment scores so I can see how they're presenting their brand right now."},{"title":"Research a creator's content cadence","prompt":"Get me the most recent Threads posts from @paulocoelho — just 1 page is fine — so I can see what topics he's been writing about lately."},{"title":"Competitor social media audit","prompt":"Pull 5 pages of Threads posts from @openai with sentiment analysis turned on, so I can review their recent messaging and tone across roughly 175 posts."}],"resultDescription":"Returns a paginated list of recent Threads posts for the specified user, ordered newest first. Each page contains up to ~35 posts. When sentiment analysis is enabled (get_sentiment=true), each post also includes AI-generated emotion/sentiment scores. The caller is billed per page returned.","failureModes":["Username not found or account doesn't exist — likely a 404 or empty result","Private or restricted Threads account — posts not accessible","Invalid username format — validation error","Pages parameter out of range (must be 1–60) — schema validation error","Rate limiting or upstream Threads API unavailability — 5xx error","Billing/payment failure via x402 protocol — 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need to programmatically retrieve a specific Threads user's recent post history by username, especially for social listening, competitive research, content auditing, or monitoring a creator's activity over time. It supports multi-page fetching (up to ~2,100 posts across 60 pages) and optional AI sentiment enrichment per post, making it suitable for both quick snapshots and deeper historical pulls. Prefer it over manual browsing or general social scraping tools when you need structured, paginated Threads feed data with an optional emotional tone layer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:12.839Z","isFirstParty":false,"canonicalSlug":"api-direct-threads-user-posts-feed-fb7c7c6a"}