{"uid":"cap_brjIcRoU0krcN17WGXU1N","slug":"botsmith-x-thread-unroll-32ace3f6","name":"botsmith X Thread Unroll","description":"X Thread Unroll ($0.01/call): Unroll an X (Twitter) thread from any post id in it: the conversation author's posts oldest first with their text joined for reading, then the replies around it, each with metrics and its reply-to id. Pass the cursor for more replies. No X account or API key needed.","url":"https://x402.botsmith.dev/x/thread?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"],"type":"string"},"queryParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","pattern":"^[0-9]{1,25}$","description":"Numeric id of any post in the thread"},"cursor":{"type":"string","pattern":"^[A-Za-z0-9+/=_|-]{1,1000}$","description":"Pagination cursor from a previous call"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["focalId","conversationId","author","threadText","tweets","hasNextPage","nextCursor"],"properties":{"author":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Handle of the conversation author"},"tweets":{"type":"array","items":{"type":"object","required":["id","url","text","createdAt","lang","author","metrics","hashtags","links","mentions","inReplyToId","role"],"properties":{"id":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"lang":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"enum":["thread","reply"],"type":"string","description":"thread = the author's own posts, reply = everyone else"},"text":{"type":"string"},"links":{"type":"array","items":{"type":"string"},"description":"Expanded outbound URLs"},"author":{"type":"object","required":["handle","name","id"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"metrics":{"type":"object","required":["likes","retweets","replies","quotes","views"],"properties":{"likes":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"views":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"quotes":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"retweets":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]}},"additionalProperties":false},"hashtags":{"type":"array","items":{"type":"string"}},"mentions":{"type":"array","items":{"type":"string"},"description":"Mentioned handles"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601"},"inReplyToId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"description":"Thread posts oldest first, then replies"},"focalId":{"type":"string"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"threadText":{"type":"string","description":"The author's thread posts joined, oldest first"},"hasNextPage":{"type":"boolean"},"conversationId":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Id of the post that started the conversation"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JTFZY1p8f0BX_gE_5r6wb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Unrolls an X (Twitter) thread from any post ID, returning the conversation author's posts oldest-first with joined text, plus surrounding replies with metrics and pagination.","exampleAgentPrompt":"Can you unroll the X thread starting from tweet ID 1234567890123456789 and give me the full text in reading order along with like and retweet counts for each post?","exampleUseCases":[{"title":"Read viral thread without Twitter account","prompt":"There's a long X thread I want to read in full — can you unroll tweet ID 1802345678901234567 and show me all the author's posts joined together as one readable piece of text?"},{"title":"Analyze reply engagement on a debate thread","prompt":"Fetch the thread for tweet 1799988776655443322 and show me all the replies with their like counts and who each one is replying to, so I can see which responses got the most traction."},{"title":"Paginate through a high-reply thread","prompt":"I need to see more replies on that X thread — here's the cursor from my last call: 'ABC123xyz=='. Keep unrolling tweet ID 1801234567890123456 and give me the next page of replies."}],"resultDescription":"Returns a JSON object with the focal tweet ID, conversation ID, author handle, joined thread text (author's posts oldest-first), an array of tweet objects (each with id, url, text, createdAt, lang, author info, engagement metrics, expanded links, hashtags, mentions, inReplyToId, and role as 'thread' or 'reply'), a hasNextPage flag, and a nextCursor string for pagination.","failureModes":["Invalid or non-numeric tweet ID returns a validation error","Deleted or private tweet/thread returns empty or error response","Rate limiting or upstream X API unavailability may cause failures","Invalid cursor format causes pagination to fail","Thread with zero replies returns only the author's thread posts with no reply objects"],"whenToPreferThis":"Choose this endpoint when you need to read a full X/Twitter thread without an account or API key, want the conversation author's posts joined for clean reading, need reply metrics and threading structure, or need to paginate through large reply sets. Prefer over scraping solutions when cost ($0.01/call) is acceptable and structured JSON output is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:34:40.602Z","isFirstParty":false,"canonicalSlug":"botsmith-x-thread-unroll-32ace3f6"}