# GetXAPI - Complete Reference

> GetXAPI offers the lowest published standard-read price among the Twitter/X API providers in our comparison: $0.001 per standard call, or about $0.05 per 1,000 tweets on typical 20-result calls. Pay-per-call access requires no subscription; optional plans are available.

## What is GetXAPI?

GetXAPI is a third-party Twitter/X data API designed for developers, researchers, and businesses who need access to Twitter data without the complexity and cost of the official X API. It provides a simple REST API with pay-per-call pricing at $0.001 per request (~20 tweets per call), making it just $0.05 per 1,000 tweets.

Key advantages:
- No official X developer account required
- No required monthly subscription or locked tiers
- Pay only for what you use
- Each call returns ~20 tweets, so $0.05 per 1,000 tweets
- $0.10 signup credits (no credit card)
- Response time under 2 seconds
- 99.9% uptime
- No endpoint-specific quota (general service throttling still applies)

## Pricing

GetXAPI has 73 endpoints total: 62 usage-priced endpoints, 2 free account endpoints, and 9 real-time monitoring endpoints included with a Monitoring plan.

### Standard Endpoints ($0.001 per call, ~20 tweets per call)
These include most tweet, user, search, and list endpoints:
- GET /twitter/tweet/advanced_search
- GET /twitter/tweet/detail
- GET /twitter/tweet/replies
- GET /twitter/tweet/retweeters
- POST /twitter/tweet/favorite
- POST /twitter/tweet/retweet
- POST /twitter/tweet/bookmark
- POST /twitter/tweet/unbookmark
- POST /twitter/tweet/delete
- GET /twitter/article/get
- GET /twitter/user/search
- GET /twitter/user/status
- GET /twitter/community/info
- GET /twitter/user/info
- GET /twitter/user/info_by_id
- GET /twitter/user/user_about
- GET /twitter/user/followers
- GET /twitter/user/followers_v2
- GET /twitter/user/following
- GET /twitter/user/following_v2
- GET /twitter/user/verified_followers
- GET /twitter/user/media
- GET /twitter/user/tweets
- GET /twitter/user/tweets_and_replies
- GET /twitter/user/mentions
- POST /twitter/user/likes
- POST /twitter/user/home_timeline
- POST /twitter/user/bookmarks
- POST /twitter/user/bookmark_search
- POST /twitter/user/followers_you_know
- GET /twitter/user/check_follow_relationship
- GET /twitter/user/affiliates
- POST /twitter/user/follow
- POST /twitter/user/unfollow
- POST /twitter/user/update_avatar
- POST /twitter/user/update_banner
- POST /twitter/user/update_profile
- POST /twitter/media/upload
- GET /twitter/list/members
- GET /twitter/trends
- GET /twitter/trends/locations

### DM + Create Tweet + Join Community + Notifications ($0.002 per call)
- POST /twitter/tweet/create, supports text, media, quote tweets, proxy
- POST /twitter/tweet/edit, edit an existing post (X Premium, within ~1h, original posts only)
- POST /twitter/dm/list
- POST /twitter/dm/send
- POST /twitter/community/join, join an X community by its numeric community_id
- POST /twitter/notifications, the auth_token account's own notifications timeline across All / Mentions / Verified tabs

### User Tweets Complete ($0.003 per call)
- GET /twitter/user/tweets/complete, recent tweets-and-replies timeline with self-thread expansion

### User Login ($0.01 per call)
- POST /twitter/user_login, get fresh auth tokens for a Twitter account (required for write endpoints)

### Account Recovery ($0.005 per call)
- POST /twitter/user_login_v2, recover a dead/changed-password account via the mailbox (GMX/mail.com, Hotmail/Outlook; not Gmail/Yahoo); returns fresh tokens + new_password
- POST /twitter/reset-password/send-code, two-step recovery step 1: trigger the reset email, returns a session_id
- POST /twitter/reset-password/confirm, two-step recovery step 2: owner supplies the code -> fresh tokens + new_password; works for any mailbox, resumable 2FA

### DM Conversation ($0.001 per call)
- POST /twitter/dm/conversation, full message history of one conversation

### Article Endpoints ($0.005 per call, $0.01 for Create Article)
- POST /twitter/article/create ($0.01; publishing needs X Premium)
- POST /twitter/article/update
- POST /twitter/article/list
- POST /twitter/article/publish (needs X Premium)
- POST /twitter/article/unpublish
- POST /twitter/article/delete

### Spaces (pay-per-use add-on, billed from credits)
- GET /twitter/spaces/info ($0.001), Space metadata (title, host, state, listener counts)
- POST /twitter/spaces/download ($0.05 base + $0.015/transcript min), queue an async MP3 download, optional transcript; returns a job_id
- GET /twitter/spaces/download/{job_id} (free), poll the job; returns signed download URLs when done

### Free Account Endpoints ($0 per call)
- GET /account/me
- GET /account/payments

### Cost Examples
Typical standard search and list calls return about 20 tweets, so their effective estimate is $0.05 per 1,000 tweets:
- 1,000 API calls = $1 (~20,000 tweets)
- 10,000 API calls = $10 (~200,000 tweets)
- 100,000 API calls = $100 (~2,000,000 tweets)

## Pricing Comparison vs Competitors

### vs Official X API (Pay-Per-Use)
- Official X reads: $0.005 to $0.010 per returned resource; one request returning 20 Posts bills 20 resources
- Official X standard Post create: $0.015 per request; Post create with a URL: $0.20; the complete write table ranges from $0.005 to $0.20
- GetXAPI: $0.001 per standard call (about 20 tweets), so about $0.05 per 1,000 tweets versus $5 for 1,000 official standard Post reads

### vs twitterapi.io
- twitterapi.io: $0.15 per 1,000 tweets (~20 tweets per call)
- GetXAPI: $0.05 per 1,000 tweets (~20 tweets per call), 3x cheaper

### vs Other Third-Party APIs
- Competitor prices and terms vary and should be checked on their current official pages
- GetXAPI is pay per call by default with optional plans

### Optional GetXAPI Plans
- Starter: $5 one-time, 4.5 plan credits, valid 30 days, once per account
- Pro: $15/month, 30 plan credits, plus 10 bonus credits with crypto
- Growth: $49/month, 120 plan credits, plus 20 bonus credits with crypto
- Scale: $99/month, 300 plan credits, plus 50 bonus credits with crypto
- Purchased top-up credits start at $10 and do not expire; plan-credit expiry follows the plan terms

## API Endpoints - Detailed

### Tweet Endpoints

**Advanced Search**
- Endpoint: GET /twitter/tweet/advanced_search
- Search tweets with filters, operators, date ranges
- Price: $0.001/call

**Tweet Detail**
- Endpoint: GET /twitter/tweet/detail
- Get full tweet data including engagement metrics
- Price: $0.001/call

**Tweet Replies**
- Endpoint: GET /twitter/tweet/replies
- Get conversation replies to a specific tweet
- Price: $0.001/call

**Tweet Retweeters**
- Endpoint: GET /twitter/tweet/retweeters
- Get the list of users who reposted (retweeted) a tweet (~20 users/page)
- Price: $0.001/call

**Tweet Thread**
- Endpoint: GET /twitter/tweet/thread
- Resolve a full linear self-thread from any tweet in it (walks the original author's linked replies)
- Price: $0.005/call

**Create Tweet**
- Endpoint: POST /twitter/tweet/create
- Post a new tweet with text, images, videos, quote tweets. Supports proxy for using your own IP.
- Price: $0.002/call

**Edit Tweet**
- Endpoint: POST /twitter/tweet/edit
- Edit an existing post's text/media (X Premium, within ~1h, original posts only). Each edit creates a new tweet id.
- Price: $0.002/call

**Favorite Tweet**
- Endpoint: POST /twitter/tweet/favorite
- Like a tweet
- Price: $0.001/call

**Retweet Tweet**
- Endpoint: POST /twitter/tweet/retweet
- Retweet a tweet
- Price: $0.001/call

**Bookmark Tweet**
- Endpoint: POST /twitter/tweet/bookmark
- Bookmark a tweet
- Price: $0.001/call

**Unbookmark Tweet**
- Endpoint: POST /twitter/tweet/unbookmark
- Remove a tweet from bookmarks
- Price: $0.001/call

**Delete Tweet**
- Endpoint: POST /twitter/tweet/delete
- Delete a tweet owned by the auth_token's account
- Price: $0.001/call

### Article Endpoints

**Get Article**
- Endpoint: GET /twitter/article/get
- Fetch full article/note content by wrapper tweet ID, or by article entity ID (owner-only)
- Price: $0.001/call

**Create Article**
- Endpoint: POST /twitter/article/create
- Create (and optionally publish) a long-form article in one call. Publishing requires X Premium.
- Price: $0.01/call

**Update Article**
- Endpoint: POST /twitter/article/update
- Partial-update an existing article (title, body markdown, or cover)
- Price: $0.005/call

**List Articles**
- Endpoint: POST /twitter/article/list
- List the auth_token user's own articles (drafts or published)
- Price: $0.005/call

**Publish Article**
- Endpoint: POST /twitter/article/publish
- Publish an existing draft article. Requires X Premium.
- Price: $0.005/call

**Unpublish Article**
- Endpoint: POST /twitter/article/unpublish
- Move a published article back to draft
- Price: $0.005/call

**Delete Article**
- Endpoint: POST /twitter/article/delete
- Delete an article entity (draft or published)
- Price: $0.005/call

### User Endpoints

**User Search**
- Endpoint: GET /twitter/user/search
- Search for users by keyword, username, or topic (~20 users/page)
- Price: $0.001/call

**User Status**
- Endpoint: GET /twitter/user/status
- Reliable account-state check: returns alive / suspended / not_found (+ id, reason) as 200 data, not an error (unlike user/info)
- Price: $0.001/call

**User Info**
- Endpoint: GET /twitter/user/info
- Get user profile data by username
- Price: $0.001/call

**User Info by ID**
- Endpoint: GET /twitter/user/info_by_id
- Get user profile data by numeric Twitter ID
- Price: $0.001/call

**User About**
- Endpoint: GET /twitter/user/user_about
- Get extended user details and account metadata
- Price: $0.001/call

**Followers**
- Endpoint: GET /twitter/user/followers
- Get paginated list of a user's followers (REST, up to 200/page)
- Price: $0.001/call

**Followers v2**
- Endpoint: GET /twitter/user/followers_v2
- Get paginated list of a user's followers (GraphQL, ~70/page, includes canDm)
- Price: $0.001/call

**Following**
- Endpoint: GET /twitter/user/following
- Get paginated list of accounts a user follows (REST, up to 200/page)
- Price: $0.001/call

**Following v2**
- Endpoint: GET /twitter/user/following_v2
- Get paginated list of accounts a user follows (GraphQL, ~70/page, includes canDm)
- Price: $0.001/call

**Verified Followers**
- Endpoint: GET /twitter/user/verified_followers
- Get only verified/premium followers of a user
- Price: $0.001/call

**User Media**
- Endpoint: GET /twitter/user/media
- Get a user's media posts (images, videos)
- Price: $0.001/call

**User Tweets**
- Endpoint: GET /twitter/user/tweets
- Get a user's tweet timeline
- Price: $0.001/call

**User Tweets and Replies**
- Endpoint: GET /twitter/user/tweets_and_replies
- Get tweets including replies
- Price: $0.001/call

**User Tweets Complete**
- Endpoint: GET /twitter/user/tweets/complete
- Recent tweets-and-replies timeline with self-thread expansion (not the full historical archive). 40 raw items per page before expansion.
- Price: $0.003/call

**User Mentions**
- Endpoint: GET /twitter/user/mentions
- Get tweets mentioning a user
- Price: $0.001/call

**User Likes**
- Endpoint: POST /twitter/user/likes
- Get tweets liked by a user
- Price: $0.001/call

**Home Timeline**
- Endpoint: POST /twitter/user/home_timeline
- Get home timeline for an authenticated user. Defaults to the For You feed; pass following: true for the Following feed (only accounts the user follows)
- Price: $0.001/call

**Bookmarks**
- Endpoint: POST /twitter/user/bookmarks
- List all of the authenticated user's bookmarks
- Price: $0.001/call

**Bookmark Search**
- Endpoint: POST /twitter/user/bookmark_search
- Search within bookmarked tweets
- Price: $0.001/call

**Followers You Know**
- Endpoint: POST /twitter/user/followers_you_know
- Get mutual followers between accounts
- Price: $0.001/call

**Check Follow Relationship**
- Endpoint: GET /twitter/user/check_follow_relationship
- Check if one user follows another
- Price: $0.001/call

**User Affiliates**
- Endpoint: GET /twitter/user/affiliates
- Get affiliated accounts of a verified organization (companies, brands, nonprofits)
- Returns ~20 users per page with cursor pagination
- Price: $0.001/call

**Follow User**
- Endpoint: POST /twitter/user/follow
- Follow a user (target by user_id or username)
- Price: $0.001/call

**Unfollow User**
- Endpoint: POST /twitter/user/unfollow
- Unfollow a user (target by user_id or username)
- Price: $0.001/call

**Update Avatar**
- Endpoint: POST /twitter/user/update_avatar
- Update the authenticated user's profile picture
- Price: $0.001/call

**Update Banner**
- Endpoint: POST /twitter/user/update_banner
- Update the authenticated user's profile banner
- Price: $0.001/call

**Update Profile**
- Endpoint: POST /twitter/user/update_profile
- Update profile fields (name, bio, location, URL, color, birthdate)
- Price: $0.001/call

**User Login**
- Endpoint: POST /twitter/user_login
- Get fresh auth tokens for a Twitter account (required for write endpoints)
- Price: $0.01/call

### Account Recovery Endpoints

**User Login V2 (Recovery)**
- Endpoint: POST /twitter/user_login_v2
- Recover an account whose auth_token is dead and password was changed, via the mailbox. Supported: GMX/mail.com, Hotmail/Outlook/Live (Gmail and Yahoo not supported). Needs email + mail_pw; returns fresh tokens + a new_password.
- Price: $0.005/call

**Reset Password Send Code**
- Endpoint: POST /twitter/reset-password/send-code
- Two-step recovery, step 1. Triggers X's password-reset email and returns a session_id (valid ~15 min).
- Price: $0.005/call

**Reset Password Confirm**
- Endpoint: POST /twitter/reset-password/confirm
- Two-step recovery, step 2. The account owner supplies the emailed code; returns fresh tokens + new_password. Works for any mailbox; resumable 2FA.
- Price: $0.005/call

### List Endpoints

**List Members**
- Endpoint: GET /twitter/list/members
- Get members of a Twitter list
- Price: $0.001/call

### DM Endpoints

**DM List**
- Endpoint: POST /twitter/dm/list
- Retrieve direct message conversations (full inbox)
- Price: $0.002/call

**DM Send**
- Endpoint: POST /twitter/dm/send
- Send a direct message
- Price: $0.002/call

**DM Conversation**
- Endpoint: POST /twitter/dm/conversation
- Fetch the full message history of one DM conversation
- Price: $0.001/call

### Media Endpoints

**Upload Media**
- Endpoint: POST /twitter/media/upload
- Upload an image, GIF, or video and get a media_id to attach to a tweet
- Price: $0.001/call

### Community Endpoints

**Community Info**
- Endpoint: GET /twitter/community/info
- Full community details by numeric communityId: name, description, banner, member/moderator counts, created date, join policy, rules, admin/creator, topic, tags
- Price: $0.001/call

**Join Community**
- Endpoint: POST /twitter/community/join
- Join an X community by its numeric community_id (approval-gated communities return a pending state)
- Price: $0.002/call

### Notifications Endpoints

**Notifications**
- Endpoint: POST /twitter/notifications
- The auth_token account's own notifications timeline (replies, mentions, likes, retweets, follows) across the All / Mentions / Verified tabs. Body: auth_token + optional tab (all/mentions/verified), cursor, count (1-40). Page with next_cursor.
- Price: $0.002/call

### Spaces Endpoints

**Space Info**
- Endpoint: GET /twitter/spaces/info
- Fetch X Space metadata: title, host, state, listener counts, and whether it can be downloaded
- Price: $0.001/call

**Download Space**
- Endpoint: POST /twitter/spaces/download
- Queue an async MP3 download of a Space, with an optional timestamped transcript. Returns a job_id; poll GET /twitter/spaces/download/{job_id} for signed download URLs. Files hosted 7 days.
- Price: $0.05 base + $0.015 per transcript minute (pay-per-use add-on billed from credits)

### Trends Endpoints

**Get Trends**
- Endpoint: GET /twitter/trends
- Fetch the current top X trends for a country or city (up to 50), ranked by X. Pass country (name or ISO code) or a numeric woeid; defaults to worldwide. Each trend has a search_url/query to pull tweets via advanced_search.
- Price: $0.001/call

**Trend Locations**
- Endpoint: GET /twitter/trends/locations
- List every location (with WOEIDs) X offers trends for
- Price: $0.001/call

### Account Endpoints

**Account Info**
- Endpoint: GET /account/me
- Credit balance, usage summary, account details
- Price: free

**Payment History**
- Endpoint: GET /account/payments
- Payment / top-up history
- Price: free

## Authentication

All API requests require an API key passed in the `Authorization` header:
```
Authorization: Bearer YOUR_API_KEY
```

Base URL: https://api.getxapi.com

## Getting Started

1. Sign up at https://www.getxapi.com/signup (instant, no approval wait)
2. Receive your API key and $0.10 signup credits
3. Make requests to https://api.getxapi.com with `Authorization: Bearer YOUR_API_KEY` header
4. Read full docs at https://docs.getxapi.com

## Use Cases

- Social media analytics and monitoring
- Brand sentiment analysis
- Influencer discovery and research
- Academic and social research
- Content aggregation
- Competitive intelligence
- Automated engagement tracking
- Market trend analysis

## Links

- [Website](https://www.getxapi.com): product overview, endpoint list and live pricing
- [API Documentation](https://docs.getxapi.com): quickstart plus curl, JavaScript and Python examples for every endpoint
- [Pricing](https://www.getxapi.com/pricing): per-call prices, plan credits and top-up options
- [Pricing Comparison](https://www.getxapi.com/twitter-api-pricing): current official X API prices next to GetXAPI per-call pricing
- [API Alternatives](https://www.getxapi.com/twitter-api-alternatives): side-by-side comparison of Twitter/X API providers
- [Rate Limits](https://www.getxapi.com/twitter-api-rate-limits): official X API limits per tier and how GetXAPI differs
- [Cost Calculator](https://www.getxapi.com/twitter-api-cost-calculator): estimate monthly cost from a tweet or call volume
- [Free API Options](https://www.getxapi.com/twitter-free-api): what the free X API tier allows and where it stops
- [Unofficial API Guide](https://www.getxapi.com/twitter-unofficial-api): how unofficial Twitter/X endpoints work and their tradeoffs
- [Sign Up](https://www.getxapi.com/signup): create an account and get an API key with $0.10 in credits
- [Contact](https://www.getxapi.com/contact): support and sales enquiries