{"uid":"cap_WtrDCan1mdCitZzpYkrBB","slug":"botsmith-x-user-timeline-76c1c2d1","name":"botsmith X User Timeline","description":"X User Timeline ($0.01/call): Latest posts by an X (Twitter) account: up to 20 per call, newest first, as clean JSON with metrics, hashtags, links and mentions, plus a cursor for older posts. Replies excluded unless includeReplies=true. No X account or API key needed.","url":"https://x402.botsmith.dev/x/timeline?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":["handle","includeReplies"],"properties":{"cursor":{"type":"string","pattern":"^[A-Za-z0-9+/=_|-]{1,1000}$","description":"Pagination cursor from a previous call"},"handle":{"type":"string","pattern":"^@?[A-Za-z0-9_]{1,15}$","description":"X handle, with or without the leading @"},"includeReplies":{"enum":["true","false"],"type":"string","default":"false","description":"Include the account's replies as well as its own posts"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["handle","tweets","hasNextPage","nextCursor"],"properties":{"handle":{"type":"string"},"tweets":{"type":"array","items":{"type":"object","required":["id","url","text","createdAt","lang","author","metrics","hashtags","links","mentions"],"properties":{"id":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"lang":{"anyOf":[{"type":"string"},{"type":"null"}]},"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"}},"additionalProperties":false},"description":"Up to 20 posts, newest first"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasNextPage":{"type":"boolean"}},"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_z4UuCdrxE8b8QTA6udaV0","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":"Fetches up to 20 latest posts from an X (Twitter) account as clean JSON with engagement metrics, hashtags, links, mentions, and pagination cursor.","exampleAgentPrompt":"Pull the latest 20 tweets from @naval on X — include engagement metrics, hashtags, and any links — and show me the newest ones first.","exampleUseCases":[{"title":"Track influencer posting activity","prompt":"Show me the last 20 posts from @sama on X, including how many likes and retweets each got, so I can see what he's been talking about lately."},{"title":"Monitor brand account for new content","prompt":"Fetch the most recent tweets from @OpenAI on X and tell me what they've posted this week, with their engagement numbers."},{"title":"Research a user's recent statements","prompt":"Get me the latest posts from @paulg on X — skip replies, just his own tweets — and include any outbound links he shared."}],"resultDescription":"A JSON object containing the account handle, an array of up to 20 tweet objects (each with id, URL, full text, language, author details, engagement metrics — likes/retweets/replies/quotes/views — expanded links, hashtags, and @mentions), a hasNextPage boolean, and a nextCursor string for fetching the next page of older posts.","failureModes":["Invalid or non-existent handle returns an error or empty tweet array","Private/suspended accounts cannot be fetched and return an error","Rate limits or upstream X access issues may return a 5xx error","Malformed cursor string causes a pagination error","Payment failure (insufficient USDC balance) blocks the request via x402 protocol"],"whenToPreferThis":"Choose this endpoint when you need clean structured tweet data from a specific X user's timeline without requiring your own X API credentials or developer account. It is ideal for agents that need to monitor what a specific account is posting, extract content for analysis, or paginate through a user's post history cheaply ($0.01/call). Prefer the sibling X Tweet Search endpoint when you need keyword or advanced-search queries rather than a single account's feed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:37:59.420Z","isFirstParty":false,"canonicalSlug":"botsmith-x-user-timeline-76c1c2d1"}