Get an X profile
x_get_profileFetch one X account's profile: name, bio, location, website, follower/following counts, tweet and media counts, verification state, and join date. identifier accepts a screen name without the @ (e.g. 'nasa'), a full x.com or twitter.com profile URL, or the numeric account id; numeric strings are treated as ids, and the rare all-digit handle can be forced with by='screen_name'. Costs 4 credits. The returned platform_fields.id is stable across handle changes; store it for repeat lookups. To find accounts by topic use x_search type=people, and to read what an account posts use x_get_tweets; this tool returns no tweets.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by | No | Force how identifier is interpreted; auto-detected when omitted. | |
| freshness | No | recent (default) serves cached data from the last few hours when available; realtime forces a live fetch for +2 credits (refunded if we fall back to cached data). Trial keys are cached-only and reject realtime with TRIAL_CAP_EXCEEDED; paying upgrades this same key to unlock it. | recent |
| identifier | Yes | Screen name without the @ (e.g. 'nasa'), profile URL, or numeric account id. | |
| max_credits | No | Spend ceiling for this one call. The call is rejected (nothing charged) if its quote exceeds this. Only the quote is ever reserved, never this ceiling. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| usage | Yes | ||
| common | Yes | ||
| entity | Yes | ||
| platform | Yes | ||
| freshness | Yes | ||
| data_as_of | Yes | ||
| canonical_url | Yes | ||
| schema_version | Yes | ||
| platform_fields | Yes |