twiapi 1.0.0

Unofficial Twitter/X data API client — search tweets, get followers, trends, user profiles.

中文文档

TwiAPI – Unofficial Twitter/X Data API & Python SDK

Get structured Twitter/X data in 3 lines of code. No developer application, no waiting.

TwiAPI is a Python SDK + third‑party Twitter/X data service that gives you instant access to tweets, user profiles, followers, trends, and more – without the official API's approval delays or rate limits. It returns clean, structured JSON so you can start building immediately.

Your App  ──►  TwiAPI  ──►  Clean JSON
             (we handle auth, scraping, parsing)

Works with any language – Python SDK, or call the REST API directly from Node.js, cURL, Go, Java, etc.

📖 Full docs: twiapi.net/docs

---

Why TwiAPI?

	Official Twitter API	TwiAPI
Developer application	Required (days/weeks)	None – get a key instantly
Data format	Nested, needs cleaning	Structured JSON, ready to use
Rate limits	Strict, per-endpoint	Flexible per plan
Pricing (monthly)	$100+ (Basic) / $5,000+ (Pro)	Starting at $7
Endpoints	Plan-restricted	All 14 available on every plan

---

Quick Start

1. Install

pip install twiapi

2. Try it now — no API key needed (Demo Mode)

from twiapi import TwiAPI

api = TwiAPI(demo=True)          # ← returns realistic sample data
user = api.get_user("elonmusk")  # Get any user's profile & follower count
print(user["display_name"], user["followers_count"])
# Output: Elon Musk 195000000

Demo mode returns realistic sample data for all 14 methods — user profiles, tweets, followers, trends, etc. No signup, no API key, no network requests.

3. Go live with a real key

Get your key — contact us on Telegram or visit twiapi.net:

api = TwiAPI("YOUR_API_KEY")     # ← swap demo=True for your real key
user = api.get_user("elonmusk")
print(user["display_name"], user["followers_count"])

Using the REST API directly (Node.js, cURL, Go, etc.):

# cURL
curl -G "https://twiapi.net/api/user/info" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=elonmusk"

// Node.js
const resp = await fetch(
  "https://twiapi.net/api/user/info?username=elonmusk",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await resp.json();

Response:

{
  "user_id": "44196397",
  "username": "elonmusk",
  "display_name": "Elon Musk",
  "followers_count": 195000000,
  "following_count": 800,
  "is_blue_verified": true,
  "bio": "...",
  "avatar_url": "..."
}

---

SDK Methods

The Python SDK (pip install twiapi) provides simple methods for all 14 endpoints:

Category	Method	Returns
Users	api.get_user(username)	Profile, follower count, verification status
	api.search_users(keyword, count?, cursor?)	Users matching keyword
	api.get_user_tweets(username, type?, count?, cursor?)	User's tweets, replies, or likes
	api.get_followers(username, count?, cursor?)	Follower list with pagination
	api.get_blue_verified_followers(username, count?, cursor?)	Only blue-verified followers
	api.get_following(username, count?, cursor?)	Accounts a user follows
Tweets	api.search_tweets(keyword, product?, count?, cursor?)	Search tweets (Top/Latest/Media)
	api.get_tweet(tweet_id)	Full tweet + author + media
	api.get_tweets_batch(tweet_ids)	Up to 20 tweets at once
	api.get_comments(tweet_id, count?, cursor?)	Replies under a tweet
	api.get_retweeters(tweet_id, count?, cursor?)	Who retweeted
	api.get_likers(tweet_id, count?, cursor?)	Who liked
Other	api.get_trends()	Current trending topics
	api.get_list_tweets(list_id, count?, cursor?)	Tweets from a Twitter List

All methods support demo mode — pass demo=True to the constructor to get sample data without an API key.

---

All 14 Endpoints (REST API)

Cost = the number of requests deducted from your monthly quota per call.

Category	Endpoint	Path	Cost	Description
Users	User Info	GET /api/user/info	1	Profile, follower count, verification status
	User Search	GET /api/user/search	1	Find users by keyword
	User Tweets	GET /api/user/tweets	1	User's tweets, replies, or likes
	Followers	GET /api/user/followers	3	Follower list with pagination
	Blue Verified Followers	GET /api/user/blue_verified_followers	3	Only blue-verified followers
	Following	GET /api/user/following	3	Accounts a user follows
Tweets	Tweet Search	GET /api/tweet/search	2	Search tweets by keyword (Top/Latest/Media)
	Tweet Detail	GET /api/tweet/detail	1	Full tweet + author + media + engagement
	Tweet Batch	GET /api/tweet/batch	5~20	Up to 20 tweets in one call
	Comments	GET /api/tweet/comments	3	Replies under a tweet
	Retweeters	GET /api/tweet/retweeters	2	Who retweeted a tweet
	Likers	GET /api/tweet/favoriters	2	Who liked a tweet
Other	Trends	GET /api/trends	1	Current trending topics
	List Tweets	GET /api/list/tweets	2	Tweets from a Twitter List

All list endpoints support cursor-based pagination. See full API reference.

---

Code Examples

Ready-to-run Python scripts in the examples/ directory:

File	What it demonstrates
examples/sdk_demo.py	SDK demo — all 14 methods, no API key needed
examples/search_tweets.py	Search tweets and filter by type
examples/get_user_info.py	Fetch any user's profile
examples/get_followers.py	Paginated follower retrieval
examples/get_blue_verified_followers.py	Filter only verified followers
examples/get_tweet_detail.py	Single tweet with full details
examples/batch_tweets.py	Retrieve multiple tweets in one call
examples/get_trends.py	Current trending topics

Run any example:

pip install twiapi
python examples/search_tweets.py

---

Authentication

All live requests require a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

The SDK handles this automatically. Get your key at twiapi.net. Free trials available.

---

Response Format

All endpoints return structured JSON with consistent fields:

• User objects: user_id, username, display_name, followers_count, following_count, tweets_count, is_blue_verified, avatar_url, bio
• Tweet objects: tweet_id, text, created_at, user, reply_count, retweet_count, favorite_count, view_count, bookmark_count, hashtags, urls, media
• List endpoints: cursor-based pagination via next_cursor

No cleaning needed – the data is ready to store or analyze directly.

---

How It Works

TwiAPI uses a proprietary data pipeline that aggregates publicly available Twitter/X information. We handle session management, IP rotation, and endpoint monitoring behind the scenes so you don't have to maintain any scraping infrastructure.

No official developer account or approval is required on your end. The service is production‑ready.

Please use the service responsibly and in compliance with applicable laws and platform terms of service.

---

Pricing

Flexible plans starting at $7/month. Free trials are available. All plans include access to all 14 endpoints.

See full pricing at twiapi.net/#pricing.

---

Support & Resources

• Full API docs: twiapi.net/docs
• MCP integration (for AI agents like Claude, Cursor, ChatGPT): twiapi.net/mcp-access
• Telegram support: @alex11323 — 7×24 online
• Website: twiapi.net
• Bug reports: GitHub Issues

---

Keywords

twitter api twitter api python twitter api alternative twitter scraper twitter data api twitter api wrapper x api tweet search api twitter followers api twitter user info api scrape tweets twitter scraping get twitter data twitter api free twitter api cheap social media api osint twitter python twitter twitter unofficial api twitter api without developer account

---

⭐ Star this repo if you find it useful!

License

Released under the MIT License.