{"uid":"cap_L-n8lVWZGywedYFWP1typ","slug":"x-account-dossier-414bc7f0","name":"X Account Dossier","description":"X Account Dossier ($0.05/call): Full X (Twitter) account dossier in one call: profile, an analysis of recent posts (cadence, average engagement, reply/retweet/link share, top hashtags and mentions), the raw recent posts, and a transparent bot-likelihood signal with the evidence behind it. Composes profile + activity so an agent vetting an account does not have to. No X account or API key needed.","url":"https://x402.botsmith.dev/x/dossier?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","sampleSize"],"properties":{"handle":{"type":"string","pattern":"^@?[A-Za-z0-9_]{1,15}$","description":"X handle, with or without the leading @"},"sampleSize":{"type":"integer","default":20,"maximum":20,"minimum":1,"description":"How many recent posts to analyze (max 20)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["profile","activity","authenticity"],"properties":{"profile":{"type":"object","required":["handle","id","name","bio","url","location","profileImage","verified","followers","following","tweetCount","createdAt","accountAgeDays"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified":{"type":"object","required":["blue","type"],"properties":{"blue":{"type":"boolean"},"type":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601 account creation time"},"followers":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"following":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"tweetCount":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"profileImage":{"anyOf":[{"type":"string"},{"type":"null"}]},"accountAgeDays":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]}},"additionalProperties":false},"activity":{"type":"object","required":["sampleSize","spanDays","postsPerDay","avgLikes","avgRetweets","avgReplies","replyShare","retweetShare","withLinksShare","topHashtags","topMentions"],"properties":{"avgLikes":{"anyOf":[{"type":"number"},{"type":"null"}]},"spanDays":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Days between oldest and newest sampled post"},"avgReplies":{"anyOf":[{"type":"number"},{"type":"null"}]},"replyShare":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Fraction of sampled posts that are replies"},"sampleSize":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"avgRetweets":{"anyOf":[{"type":"number"},{"type":"null"}]},"postsPerDay":{"anyOf":[{"type":"number"},{"type":"null"}]},"topHashtags":{"type":"array","items":{"type":"object","required":["tag","count"],"properties":{"tag":{"type":"string"},"count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false}},"topMentions":{"type":"array","items":{"type":"object","required":["handle","count"],"properties":{"count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"handle":{"type":"string"}},"additionalProperties":false}},"retweetShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"withLinksShare":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"authenticity":{"type":"object","required":["botLikelihood","flags"],"properties":{"flags":{"type":"array","items":{"type":"string"},"description":"Transparent evidence behind the signal"},"botLikelihood":{"enum":["low","medium","high","unknown"],"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"profile":{"id":"745273","bio":"Deploy capital and code.","url":"https://x.com/naval","name":"Naval","handle":"naval","location":null,"verified":{"blue":true,"type":null},"createdAt":"2007-02-01T05:44:27.000Z","followers":2900000,"following":1200,"tweetCount":42000,"profileImage":"https://pbs.twimg.com/profile_images/example.jpg","accountAgeDays":7106},"activity":{"avgLikes":4200,"spanDays":14.2,"avgReplies":180,"replyShare":0.15,"sampleSize":20,"avgRetweets":610,"postsPerDay":1.41,"topHashtags":[{"tag":"startups","count":3}],"topMentions":[{"count":2,"handle":"paulg"}],"retweetShare":0.05,"withLinksShare":0.2},"authenticity":{"flags":["no automation signals in profile or recent activity"],"botLikelihood":"low"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.75","successRate":"1.00","reviews":1,"stars":"4.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"5.0000","medianCents":"5.0000","p90Cents":"5.0000","minCents":"5.0000","maxCents":"5.0000","p95Cents":"5.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ULXzPtByo6qLkm0cbqMJ8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a full profile, activity analysis, and bot-likelihood signal for any X (Twitter) account in a single call","exampleAgentPrompt":"Pull a full dossier on @elonmusk — I want their profile, posting cadence, top hashtags, and especially the bot-likelihood score with evidence. Use the last 20 posts.","exampleUseCases":null,"resultDescription":"Returns a structured JSON object with three top-level sections: (1) profile — handle, id, name, bio, URL, location, profile image, verification status, followers, following, tweet count, and account creation date; (2) activity — posting cadence, average engagement metrics, reply/retweet/link-share ratios, top hashtags, top mentions, and the raw recent posts sampled; (3) authenticity — a bot-likelihood signal with the specific evidence factors that contributed to it. No X API key or X account is required by the caller.","failureModes":["Handle not found or account suspended — returns a 4xx error with descriptive message","Handle format invalid (too long, bad characters) — rejected by schema validation before call","sampleSize exceeds maximum of 20 — rejected by schema validation","Payment of $0.02 USDC not provided or rejected — 402 Payment Required response","X platform rate limiting or downtime — 5xx error propagated from upstream","Private/protected account with no accessible tweets — partial data returned or error"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, one-shot account intelligence report on an X user — combining profile data, behavioral activity metrics, and a bot-likelihood verdict — without needing to hold an X API key. It is superior to raw tweet search or profile-only lookups when the goal is account vetting, influencer due diligence, or fraud/bot detection, because it composes multiple signals into a single transparent report.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-08-06T06:09:08.526Z","lastSuccessfullyRanAt":"2026-08-06T06:09:08.526Z","lastHealthCheckAt":"2026-10-23T18:32:30.648Z","isFirstParty":false,"canonicalSlug":"x-account-dossier-414bc7f0"}