# d60/twikit

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/d60-twikit).**

4,038 stars · 478 forks · Python · mit

## Links

- GitHub: https://github.com/d60/twikit
- Homepage: https://twikit.readthedocs.io/en/latest/twikit.html
- awesome-repositories: https://awesome-repositories.com/repository/d60-twikit.md

## Topics

`bot` `client` `python` `python-web-scraper` `python3` `scrape` `scraper` `scraping` `search` `tweepy` `twitter` `twitter-api` `twitter-bot` `twitter-client` `twitter-internal-api` `twitter-scraper` `wrapper` `x` `x-api`

## Description

Twikit is a Python library and API wrapper designed for interacting with X (Twitter). It simulates browser requests and mimics private network traffic to enable programmatic access to the platform without requiring an official API key.

The project focuses on social media automation and data extraction, featuring tools for scraping user profiles, trending topics, and chronological tweet histories. It includes a session manager that handles user authentication, two-factor authentication, and cookie persistence to maintain active account access.

The library's capabilities cover a broad range of social interactions, including publishing posts, managing direct messages, and controlling user relationships such as following or blocking. It provides specialized utilities for media handling, allowing for the uploading of assets and the downloading of images, videos, and synchronized subtitle tracks. Additionally, it supports social graph management through curated list administration and community interaction.

To maintain access and stability, the toolkit integrates with external captcha solving services to bypass bot detection and supports routing network traffic through configurable proxy servers.

## Tags

### Artificial Intelligence & ML

- [Reverse-Engineered API Clients](https://awesome-repositories.com/f/artificial-intelligence-ml/reverse-engineered-api-clients.md) — Simulates official client behavior by mimicking private network requests through a reverse-engineered API client.

### Networking & Communication

- [Social Media Automation Clients](https://awesome-repositories.com/f/networking-communication/messaging-automation-clients/social-media-automation-clients.md) — Automates social media actions including login, session management, posting, and engagement through a unified interface.
- [Social Media Posting](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/communication-platforms/social-media-integrations/social-media-posting.md) — Enables programmatic posting of content and searching for tweets without an official API key. ([source](https://twikit.readthedocs.io/en/latest/index.html))
- [Messaging Automation](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-automation.md) — Provides a programmatic interface for sending, receiving, and automating direct messages and reactions.
- [User Profile Retrieval](https://awesome-repositories.com/f/networking-communication/contact-management/user-profile-retrieval.md) — Retrieves comprehensive user profile data, including bios, verification status, and follower counts. ([source](https://twikit.readthedocs.io/en/latest/_modules/twikit/user.html))
- [Direct Message Replies](https://awesome-repositories.com/f/networking-communication/direct-message-replies.md) — Sends text responses and optional media attachments to users in one-to-one chat contexts. ([source](https://twikit.readthedocs.io/en/latest/_modules/twikit/message.html))
- [Proxy Routing](https://awesome-repositories.com/f/networking-communication/request-proxies/proxy-routing.md) — Routes outgoing network traffic through configurable proxy servers to mask the origin IP address.
- [Text Message Transmission](https://awesome-repositories.com/f/networking-communication/text-message-transmission.md) — Implements the transmission of formatted text messages and the management of communication threads. ([source](https://cdn.jsdelivr.net/gh/d60/twikit@main/README.md))

### Content Management & Publishing

- [Post Interaction Automations](https://awesome-repositories.com/f/content-management-publishing/post-interaction-automations.md) — Performs automated actions on posts including deleting, favoriting, and retweeting. ([source](https://twikit.readthedocs.io/en/latest/twikit.html))
- [Social Media Publishers](https://awesome-repositories.com/f/content-management-publishing/social-media-publishers.md) — Programmatically distributes text and media content to social media accounts. ([source](https://github.com/d60/twikit/blob/main/README-ja.md))
- [Trending Search Retrievers](https://awesome-repositories.com/f/content-management-publishing/article-list-retrieval/trending-search-retrievers.md) — Fetches currently popular topics and trends based on specific locations or categories. ([source](https://github.com/d60/twikit/blob/main/README-ja.md))

### Data & Databases

- [Social Media Data Scraping](https://awesome-repositories.com/f/data-databases/data-scraping-tools/social-media-data-scraping.md) — Extracts profiles, posts, trending topics, and media metadata from social media without requiring official API keys.
- [Engagement Metadata Extraction](https://awesome-repositories.com/f/data-databases/engagement-metadata-extraction.md) — Extracts detailed engagement metrics such as likes, repost counts, and author information from posts. ([source](https://twikit.readthedocs.io/en/latest/_modules/twikit/tweet.html))
- [Cursor-Based Pagination](https://awesome-repositories.com/f/data-databases/query-aggregates/paginated-results/cursor-based-pagination.md) — Implements sequential data retrieval using cursors to fetch subsequent pages of results. ([source](https://twikit.readthedocs.io/en/latest/_modules/twikit/utils.html))
- [Keyword Search](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-information-retrieval/matching-ranking-logic/keyword-search.md) — Retrieves public posts matching specific keywords or queries based on recency and filters. ([source](https://github.com/d60/twikit/blob/main/README-ja.md))

### Development Tools & Productivity

- [Social Media Content Retrievers](https://awesome-repositories.com/f/development-tools-productivity/integration-metadata-retrievers/media-metadata-retrievers/security-protected-media-retrievers/social-media-content-retrievers.md) — Provides capabilities to fetch media, captions, and metadata from social media profiles and feeds. ([source](https://twikit.readthedocs.io/en/latest/twikit.html))

### Security & Cryptography

- [Session Authentication](https://awesome-repositories.com/f/security-cryptography/session-authentication.md) — Manages account login flows including credential handling and two-factor authentication. ([source](https://twikit.readthedocs.io/en/latest/twikit.html))
- [Session-Cookie Persistences](https://awesome-repositories.com/f/security-cryptography/session-cookie-handlers/session-cookie-persistences.md) — Saves and loads session cookies to disk to maintain authentication and avoid repeated logins.
- [Session Management](https://awesome-repositories.com/f/security-cryptography/two-factor-authentication/session-management.md) — Manages login credentials, cookie persistence, and two-factor authentication to maintain account access.
- [User Account Management](https://awesome-repositories.com/f/security-cryptography/user-account-management.md) — Manages user credentials, authentication states, and session cookies for programmatic account access.
- [Automated Captcha Solvers](https://awesome-repositories.com/f/security-cryptography/captcha-services/automated-captcha-solvers.md) — Integrates with third-party services to automatically solve captcha challenges and bypass bot detection.

### Software Engineering & Architecture

- [API Wrappers](https://awesome-repositories.com/f/software-engineering-architecture/api-wrappers.md) — Provides a structured programmatic interface to interact with Twitter by simulating browser requests.

### System Administration & Monitoring

- [Profile Activity Scrapers](https://awesome-repositories.com/f/system-administration-monitoring/activity-monitors/automated-activity-loggers/user-activity-monitoring/profile-activity-scrapers.md) — Fetches a chronological list of posts and interactions authored by a specific user. ([source](https://cdn.jsdelivr.net/gh/d60/twikit@main/README.md))

### Web Development

- [Custom Scrapers](https://awesome-repositories.com/f/web-development/website-crawlers-and-scrapers/custom-scrapers.md) — Retrieves structured user profiles, trending topics, and chronological tweet histories through custom extraction.

### Business & Productivity Software

- [Media Downloaders](https://awesome-repositories.com/f/business-productivity-software/media-downloaders.md) — Extracts videos, images, and synchronized subtitle tracks from posts for local storage.
- [Social Connection Management](https://awesome-repositories.com/f/business-productivity-software/social-connection-management.md) — Manages social connections by providing functions to follow, unfollow, and block other accounts. ([source](https://twikit.readthedocs.io/en/latest/twikit.html))

### Graphics & Multimedia

- [Media Downloaders](https://awesome-repositories.com/f/graphics-multimedia/media-processing-analysis/media-downloaders.md) — Downloads images and videos from posts and extracts associated subtitle tracks. ([source](https://twikit.readthedocs.io/en/latest/twikit.html))
- [Media File Upload Handlers](https://awesome-repositories.com/f/graphics-multimedia/media-production-suites/media-management-production/media-management-systems/media-file-upload-handlers.md) — Uploads media files to servers to obtain identifiers for use in posts. ([source](https://github.com/d60/twikit/blob/main/README-ja.md))
- [Social Media Media Downloaders](https://awesome-repositories.com/f/graphics-multimedia/social-media-media-downloaders.md) — Saves images, videos, and synchronized subtitle tracks from posts to local storage.
