<img src="https://i.imgur.com/VbAcRG5.jpg" width="500">
# Twikit
A simple API wrapper to interact with twitter's internal API.
Read the documentation for more information.
- [Documentation (English)](https://twikit.readthedocs.io/en/latest/twikit.html)
- [Async Documentation](https://twikit.readthedocs.io/en/latest/twikit.twikit_async.html)
## Features
### No API Key Required
The library uses an unofficial API and therefore does **not require an API key**.
### Completely Free
The service is entirely free to use.
### Both Synchronous and Asynchronous Support
Whether you prefer **synchronous** or **asynchronous** programming,
Twikit supports both, providing flexibility for different use cases.
## Functionality
This library allows you to perform various Twitter-related actions, including:
- **Create tweets**
- **Search tweets**
- **Retrieve trending topics**
- etc...
## Installing
```back
pip install twikit
```
## Quick Example
**Define a client and log in to the account.**
```python
from twikit import Client
USERNAME = 'example_user'
EMAIL = 'email@example.com'
PASSWORD = 'password0000'
# Initialize client
client = Client('en-US')
# Login to the service with provided user credentials
client.login(
auth_info_1=USERNAME ,
auth_info_2=EMAIL,
password=PASSWORD
)
```
**Create a tweet with media attached.**
```python
# Upload media files and obtain media_ids
media_ids = [
client.upload_media('media1.jpg', index=0),
client.upload_media('media2.jpg', index=1)
]
# Create a tweet with the provided text and attached media
client.create_tweet(
text='Example Tweet',
media_ids=media_ids
)
```
For more examples, see [example.py](https://github.com/d60/twikit/blob/main/example.py).
See [example_async.py](https://github.com/d60/twikit/blob/main/example_async.py) for an example of Async.
## Contributing
This project is currently in beta, and we would love to hear your thoughts and suggestions.
If you have any features you'd like to see added or encounter any issues,
please let us know in the [issues](https://github.com/d60/twikit/issues) section.
Additionally, if you find this library useful, spreading the word by starring it would be greatly appreciated and serve as motivation for further development. Thank you!
Raw data
{
"_id": null,
"home_page": "https://github.com/yanjlee/twikit",
"name": "twikit-pro",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "yanjlee",
"author_email": "yanjlee@163.com",
"download_url": "https://files.pythonhosted.org/packages/a0/f0/50bea6d4de5b0b44cd126e65be1a9e54b2467f78b3e2d01058011c5b0d6b/twikit_pro-1.1.3.tar.gz",
"platform": null,
"description": "<img src=\"https://i.imgur.com/VbAcRG5.jpg\" width=\"500\">\r\n\r\n# Twikit\r\nA simple API wrapper to interact with twitter's internal API.\r\nRead the documentation for more information.\r\n- [Documentation (English)](https://twikit.readthedocs.io/en/latest/twikit.html)\r\n- [Async Documentation](https://twikit.readthedocs.io/en/latest/twikit.twikit_async.html)\r\n\r\n## Features\r\n### No API Key Required\r\nThe library uses an unofficial API and therefore does **not require an API key**.\r\n### Completely Free\r\nThe service is entirely free to use.\r\n### Both Synchronous and Asynchronous Support\r\nWhether you prefer **synchronous** or **asynchronous** programming,\r\nTwikit supports both, providing flexibility for different use cases.\r\n\r\n## Functionality\r\nThis library allows you to perform various Twitter-related actions, including:\r\n- **Create tweets**\r\n- **Search tweets**\r\n- **Retrieve trending topics**\r\n- etc...\r\n\r\n## Installing\r\n ```back\r\n pip install twikit\r\n ```\r\n\r\n## Quick Example\r\n**Define a client and log in to the account.**\r\n```python\r\nfrom twikit import Client\r\n\r\nUSERNAME = 'example_user'\r\nEMAIL = 'email@example.com'\r\nPASSWORD = 'password0000'\r\n\r\n# Initialize client\r\nclient = Client('en-US')\r\n# Login to the service with provided user credentials\r\nclient.login(\r\n auth_info_1=USERNAME ,\r\n auth_info_2=EMAIL,\r\n password=PASSWORD\r\n)\r\n```\r\n**Create a tweet with media attached.**\r\n```python\r\n# Upload media files and obtain media_ids\r\nmedia_ids = [\r\n client.upload_media('media1.jpg', index=0),\r\n client.upload_media('media2.jpg', index=1)\r\n]\r\n# Create a tweet with the provided text and attached media\r\nclient.create_tweet(\r\n text='Example Tweet',\r\n media_ids=media_ids\r\n)\r\n```\r\n\r\nFor more examples, see [example.py](https://github.com/d60/twikit/blob/main/example.py).\r\nSee [example_async.py](https://github.com/d60/twikit/blob/main/example_async.py) for an example of Async.\r\n\r\n## Contributing\r\nThis project is currently in beta, and we would love to hear your thoughts and suggestions.\r\nIf you have any features you'd like to see added or encounter any issues,\r\nplease let us know in the [issues](https://github.com/d60/twikit/issues) section.\r\n\r\nAdditionally, if you find this library useful, spreading the word by starring it would be greatly appreciated and serve as motivation for further development. Thank you!\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Twitter API wrapper for python with **no API key required**.",
"version": "1.1.3",
"project_urls": {
"Homepage": "https://github.com/yanjlee/twikit"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e9ac6d2e2a7b71cb25bb1a3298b8eb6bbefca8c292ea582b9c34906d826fdfeb",
"md5": "9785b00247146cdbc4d86e49ede93849",
"sha256": "114b5a74155d18876375f3972998ab305e203282eea9278435182638489e902a"
},
"downloads": -1,
"filename": "twikit_pro-1.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9785b00247146cdbc4d86e49ede93849",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 39828,
"upload_time": "2024-06-01T08:38:34",
"upload_time_iso_8601": "2024-06-01T08:38:34.711787Z",
"url": "https://files.pythonhosted.org/packages/e9/ac/6d2e2a7b71cb25bb1a3298b8eb6bbefca8c292ea582b9c34906d826fdfeb/twikit_pro-1.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a0f050bea6d4de5b0b44cd126e65be1a9e54b2467f78b3e2d01058011c5b0d6b",
"md5": "c86168c3b9a37354a1be951a4c00728f",
"sha256": "608c4fa32dd1d734331d985f83e36e45b07afce89f8f1a3eb872b4a9aa811a01"
},
"downloads": -1,
"filename": "twikit_pro-1.1.3.tar.gz",
"has_sig": false,
"md5_digest": "c86168c3b9a37354a1be951a4c00728f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 31673,
"upload_time": "2024-06-01T08:38:37",
"upload_time_iso_8601": "2024-06-01T08:38:37.009093Z",
"url": "https://files.pythonhosted.org/packages/a0/f0/50bea6d4de5b0b44cd126e65be1a9e54b2467f78b3e2d01058011c5b0d6b/twikit_pro-1.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-01 08:38:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yanjlee",
"github_project": "twikit",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "httpx",
"specs": []
}
],
"lcname": "twikit-pro"
}
JSON
