# X Account Dossier > X Account Dossier is a paid API for AI agents from x402.botsmith.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-23, last successful call 2026-08-06). Returns a full profile, activity analysis, and bot-likelihood signal for any X (Twitter) account in a single call ## Facts - Endpoint: GET https://x402.botsmith.dev/x/dossier?utm_source=zero.xyz - Price: $0.05/call - Payment: x402 - Status: unknown - Last checked: 2026-10-23 - Last successful call: 2026-08-06 - Success rate: 100% of calls made through Zero - Rating: 4.0 / 5 from 1 review - Activations on Zero: 1 - Tags: x402 - Canonical page: https://www.zero.xyz/c/x-account-dossier-414bc7f0 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L-n8lVWZGywedYFWP1typ Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability x-account-dossier-414bc7f0 ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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", "requ … (truncated) ``` ## Response schema (JSON Schema) ```json { "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" } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x-account-dossier-414bc7f0/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402.botsmith.dev](https://www.zero.xyz/host/x402.botsmith.dev/llms.txt)