{"uid":"cap_oTjnaK5-78kjMgjHfgeHb","slug":"api-direct-truth-social-user-posts-feed-384412ce","name":"API Direct – Truth Social User Posts Feed","description":"Get a single Truth Social user's recent posts (their feed) by username.","url":"https://x402.apidirect.io/v1/truthsocial/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":20,"minimum":1,"description":"Number of pages to fetch and merge into one response (1-20, billed per page). Each page returns up to 20 posts. Fetching stops early when there are no more results."},"username":{"type":"string","maxLength":100,"description":"Truth Social 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 post. 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, negative or neutral). Any post t"}}}},"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_KPp-RFp-rRbEN-3QYCKSN","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 Truth Social user's recent posts by username, with optional AI sentiment analysis per post.","exampleAgentPrompt":"Pull the last 2 pages of posts from Truth Social user @kari_lake and include AI sentiment analysis so I can see the emotional tone of each post.","exampleUseCases":[{"title":"Political researcher tracking candidate posts","prompt":"Fetch the most recent 3 pages of Truth Social posts from @realDonaldTrump and include sentiment analysis on each one so I can see which emotions dominate his messaging."},{"title":"Journalist monitoring breaking statements","prompt":"Get the latest Truth Social posts from @DeSantisWarRoom — just 1 page is fine — so I can see if there's been any new announcement in the last few hours."},{"title":"Social media analyst comparing account activity","prompt":"Pull 5 pages of posts from Truth Social user @SpeakerJohnson with sentiment scoring enabled so I can analyze his emotional intensity trends over time."}],"resultDescription":"Returns a merged list of up to 20 posts per page (up to 400 posts total across 20 pages) from the specified Truth Social user. Each post includes standard post content fields. When sentiment analysis is enabled, each post also includes a `sentiment` object with per-emotion scores (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0–100), a dominant_emotion label, emotional_intensity (0–10), and a polarity classification (positive, negative, or neutral).","failureModes":["Username not found — returns empty result or 404-style error if the account does not exist","Private or suspended account — posts may not be accessible","Exceeding page limit — maximum of 20 pages per call; requests above this are rejected","Rate limiting or payment failure — x402 payment not processed correctly results in 402 response","Username with special characters may need URL encoding"],"whenToPreferThis":"Use this endpoint when you need to retrieve posts from a specific Truth Social user by username, especially when optional AI-powered sentiment/emotion analysis per post is desired. Prefer it over manual scraping or general social media APIs that don't cover Truth Social. It supports pagination up to 20 pages so it works for both quick spot-checks and deeper historical pulls.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:40.142Z","isFirstParty":false,"canonicalSlug":"api-direct-truth-social-user-posts-feed-384412ce"}