Important
Maintained fork of d60/twikit with 2026 patches.
This fork is a drop-in replacement for d60/twikit. It includes patches
for issues that have broken upstream since X (formerly Twitter) changed
their internal API shape, and that upstream has not merged (maintainer
@d60 has not responded to PRs since Feb 2025).
Install (drop-in):
pip install git+https://github.com/unclecode/twikit.git
What's patched (see CHANGES.md for full diff history):
- 2026-03-18 webpack format: fixes
Couldn't get KEY_BYTE indices raised by
ClientTransaction after X split their JS chunk metadata into separate
name/hash maps. Two-step regex lookup mirrors upstream
iSarabjitDhiman/XClientTransaction v1.0.2.
Closes upstream issues d60/twikit #408, #409 and supersedes the four open
unmerged upstream PRs #410, #411, #416, #407.
- User payload schema tolerance:
twikit/user.py now uses .get() with
safe defaults across all legacy dict fields. X has been silently dropping
fields (withheld_in_countries, entities.description.urls,
fast_followers_count, etc.) for some payloads, killing entire timeline
fetches with KeyError.
Maintenance cadence: X rotates the JS chunk format and the GraphQL hash
map every 2-4 weeks. When a break is detected, the fix is usually a 15-30 min
patch following the same pattern. A smoke test runs daily in CI and the
repo's Issues tab is the place to report breakage.
All credit for the original library to @d60 and
to the upstream PR contributors whose work informed these patches.

[日本語]
[中文]
Twikit 
A Simple Twitter API Scraper
You can use functions such as posting or searching for tweets without an API key using this library.
🔵 Discord
Features
No API Key Required
This library uses scraping and does not require an API key.
Free
This library is free to use.
Functionality
By using Twikit, you can access functionalities such as the following:
-
Create tweets
-
Search tweets
-
Retrieve trending topics
-
etc...
Installing
Quick Example
Define a client and log in to the account.
import asyncio
from twikit import Client
USERNAME = 'example_user'
EMAIL = 'email@example.com'
PASSWORD = 'password0000'
# Initialize client
client = Client('en-US')
async def main():
await client.login(
auth_info_1=USERNAME,
auth_info_2=EMAIL,
password=PASSWORD,
cookies_file='cookies.json'
)
asyncio.run(main())
Create a tweet with media attached.
# Upload media files and obtain media_ids
media_ids = [
await client.upload_media('media1.jpg'),
await client.upload_media('media2.jpg')
]
# Create a tweet with the provided text and attached media
await client.create_tweet(
text='Example Tweet',
media_ids=media_ids
)
Search the latest tweets based on a keyword
tweets = await client.search_tweet('python', 'Latest')
for tweet in tweets:
print(
tweet.user.name,
tweet.text,
tweet.created_at
)
Retrieve user tweets
tweets = await client.get_user_tweets('123456', 'Tweets')
for tweet in tweets:
print(tweet.text)
Send a dm
await client.send_dm('123456789', 'Hello')
Get trends
await client.get_trends('trending')
More Examples: examples
Contributing
If you encounter any bugs or issues, please report them on issues.
If you find this library useful, consider starring this repository⭐️