{"uid":"cap_FdAw0YwfHNVmHYxt9tssb","slug":"truth-social-post-scraper-a12f8357","name":"Truth Social Post Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/truth?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"maxPages":{"type":"integer","default":100,"minimum":1,"description":"Safety cap for timeline requests. Each page contains at most 20 posts; filtered results can be fewer."},"maxPosts":{"type":"integer","default":20,"minimum":1,"description":"Maximum results from the profile timeline. Filtering may require reading more posts."},"username":{"type":"string","description":"Public profile username, @username, or full profile URL. Omit when providing specific post IDs."},"onlyMedia":{"type":"boolean","default":false,"description":"Return posts with image, video, or other media attachments."},"onlyReplies":{"type":"boolean","default":false,"description":"Return only posts that reply to another post. By default, return posts that are not replies."},"startFromId":{"type":"string","description":"Fetch older posts, excluding this post ID. Cannot be combined with useLastPostId."},"cleanContent":{"type":"boolean","default":true,"description":"Remove HTML markup from content. The original markup is always available in rawContent."},"singlePostId":{"type":"array","items":{"type":"string"},"description":"Fetch these public posts directly. Accepts numeric IDs or post URLs. Overrides timeline settings."},"useLastPostId":{"type":"boolean","default":false,"description":"Save the newest post ID for this username and stop at that ID on later runs using the same storage."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"uri":null,"url":null,"title":null,"content":null,"editedAt":null,"createdAt":null,"rawContent":null}],"product":"truth"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_X4Ja9Pu86Kb7LoFJQKue9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured post data from public Truth Social profiles or specific post IDs, with filtering options for media, replies, and pagination.","exampleAgentPrompt":"Pull the last 20 posts from the Truth Social account @realDonaldTrump, skipping replies, and give me the clean text content and timestamps for each one.","exampleUseCases":[{"title":"Monitor politician's Truth Social activity","prompt":"Check the Truth Social profile for @RonDeSantis and get me the 20 most recent posts that aren't replies — I want the clean text and when each one was posted."},{"title":"Fetch media-only posts from an account","prompt":"Get the last 10 posts from the Truth Social user @TruthCentral that include images or videos — only show me posts with media attachments."},{"title":"Retrieve specific Truth Social posts by ID","prompt":"Fetch these specific Truth Social posts for me: 109876543210 and 109876543211 — I need the full content and URLs for both."}],"resultDescription":"Returns a JSON object with a count of matched posts and an items array. Each item includes the post's numeric ID, URI, URL, title, cleaned text content, raw HTML content, creation timestamp, and last-edited timestamp. The product field confirms 'truth' as the data source.","failureModes":["Private or suspended account returns empty items array with count 0 and no charge","Invalid username format returns an error","Combining startFromId and useLastPostId returns a validation error","Non-existent post IDs in singlePostId return empty results","Rate limiting or platform blocking may return a failed run, which is not charged","maxPages cap reached before maxPosts satisfied returns partial results"],"whenToPreferThis":"Choose this endpoint when you need structured, paginated access to Truth Social post data without building your own scraper. It handles pagination, HTML cleaning, and incremental syncing via useLastPostId. Prefer it over generic web scrapers when you specifically need Truth Social timeline or post data in a clean JSON format, and over manual browsing when you need to process many posts programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T01:55:17.453Z","isFirstParty":false,"canonicalSlug":"truth-social-post-scraper-a12f8357"}