Skip to main content

Twitter API wrapper for python with **no API key required**.

Project description

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

[!IMPORTANT] With the release of version 2.0.0 on July 11, there have been some specification changes, including the discontinuation of the synchronous version. Existing code will no longer work with v2.0.0 or later, so please refer to the documentation or the code in the examples folder for adjustments. We apologize for any inconvenience this may cause.

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

pip install twikit

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
    )

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⭐️

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

twikit-2.1.1.tar.gz (62.4 kB view details)

Uploaded Source

Built Distribution

twikit-2.1.1-py3-none-any.whl (71.7 kB view details)

Uploaded Python 3

File details

Details for the file twikit-2.1.1.tar.gz.

File metadata

  • Download URL: twikit-2.1.1.tar.gz
  • Upload date:
  • Size: 62.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.5

File hashes

Hashes for twikit-2.1.1.tar.gz
Algorithm Hash digest
SHA256 4f0091e287b11ec7571c8b2e7303701de815f1b02e58bf41c8253dad2dbcf464
MD5 8888f2e33468036d6532d9a9245b4cfc
BLAKE2b-256 1b7948fcffd8666f32caf8d398a2f5a3191b9dc1f9863bd2968d8468571812e2

See more details on using hashes here.

File details

Details for the file twikit-2.1.1-py3-none-any.whl.

File metadata

  • Download URL: twikit-2.1.1-py3-none-any.whl
  • Upload date:
  • Size: 71.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.5

File hashes

Hashes for twikit-2.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 72eaeda3f722194035e7c15601dac5f41aa719b7e328e7267b7962ca39f6beaf
MD5 fc7c658535c8bc0a8bc39322edf523c5
BLAKE2b-256 d7f0ab7581a510eaac0d615a17126be6d488b142841c6ecd0e6b8e6095a1a4a1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page