# X (Twitter)

18 endpoints on X (Twitter). Every one returns the same response shape and has a flat, published price in credits.

Category: [Social networks](https://onekey.dev/docs/categories/social.md) · [Overview page](https://onekey.dev/platforms/x)

> [!NOTE] **17 of 18 endpoints are marked "needs a pack" or "may need a pack"** in the table: free credits reach only the open fetch path; a verified email and a purchased pack unlock the rest. See [pricing](https://onekey.dev/pricing).

## Endpoints

| Endpoint | What it does | Cost | Status |
| --- | --- | --- | --- |
| [`ai_search`](https://onekey.dev/docs/api/x/ai_search.md) | AI-assisted search across X posts, returning matching posts. | 3 credits | beta **needs a pack** |
| [`community`](https://onekey.dev/docs/api/x/community.md) | Get X community details. | 2 credits | beta **needs a pack** |
| [`community_tweets`](https://onekey.dev/docs/api/x/community_tweets.md) | List X community tweets. | 2 credits | beta **needs a pack** |
| [`followers`](https://onekey.dev/docs/api/x/followers.md) | Followers of an X user (first page). | 2 credits | stable **may need a pack** |
| [`following`](https://onekey.dev/docs/api/x/following.md) | Accounts followed by an X user (first page). | 5 credits | beta **needs a pack** |
| [`oembed`](https://onekey.dev/docs/api/x/oembed.md) | oEmbed for a public tweet: author, embed text and date (official publish.twitter.com). | 1 credit | stable |
| [`profile`](https://onekey.dev/docs/api/x/profile.md) | Fetch an X (Twitter) user's public profile. | 2 credits | beta **may need a pack** |
| [`profile_full`](https://onekey.dev/docs/api/x/profile_full.md) | X (X) profile, recent posts, and computed analytics in one call. | 2 credits | beta **needs a pack** |
| [`retweeters`](https://onekey.dev/docs/api/x/retweeters.md) | Accounts that retweeted a tweet (first page). | 3 credits | beta **needs a pack** |
| [`search`](https://onekey.dev/docs/api/x/search.md) | Search recent tweets by keyword or hashtag. | 2 credits | stable **may need a pack** |
| [`search_users`](https://onekey.dev/docs/api/x/search_users.md) | Search X users. | 2 credits | beta **needs a pack** |
| [`status`](https://onekey.dev/docs/api/x/status.md) | A tweet with full engagement counts (likes, replies, reposts, bookmarks, quotes, views). | 1 credit | stable **may need a pack** |
| [`thread`](https://onekey.dev/docs/api/x/thread.md) | The conversation thread around a tweet (author's self-thread / replies chain). | 2 credits | stable **may need a pack** |
| [`tweet`](https://onekey.dev/docs/api/x/tweet.md) | A single public tweet via X syndication: text, author, likes, reply count, date. | 1 credit | stable **may need a pack** |
| [`tweet_transcript`](https://onekey.dev/docs/api/x/tweet_transcript.md) | Get X video transcript. | 2 credits | beta **needs a pack** |
| [`user`](https://onekey.dev/docs/api/x/user.md) | Public profile for an X handle: followers, following, bio, avatar. | 1 credit | stable **may need a pack** |
| [`user_media`](https://onekey.dev/docs/api/x/user_media.md) | List X user media tweets. | 2 credits | beta **needs a pack** |
| [`user_tweets`](https://onekey.dev/docs/api/x/user_tweets.md) | Recent tweets posted by an X user. | 2 credits | stable **may need a pack** |

Every endpoint page has a **Field mapping** section showing which source field becomes which [unified field](https://onekey.dev/docs/schema.md) (fixed schema) or platform-specific `ext.` field.