[{"data":1,"prerenderedAt":191},["ShallowReactive",2],{"doc-\u002Fdocs\u002Fsocial":3},{"id":4,"title":5,"body":6,"description":181,"extension":182,"icon":183,"meta":184,"navigation":185,"order":186,"path":187,"seo":188,"stem":189,"__hash__":190},"docs\u002Fdocs\u002Fsocial.md","Truth Social API",{"type":7,"value":8,"toc":173},"minimark",[9,14,18,41,50,54,61,71,74,78,89,95,106,112,115,119,126,132,135,139,170],[10,11,13],"h2",{"id":12},"available-endpoints","Available endpoints",[15,16,17],"p",{},"The social service exposes public Truth Social data through ScrapeCreators. Every route is protected\nby x402 and returns the upstream JSON response without inventing a second response format.",[19,20,21,29,35],"ul",{},[22,23,24,28],"li",{},[25,26,27],"code",{},"GET \u002Fv1\u002Fsocial\u002Ftruthsocial\u002Fprofile"," looks up a profile by handle.",[22,30,31,34],{},[25,32,33],{},"GET \u002Fv1\u002Fsocial\u002Ftruthsocial\u002Fuser-posts"," returns a user's posts with pagination support.",[22,36,37,40],{},[25,38,39],{},"GET \u002Fv1\u002Fsocial\u002Ftruthsocial\u002Fpost"," fetches one post from its canonical Truth Social URL.",[15,42,43,44,49],{},"Use the ",[45,46,48],"a",{"href":47},"\u002Freference","generated API reference"," for current prices, query parameters, and response\nstatuses.",[10,51,53],{"id":52},"fetch-a-profile","Fetch a profile",[15,55,56,57,60],{},"Pass the username without an ",[25,58,59],{},"@"," prefix:",[62,63,69],"pre",{"className":64,"code":66,"language":67,"meta":68},[65],"language-text","GET \u002Fv1\u002Fsocial\u002Ftruthsocial\u002Fprofile?handle=realDonaldTrump\n","text","",[25,70,66],{"__ignoreMap":68},[15,72,73],{},"The service normalizes handles for caching. Profile results are cached briefly to reduce upstream\nlatency without keeping stale profile data for long periods.",[10,75,77],{"id":76},"fetch-user-posts","Fetch user posts",[15,79,80,81,84,85,88],{},"Identify the account with either ",[25,82,83],{},"handle"," or ",[25,86,87],{},"userId",". At least one is required.",[62,90,93],{"className":91,"code":92,"language":67,"meta":68},[65],"GET \u002Fv1\u002Fsocial\u002Ftruthsocial\u002Fuser-posts?handle=realDonaldTrump&trim=true\n",[25,94,92],{"__ignoreMap":68},[15,96,97,98,101,102,105],{},"Set ",[25,99,100],{},"trim=true"," for a smaller response when the upstream supports it. To request the next page, pass\nthe returned pagination cursor as ",[25,103,104],{},"nextMaxId",":",[62,107,110],{"className":108,"code":109,"language":67,"meta":68},[65],"GET \u002Fv1\u002Fsocial\u002Ftruthsocial\u002Fuser-posts?userId=107780257626128497&nextMaxId=114315219437063159\n",[25,111,109],{"__ignoreMap":68},[15,113,114],{},"First-page timelines use a short cache lifetime. Paginated historical results are cached longer\nbecause they change less frequently.",[10,116,118],{"id":117},"fetch-one-post","Fetch one post",[15,120,121,122,125],{},"Pass the complete public post URL as an encoded ",[25,123,124],{},"url"," query parameter:",[62,127,130],{"className":128,"code":129,"language":67,"meta":68},[65],"GET \u002Fv1\u002Fsocial\u002Ftruthsocial\u002Fpost?url=https%3A%2F%2Ftruthsocial.com%2F%40realDonaldTrump%2Fposts%2F114315219437063160\n",[25,131,129],{"__ignoreMap":68},[15,133,134],{},"URL fragments are removed before cache lookup. Invalid URLs fail validation before an upstream\nrequest is made.",[10,136,138],{"id":137},"errors-and-retries","Errors and retries",[15,140,141,142,145,146,149,150,149,153,149,156,159,160,163,164,166,167,169],{},"Validation failures return ",[25,143,144],{},"400",". Upstream authentication, policy, missing-resource, rate-limit, and\navailability errors may return ",[25,147,148],{},"401",", ",[25,151,152],{},"403",[25,154,155],{},"404",[25,157,158],{},"429",", or ",[25,161,162],{},"503",". Retry only transient ",[25,165,158],{}," and\n",[25,168,162],{}," responses, preserve the payment identifier, and use exponential backoff.",[15,171,172],{},"The service degrades gracefully when its cache is unavailable: requests continue to the upstream\nprovider and cache failures are recorded in structured logs.",{"title":68,"searchDepth":174,"depth":174,"links":175},2,[176,177,178,179,180],{"id":12,"depth":174,"text":13},{"id":52,"depth":174,"text":53},{"id":76,"depth":174,"text":77},{"id":117,"depth":174,"text":118},{"id":137,"depth":174,"text":138},"Fetch public Truth Social profiles, user timelines, and individual posts.","md","lucide:messages-square",{},true,5,"\u002Fdocs\u002Fsocial",{"title":5,"description":181},"docs\u002Fsocial","snSPbw_dNyYRjbva32aXp0wGy6m4zT626-qwJ8e6ZaI",1787093955740]