Client

from twikit import Client

client = Client(
    language='en-US',
    proxy='http://proxy.example.com:8080',  # optional
    captcha_solver=capsolver,  # optional
    user_agent='custom user agent'  # optional
)

await client.login(
    auth_info_1='example_user',
    auth_info_2='[email protected]',
    password='your_password'
)

await client.logout()

await client.unlock()

cookies = client.get_cookies()

client.save_cookies('cookies.json')

client.load_cookies('cookies.json')

client.set_cookies(cookies_dict, clear_cookies=False)

user_id = await client.user_id()

user = await client.user()

user = await client.get_user_by_screen_name('elonmusk')
print(user.name)
print(user.followers_count)

user = await client.get_user_by_id('44196397')

user = await client.follow_user('123456789')

user = await client.unfollow_user('123456789')

user = await client.block_user('123456789')

user = await client.unblock_user('123456789')

user = await client.mute_user('123456789')

user = await client.unmute_user('123456789')

tweets = await client.get_user_tweets(
    user_id='44196397',
    tweet_type='Tweets',
    count=20
)

for tweet in tweets:
    print(tweet.text)

# Get more tweets
more_tweets = await tweets.next()

tweets = await client.get_user_highlights_tweets('123456789', count=20)

followers = await client.get_user_followers('123456789', count=20)

for follower in followers:
    print(follower.screen_name)

more_followers = await followers.next()

verified_followers = await client.get_user_verified_followers('123456789', count=20)

common_followers = await client.get_user_followers_you_know('123456789', count=20)

following = await client.get_user_following('123456789', count=20)

subscriptions = await client.get_user_subscriptions('123456789', count=20)

followers = await client.get_latest_followers(
    user_id='123456789',
    count=200
)

friends = await client.get_latest_friends(
    user_id='123456789',
    count=200
)

follower_ids = await client.get_followers_ids(
    user_id='123456789',
    count=5000
)

friend_ids = await client.get_friends_ids(
    user_id='123456789',
    count=5000
)

await client.delete_tweet('1234567890')

tweet = await client.get_tweet_by_id('1234567890')
print(tweet.text)
print(tweet.user.name)

# Access replies
for reply in tweet.replies:
    print(reply.text)

tweet_ids = ['1111111111', '1111111112', '111111113']
tweets = await client.get_tweets_by_ids(tweet_ids)

for tweet in tweets:
    print(tweet.text)

tweets = await client.search_tweet(
    query='python programming',
    product='Latest',
    count=20
)

for tweet in tweets:
    print(f"{tweet.user.name}: {tweet.text}")

more_tweets = await tweets.next()

scheduled = await client.get_scheduled_tweets()

for tweet in scheduled:
    print(f"Scheduled for: {tweet.scheduled_at}")
    print(f"Text: {tweet.text}")

import time

scheduled_time = int(time.time()) + 3600  # One hour from now

media_ids = [await client.upload_media('image.png')]

tweet_id = await client.create_scheduled_tweet(
    scheduled_at=scheduled_time,
    text='This will post in an hour!',
    media_ids=media_ids
)

await client.delete_scheduled_tweet('1234567890')

similar = await client.get_similar_tweets('1234567890')

for tweet in similar:
    print(tweet.text)

await client.favorite_tweet('1234567890')

await client.unfavorite_tweet('1234567890')

await client.retweet('1234567890')

await client.delete_retweet('1234567890')

retweeters = await client.get_retweeters('1234567890', count=40)

for user in retweeters:
    print(user.name)

more_retweeters = await retweeters.next()

favoriters = await client.get_favoriters('1234567890', count=40)

for user in favoriters:
    print(user.name)

note = await client.get_community_note('1234567890')
print(note.text)

tweets = await client.get_timeline(count=20)

for tweet in tweets:
    print(tweet.text)

more_tweets = await tweets.next()

tweets = await client.get_latest_timeline(count=20)

for tweet in tweets:
    print(f"{tweet.user.name}: {tweet.text}")

status = await client.check_media_status('media_id_here')
print(status['processing_info']['state'])

media_id = await client.upload_media('image.jpg')

await client.create_media_metadata(
    media_id,
    alt_text='A beautiful sunset over the ocean',
    sensitive_warning=['other']
)

await client.create_tweet('Check this out!', media_ids=[media_id])

choices = ['Python', 'JavaScript', 'Rust', 'Go']
duration_minutes = 1440  # 24 hours

poll_uri = await client.create_poll(choices, duration_minutes)
await client.create_tweet('What is your favorite language?', poll_uri=poll_uri)

tweet = await client.get_tweet_by_id('1234567890')

if tweet.poll:
    updated_poll = await client.vote(
        selected_choice='Option A',
        card_uri=tweet.poll.card_uri,
        tweet_id=tweet.id,
        card_name=tweet.poll.name
    )
    print(f"Total votes: {updated_poll.total_votes}")

# Bookmark to default folder
await client.bookmark_tweet('1234567890')

# Bookmark to specific folder
await client.bookmark_tweet('1234567890', folder_id='folder_id')

await client.delete_bookmark('1234567890')

bookmarks = await client.get_bookmarks(count=20)

for tweet in bookmarks:
    print(tweet.text)

more_bookmarks = await bookmarks.next()

await client.delete_all_bookmarks()

folders = await client.get_bookmark_folders()

for folder in folders:
    print(f"{folder.name}: {folder.id}")

more_folders = await folders.next()

folder = await client.create_bookmark_folder('My Important Tweets')
print(f"Created folder: {folder.id}")

folder = await client.edit_bookmark_folder('folder_id', 'New Name')

await client.delete_bookmark_folder('folder_id')

await client.delete_dm('message_id')

messages = await client.get_dm_history('123456789')

for message in messages:
    print(f"{message.sender_id}: {message.text}")

more_messages = await messages.next()

conversation_id = f'123456789-{await client.user_id()}'

await client.add_reaction_to_message(
    message_id='message_id',
    conversation_id=conversation_id,
    emoji='❤️'
)

conversation_id = f'123456789-{await client.user_id()}'

await client.remove_reaction_from_message(
    message_id='message_id',
    conversation_id=conversation_id,
    emoji='❤️'
)

media_id = await client.upload_media('image.png')

message = await client.send_dm_to_group(
    group_id='group_id',
    text='Hello everyone!',
    media_id=media_id
)

messages = await client.get_group_dm_history('group_id')

for message in messages:
    print(f"{message.sender_id}: {message.text}")

group = await client.get_group('group_id')
print(f"Group name: {group.name}")
print(f"Members: {len(group.participants)}")

await client.add_members_to_group(
    group_id='group_id',
    user_ids=['user_id_1', 'user_id_2']
)

await client.change_group_name('group_id', 'New Group Name')

list = await client.create_list(
    name='Tech News',
    description='Accounts posting about technology',
    is_private=True
)

list = await client.get_list('list_id')
print(list.name)
print(list.member_count)

lists = await client.get_lists(count=100)

for list in lists:
    print(f"{list.name}: {list.member_count} members")

more_lists = await lists.next()

updated_list = await client.edit_list(
    list_id='list_id',
    name='New Name',
    description='New description',
    is_private=True
)

await client.add_list_member('list_id', 'user_id')

await client.remove_list_member('list_id', 'user_id')

tweets = await client.get_list_tweets('list_id', count=20)

for tweet in tweets:
    print(tweet.text)

more_tweets = await tweets.next()

members = await client.get_list_members('list_id', count=20)

for member in members:
    print(member.name)

more_members = await members.next()

subscribers = await client.get_list_subscribers('list_id', count=20)