Skip to content

d60/twikit

Repository files navigation

Number of GitHub stars GitHub commit activity Version Tweet Discord BuyMeACoffee

[日本語] [中文]

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.

Both Synchronous and Asynchronous Support

Twikit supports both synchronous and asynchronous.

Functionality

By using Twikit, you can access functionalities such as the following:

  • Create tweets

  • Search tweets

  • Retrieve trending topics

  • etc...

Installing

pip install twikit

Quick Example

Define a client and log in to the account.

from twikit import Client

USERNAME = 'example_user'
EMAIL = 'email@example.com'
PASSWORD = 'password0000'

# Initialize client
client = Client('en-US')

client.login(
    auth_info_1=USERNAME ,
    auth_info_2=EMAIL,
    password=PASSWORD
)

Create a tweet with media attached.

# Upload media files and obtain media_ids
media_ids = [
    client.upload_media('media1.jpg'),
    client.upload_media('media2.jpg')
]

# Create a tweet with the provided text and attached media
client.create_tweet(
    text='Example Tweet',
    media_ids=media_ids
)

Search the latest tweets based on a keywords

tweets = client.search_tweet('python', 'Latest')

for tweet in tweets:
    print(
        tweet.user.name,
        tweet.text,
        tweet.created_at
    )

Retrieve user tweets

tweets = client.get_user_tweets('123456', 'Tweet')

for tweet in tweets:
    print(tweet.text)

More Examples: examples

Contributing

If you encounter any bugs or issues, please report them on issues.

Additionally, if you find this library useful, I would appreciate it if you would star this repository or share this library.