tweetapi 1.0.0__tar.gz → 1.2.0__tar.gz

tweetapi-1.2.0/AGENTS.md

@@ -0,0 +1,92 @@
+# TweetAPI Python SDK Agent Notes
+
+## Repository Context
+
+This repository is the official Python SDK for TweetAPI.
+
+- GitHub: https://github.com/tweetapi/python
+- PyPI package: https://pypi.org/project/tweetapi/
+- Import package: `tweetapi`
+- Distribution package: `tweetapi`
+
+This repo is not a deployed web service. Customer impact happens when changes are
+merged to the public GitHub repository and, separately, when a new package
+version is built and uploaded to PyPI.
+
+## Package And Release Model
+
+Package metadata lives in `pyproject.toml`. The package uses Hatchling:
+
+```toml
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+```
+
+When preparing a release:
+
+1. Update the version in `pyproject.toml`.
+2. Update `tweetapi/__init__.py` so `__version__` matches.
+3. Run tests and compile checks.
+4. Build distributions with `python -m build`.
+5. Inspect the generated `dist/` contents.
+6. Upload to PyPI only when explicitly requested by the maintainer.
+
+Do not publish to PyPI from an agent run unless the user explicitly asks for it.
+Do not reuse a version number that already exists on PyPI.
+
+## API Surface Policy
+
+Expose documented customer-facing routes only. The SDK should map Pythonic
+snake_case method parameters to the backend's camelCase JSON body and query
+parameters.
+
+Do not expose hidden, internal, or undocumented routes, including:
+
+- `/tw-v2/internal/*`
+- `/tw-v2/interaction/home-timeline`
+- `/tw-v2/interaction/following-timeline`
+- `/tw-v2/interaction/search`
+- `/tw-v2/interaction/tweet-details`
+- device follow notification routes
+
+Authenticated Twitter/X actions still require a customer-provided `auth_token`
+and, when required by the endpoint, `proxy`. The TweetAPI API key is passed by
+the client through the `X-API-Key` header.
+
+## Code Patterns
+
+- Resource classes live in `tweetapi/resources/`.
+- `TweetAPI` registers resources in `tweetapi/client.py`.
+- Lightweight JSON-compatible response and request shapes live in
+  `tweetapi/types.py` as `TypedDict` definitions and aliases.
+- Keep method names and arguments Pythonic (`snake_case`), but serialize request
+  payload keys exactly as the backend expects (`camelCase`).
+- `TweetAPI._get` and `TweetAPI._post` strip `None` values. Prefer passing
+  optional fields through those helpers instead of hand-filtering in resources.
+- Add tests with `responses` for new request paths and serialized bodies.
+
+## Verification
+
+Run these before considering changes ready:
+
+```bash
+pytest
+python -m compileall tweetapi
+```
+
+For release candidates that add mutating authenticated endpoints, add mocked
+request-body tests locally and consider a controlled live smoke test against a
+test Twitter/X account before publishing to PyPI.
+
+## Customer Safety
+
+Merging code to GitHub does not automatically update installed customer
+packages. Customers receive new SDK code only after a PyPI release and a local
+upgrade such as:
+
+```bash
+python -m pip install --upgrade tweetapi
+```
+
+Treat PyPI publishing as the production release step for this SDK.

{tweetapi-1.0.0 → tweetapi-1.2.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: tweetapi
-Version: 1.0.0
+Version: 1.2.0
 Summary: Official Python SDK for TweetAPI — Twitter/X Data API for developers and researchers
 Project-URL: Homepage, https://tweetapi.com?utm_source=pypi&utm_medium=readme&utm_campaign=python-sdk
 Project-URL: Documentation, https://tweetapi.com/docs?utm_source=pypi&utm_medium=readme&utm_campaign=python-sdk
-Project-URL: Repository, https://github.com/tweetapi/tweetapi-python
-Project-URL: Issues, https://github.com/tweetapi/tweetapi-python/issues
+Project-URL: Repository, https://github.com/tweetapi/python
+Project-URL: Issues, https://github.com/tweetapi/python/issues
 Author-email: TweetAPI <support@tweetapi.com>
 License-Expression: MIT
 Keywords: social media api,tweet api,tweetapi,tweets,twitter,twitter api,twitter client,twitter data,twitter library,twitter sdk,twitter wrapper,x api
@@ -67,10 +67,13 @@ next_page = client.user.get_followers(
 ## Features
 
 - **70+ endpoints** covering users, tweets, posts, interactions, DMs, communities, spaces, and search
-- **Full type hints** with TypedDict definitions for IDE autocomplete
+- **Full type hints** with TypedDict response types for IDE autocomplete
+- **Automatic retry with backoff** on rate limits (429) and server errors (5xx)
+- **Auto-pagination helpers** — iterate all pages with a simple `for` loop
 - **Solid error handling** with typed exceptions (`RateLimitError`, `NotFoundError`, etc.)
+- **Rate limit awareness** — `retry_after` respected automatically, state exposed via `client.rate_limit_info`
+- **Split timeouts** — separate connect and read timeouts
 - **Single dependency** — `requests` only
-- **Pagination support** with cursor-based navigation
 - **Python 3.9+** compatible
 
 ## API Reference
@@ -110,13 +113,21 @@ next_page = client.user.get_followers(
 
 | Method | Description |
 |--------|-------------|
-| `client.post.create_post(auth_token=..., text=..., proxy=...)` | Create a tweet |
-| `client.post.create_post_quote(auth_token=..., text=..., attachment_url=..., proxy=...)` | Quote tweet |
-| `client.post.create_post_with_media(auth_token=..., text=..., media=..., proxy=...)` | Tweet with media |
+| `client.post.create_post(auth_token=..., text=..., proxy=..., reply_option=...)` | Create a tweet |
+| `client.post.create_post_quote(auth_token=..., text=..., attachment_url=..., proxy=..., reply_option=...)` | Quote tweet |
+| `client.post.create_post_with_media(auth_token=..., text=..., media=..., proxy=..., reply_option=...)` | Tweet with media |
 | `client.post.reply_post(auth_token=..., text=..., tweet_id=..., proxy=...)` | Reply to a tweet |
 | `client.post.reply_post_with_media(...)` | Reply with media |
 | `client.post.delete_post(auth_token=..., tweet_id=...)` | Delete a tweet |
 
+### Profile
+
+| Method | Description |
+|--------|-------------|
+| `client.profile.update(auth_token=..., name=..., bio=..., location=..., website=..., proxy=...)` | Update profile fields |
+| `client.profile.avatar(auth_token=..., media=..., proxy=...)` | Update profile avatar |
+| `client.profile.banner(auth_token=..., media=..., proxy=...)` | Update profile banner |
+
 ### Interaction
 
 | Method | Description |
@@ -142,6 +153,9 @@ next_page = client.user.get_followers(
 | `client.list.get_tweets(list_id=...)` | Get tweets in a list |
 | `client.list.get_members(list_id=...)` | Get list members |
 | `client.list.get_followers(list_id=...)` | Get list followers |
+| `client.list.create(auth_token=..., name=..., description=..., is_private=...)` | Create a list |
+| `client.list.add_member(auth_token=..., list_id=..., user_id=..., proxy=...)` | Add a member |
+| `client.list.remove_member(auth_token=..., list_id=..., user_id=..., proxy=...)` | Remove a member |
 
 ### Community
 
@@ -153,6 +167,8 @@ next_page = client.user.get_followers(
 | `client.community.search(query=...)` | Search communities |
 | `client.community.create_post(auth_token=..., text=..., community_id=..., proxy=...)` | Post in community |
 | `client.community.create_post_with_media(...)` | Post with media |
+| `client.community.create_quote(auth_token=..., text=..., attachment_url=..., community_id=..., proxy=...)` | Quote post in community |
+| `client.community.create_quote_with_media(...)` | Quote post with media |
 | `client.community.reply_post(...)` | Reply to community post |
 | `client.community.reply_post_with_media(...)` | Reply with media |
 | `client.community.join(auth_token=..., community_id=...)` | Join |
@@ -200,12 +216,142 @@ next_page = client.user.get_followers(
 | `client.dm.get_dm_user_updates(auth_token=..., cursor=...)` | DM user updates |
 | `client.dm.accept_conversation(auth_token=..., conversation_id=...)` | Accept request |
 
+## Posting and Profile Media
+
+Tweet media accepts an existing TweetAPI media ID, a URL, or inline base64 data:
+
+```python
+client.post.create_post_with_media(
+    auth_token="AUTH_TOKEN",
+    text="Launch update",
+    media=[{"media_id": "1971008286821380096"}],
+    proxy="host:port:user:pass",
+)
+```
+
+Use `reply_option` to set reply controls when creating standard, quote, or media posts:
+
+```python
+client.post.create_post(
+    auth_token="AUTH_TOKEN",
+    text="Followers can reply",
+    proxy="host:port:user:pass",
+    reply_option={"mode": "followers"},
+)
+```
+
+Profile avatar and banner uploads accept a URL or inline `data` plus `type`:
+
+```python
+client.profile.update(auth_token="AUTH_TOKEN", name="New Name", bio="Builder")
+client.profile.avatar(
+    auth_token="AUTH_TOKEN",
+    media={"url": "https://example.com/avatar.jpg"},
+)
+client.profile.banner(
+    auth_token="AUTH_TOKEN",
+    media={"data": "BASE64_IMAGE_DATA", "type": "image/png"},
+)
+```
+
+Canonical list mutations live under `client.list`; the legacy interaction list helpers remain available:
+
+```python
+created = client.list.create(
+    auth_token="AUTH_TOKEN",
+    name="Research",
+    description="Accounts to watch",
+    is_private=True,
+)
+client.list.add_member(auth_token="AUTH_TOKEN", list_id=created["data"]["id"], user_id="123")
+client.list.remove_member(auth_token="AUTH_TOKEN", list_id=created["data"]["id"], user_id="123")
+```
+
+Community quote posts support the same URL and media attachment shapes:
+
+```python
+client.community.create_quote(
+    auth_token="AUTH_TOKEN",
+    text="Useful context",
+    attachment_url="https://x.com/user/status/123",
+    community_id="987",
+    proxy="host:port:user:pass",
+)
+client.community.create_quote_with_media(
+    auth_token="AUTH_TOKEN",
+    text="Useful context",
+    attachment_url="https://x.com/user/status/123",
+    community_id="987",
+    media=[{"media_id": "1971008286821380096"}],
+    proxy="host:port:user:pass",
+)
+```
+
+## Auto-Pagination
+
+Use the `paginate()` and `paginate_pages()` helpers to iterate through all pages automatically:
+
+```python
+from tweetapi import TweetAPI, paginate, paginate_pages
+
+client = TweetAPI(api_key="YOUR_API_KEY")
+
+# Iterate individual items across all pages
+for user in paginate(
+    lambda cursor: client.user.get_followers(user_id="123456", cursor=cursor),
+):
+    print(user["username"])
+
+# Iterate full pages (access page-level data)
+for page in paginate_pages(
+    lambda cursor: client.explore.search(query="bitcoin", type="Latest", cursor=cursor),
+    max_pages=5,  # optional: limit number of pages
+):
+    print(f"Got {len(page['data'])} results")
+    print(f"Next cursor: {page['pagination']['nextCursor']}")
+```
+
+Works with any paginated endpoint — followers, tweets, search results, list members, community posts, etc.
+
+## Automatic Retry with Backoff
+
+The SDK automatically retries on transient errors with exponential backoff:
+
+- **429 (Rate Limit)** — waits the `retry_after` duration from the API, then retries
+- **5xx (Server Error)** — retries with exponential backoff + jitter
+- **Network errors** — retries on timeouts and connection failures
+- **4xx (Client Error)** — never retried (400, 401, 403, 404 fail immediately)
+
+Default: 3 retries, 2x backoff, 1s initial delay, 30s max delay.
+
+```python
+# Customize retry behavior
+client = TweetAPI(
+    api_key="YOUR_API_KEY",
+    max_retries=5,             # default: 3
+    initial_retry_delay=2.0,   # default: 1.0 (seconds)
+    backoff_multiplier=3.0,    # default: 2.0
+    max_retry_delay=60.0,      # default: 30.0 (seconds)
+)
+
+# Disable retries entirely
+client = TweetAPI(api_key="YOUR_API_KEY", max_retries=0)
+```
+
+### Rate Limit Awareness
+
+After a 429 response, the SDK exposes the last known rate limit state:
+
+```python
+print(client.rate_limit_info)
+# {"retry_after": 30, "timestamp": 1712345678.0} — or None if no 429 encountered
+```
+
 ## Error Handling
 
-The SDK throws typed exceptions you can catch and handle:
+The SDK raises typed exceptions you can catch and handle. With automatic retries enabled (default), you'll only see these after all retry attempts are exhausted:
 
 ```python
-import time
 from tweetapi import (
     TweetAPI,
     TweetAPIError,
@@ -222,9 +368,7 @@ client = TweetAPI(api_key="YOUR_API_KEY")
 try:
     user = client.user.get_by_username(username="elonmusk")
 except RateLimitError as e:
-    # Wait and retry
     print(f"Rate limited. Retry in {e.retry_after}s")
-    time.sleep(e.retry_after)
 except NotFoundError:
     print("User not found")
 except AuthenticationError:
@@ -236,7 +380,6 @@ except ServerError:
 except NetworkError:
     print("Network error — check your connection")
 except TweetAPIError as e:
-    # Catch-all for any other API error
     print(f"Error [{e.code}]: {e.message}")
 ```
 
@@ -252,8 +395,17 @@ Every error includes:
 client = TweetAPI(
     api_key="YOUR_API_KEY",           # Required
     base_url="https://...",           # Optional (default: https://api.tweetapi.com)
-    timeout=30,                       # Optional (default: 30 seconds)
+    timeout=30,                       # Optional — single value for both connect + read
+    connect_timeout=10.0,             # Optional (default: 10s)
+    read_timeout=30.0,                # Optional (default: 30s)
+    max_retries=3,                    # Optional (default: 3, set 0 to disable)
+    backoff_multiplier=2.0,           # Optional (default: 2.0)
+    initial_retry_delay=1.0,          # Optional (default: 1.0s)
+    max_retry_delay=30.0,             # Optional (default: 30.0s)
 )
+
+# You can also pass a tuple for timeout
+client = TweetAPI(api_key="YOUR_API_KEY", timeout=(5, 30))  # (connect, read)
 ```
 
 ## Requirements
@@ -266,7 +418,7 @@ client = TweetAPI(
 - [Full Documentation](https://tweetapi.com/docs?utm_source=github&utm_medium=readme&utm_campaign=python-sdk)
 - [Get API Key (Free)](https://tweetapi.com?utm_source=github&utm_medium=readme&utm_campaign=python-sdk)
 - [Dashboard](https://tweetapi.com/dashboard?utm_source=github&utm_medium=readme&utm_campaign=python-sdk)
-- [Node.js SDK](https://github.com/tweetapi/tweetapi-node)
+- [Node.js SDK](https://github.com/tweetapi/node)
 
 ## License
 

{tweetapi-1.0.0 → tweetapi-1.2.0}/README.md

@@ -37,10 +37,13 @@ next_page = client.user.get_followers(
 ## Features
 
 - **70+ endpoints** covering users, tweets, posts, interactions, DMs, communities, spaces, and search
-- **Full type hints** with TypedDict definitions for IDE autocomplete
+- **Full type hints** with TypedDict response types for IDE autocomplete
+- **Automatic retry with backoff** on rate limits (429) and server errors (5xx)
+- **Auto-pagination helpers** — iterate all pages with a simple `for` loop
 - **Solid error handling** with typed exceptions (`RateLimitError`, `NotFoundError`, etc.)
+- **Rate limit awareness** — `retry_after` respected automatically, state exposed via `client.rate_limit_info`
+- **Split timeouts** — separate connect and read timeouts
 - **Single dependency** — `requests` only
-- **Pagination support** with cursor-based navigation
 - **Python 3.9+** compatible
 
 ## API Reference
@@ -80,13 +83,21 @@ next_page = client.user.get_followers(
 
 | Method | Description |
 |--------|-------------|
-| `client.post.create_post(auth_token=..., text=..., proxy=...)` | Create a tweet |
-| `client.post.create_post_quote(auth_token=..., text=..., attachment_url=..., proxy=...)` | Quote tweet |
-| `client.post.create_post_with_media(auth_token=..., text=..., media=..., proxy=...)` | Tweet with media |
+| `client.post.create_post(auth_token=..., text=..., proxy=..., reply_option=...)` | Create a tweet |
+| `client.post.create_post_quote(auth_token=..., text=..., attachment_url=..., proxy=..., reply_option=...)` | Quote tweet |
+| `client.post.create_post_with_media(auth_token=..., text=..., media=..., proxy=..., reply_option=...)` | Tweet with media |
 | `client.post.reply_post(auth_token=..., text=..., tweet_id=..., proxy=...)` | Reply to a tweet |
 | `client.post.reply_post_with_media(...)` | Reply with media |
 | `client.post.delete_post(auth_token=..., tweet_id=...)` | Delete a tweet |
 
+### Profile
+
+| Method | Description |
+|--------|-------------|
+| `client.profile.update(auth_token=..., name=..., bio=..., location=..., website=..., proxy=...)` | Update profile fields |
+| `client.profile.avatar(auth_token=..., media=..., proxy=...)` | Update profile avatar |
+| `client.profile.banner(auth_token=..., media=..., proxy=...)` | Update profile banner |
+
 ### Interaction
 
 | Method | Description |
@@ -112,6 +123,9 @@ next_page = client.user.get_followers(
 | `client.list.get_tweets(list_id=...)` | Get tweets in a list |
 | `client.list.get_members(list_id=...)` | Get list members |
 | `client.list.get_followers(list_id=...)` | Get list followers |
+| `client.list.create(auth_token=..., name=..., description=..., is_private=...)` | Create a list |
+| `client.list.add_member(auth_token=..., list_id=..., user_id=..., proxy=...)` | Add a member |
+| `client.list.remove_member(auth_token=..., list_id=..., user_id=..., proxy=...)` | Remove a member |
 
 ### Community
 
@@ -123,6 +137,8 @@ next_page = client.user.get_followers(
 | `client.community.search(query=...)` | Search communities |
 | `client.community.create_post(auth_token=..., text=..., community_id=..., proxy=...)` | Post in community |
 | `client.community.create_post_with_media(...)` | Post with media |
+| `client.community.create_quote(auth_token=..., text=..., attachment_url=..., community_id=..., proxy=...)` | Quote post in community |
+| `client.community.create_quote_with_media(...)` | Quote post with media |
 | `client.community.reply_post(...)` | Reply to community post |
 | `client.community.reply_post_with_media(...)` | Reply with media |
 | `client.community.join(auth_token=..., community_id=...)` | Join |
@@ -170,12 +186,142 @@ next_page = client.user.get_followers(
 | `client.dm.get_dm_user_updates(auth_token=..., cursor=...)` | DM user updates |
 | `client.dm.accept_conversation(auth_token=..., conversation_id=...)` | Accept request |
 
+## Posting and Profile Media
+
+Tweet media accepts an existing TweetAPI media ID, a URL, or inline base64 data:
+
+```python
+client.post.create_post_with_media(
+    auth_token="AUTH_TOKEN",
+    text="Launch update",
+    media=[{"media_id": "1971008286821380096"}],
+    proxy="host:port:user:pass",
+)
+```
+
+Use `reply_option` to set reply controls when creating standard, quote, or media posts:
+
+```python
+client.post.create_post(
+    auth_token="AUTH_TOKEN",
+    text="Followers can reply",
+    proxy="host:port:user:pass",
+    reply_option={"mode": "followers"},
+)
+```
+
+Profile avatar and banner uploads accept a URL or inline `data` plus `type`:
+
+```python
+client.profile.update(auth_token="AUTH_TOKEN", name="New Name", bio="Builder")
+client.profile.avatar(
+    auth_token="AUTH_TOKEN",
+    media={"url": "https://example.com/avatar.jpg"},
+)
+client.profile.banner(
+    auth_token="AUTH_TOKEN",
+    media={"data": "BASE64_IMAGE_DATA", "type": "image/png"},
+)
+```
+
+Canonical list mutations live under `client.list`; the legacy interaction list helpers remain available:
+
+```python
+created = client.list.create(
+    auth_token="AUTH_TOKEN",
+    name="Research",
+    description="Accounts to watch",
+    is_private=True,
+)
+client.list.add_member(auth_token="AUTH_TOKEN", list_id=created["data"]["id"], user_id="123")
+client.list.remove_member(auth_token="AUTH_TOKEN", list_id=created["data"]["id"], user_id="123")
+```
+
+Community quote posts support the same URL and media attachment shapes:
+
+```python
+client.community.create_quote(
+    auth_token="AUTH_TOKEN",
+    text="Useful context",
+    attachment_url="https://x.com/user/status/123",
+    community_id="987",
+    proxy="host:port:user:pass",
+)
+client.community.create_quote_with_media(
+    auth_token="AUTH_TOKEN",
+    text="Useful context",
+    attachment_url="https://x.com/user/status/123",
+    community_id="987",
+    media=[{"media_id": "1971008286821380096"}],
+    proxy="host:port:user:pass",
+)
+```
+
+## Auto-Pagination
+
+Use the `paginate()` and `paginate_pages()` helpers to iterate through all pages automatically:
+
+```python
+from tweetapi import TweetAPI, paginate, paginate_pages
+
+client = TweetAPI(api_key="YOUR_API_KEY")
+
+# Iterate individual items across all pages
+for user in paginate(
+    lambda cursor: client.user.get_followers(user_id="123456", cursor=cursor),
+):
+    print(user["username"])
+
+# Iterate full pages (access page-level data)
+for page in paginate_pages(
+    lambda cursor: client.explore.search(query="bitcoin", type="Latest", cursor=cursor),
+    max_pages=5,  # optional: limit number of pages
+):
+    print(f"Got {len(page['data'])} results")
+    print(f"Next cursor: {page['pagination']['nextCursor']}")
+```
+
+Works with any paginated endpoint — followers, tweets, search results, list members, community posts, etc.
+
+## Automatic Retry with Backoff
+
+The SDK automatically retries on transient errors with exponential backoff:
+
+- **429 (Rate Limit)** — waits the `retry_after` duration from the API, then retries
+- **5xx (Server Error)** — retries with exponential backoff + jitter
+- **Network errors** — retries on timeouts and connection failures
+- **4xx (Client Error)** — never retried (400, 401, 403, 404 fail immediately)
+
+Default: 3 retries, 2x backoff, 1s initial delay, 30s max delay.
+
+```python
+# Customize retry behavior
+client = TweetAPI(
+    api_key="YOUR_API_KEY",
+    max_retries=5,             # default: 3
+    initial_retry_delay=2.0,   # default: 1.0 (seconds)
+    backoff_multiplier=3.0,    # default: 2.0
+    max_retry_delay=60.0,      # default: 30.0 (seconds)
+)
+
+# Disable retries entirely
+client = TweetAPI(api_key="YOUR_API_KEY", max_retries=0)
+```
+
+### Rate Limit Awareness
+
+After a 429 response, the SDK exposes the last known rate limit state:
+
+```python
+print(client.rate_limit_info)
+# {"retry_after": 30, "timestamp": 1712345678.0} — or None if no 429 encountered
+```
+
 ## Error Handling
 
-The SDK throws typed exceptions you can catch and handle:
+The SDK raises typed exceptions you can catch and handle. With automatic retries enabled (default), you'll only see these after all retry attempts are exhausted:
 
 ```python
-import time
 from tweetapi import (
     TweetAPI,
     TweetAPIError,
@@ -192,9 +338,7 @@ client = TweetAPI(api_key="YOUR_API_KEY")
 try:
     user = client.user.get_by_username(username="elonmusk")
 except RateLimitError as e:
-    # Wait and retry
     print(f"Rate limited. Retry in {e.retry_after}s")
-    time.sleep(e.retry_after)
 except NotFoundError:
     print("User not found")
 except AuthenticationError:
@@ -206,7 +350,6 @@ except ServerError:
 except NetworkError:
     print("Network error — check your connection")
 except TweetAPIError as e:
-    # Catch-all for any other API error
     print(f"Error [{e.code}]: {e.message}")
 ```
 
@@ -222,8 +365,17 @@ Every error includes:
 client = TweetAPI(
     api_key="YOUR_API_KEY",           # Required
     base_url="https://...",           # Optional (default: https://api.tweetapi.com)
-    timeout=30,                       # Optional (default: 30 seconds)
+    timeout=30,                       # Optional — single value for both connect + read
+    connect_timeout=10.0,             # Optional (default: 10s)
+    read_timeout=30.0,                # Optional (default: 30s)
+    max_retries=3,                    # Optional (default: 3, set 0 to disable)
+    backoff_multiplier=2.0,           # Optional (default: 2.0)
+    initial_retry_delay=1.0,          # Optional (default: 1.0s)
+    max_retry_delay=30.0,             # Optional (default: 30.0s)
 )
+
+# You can also pass a tuple for timeout
+client = TweetAPI(api_key="YOUR_API_KEY", timeout=(5, 30))  # (connect, read)
 ```
 
 ## Requirements
@@ -236,7 +388,7 @@ client = TweetAPI(
 - [Full Documentation](https://tweetapi.com/docs?utm_source=github&utm_medium=readme&utm_campaign=python-sdk)
 - [Get API Key (Free)](https://tweetapi.com?utm_source=github&utm_medium=readme&utm_campaign=python-sdk)
 - [Dashboard](https://tweetapi.com/dashboard?utm_source=github&utm_medium=readme&utm_campaign=python-sdk)
-- [Node.js SDK](https://github.com/tweetapi/tweetapi-node)
+- [Node.js SDK](https://github.com/tweetapi/node)
 
 ## License
 

{tweetapi-1.0.0 → tweetapi-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tweetapi"
-version = "1.0.0"
+version = "1.2.0"
 description = "Official Python SDK for TweetAPI — Twitter/X Data API for developers and researchers"
 readme = "README.md"
 license = "MIT"
@@ -47,8 +47,8 @@ dependencies = [
 [project.urls]
 Homepage = "https://tweetapi.com?utm_source=pypi&utm_medium=readme&utm_campaign=python-sdk"
 Documentation = "https://tweetapi.com/docs?utm_source=pypi&utm_medium=readme&utm_campaign=python-sdk"
-Repository = "https://github.com/tweetapi/tweetapi-python"
-Issues = "https://github.com/tweetapi/tweetapi-python/issues"
+Repository = "https://github.com/tweetapi/python"
+Issues = "https://github.com/tweetapi/python/issues"
 
 [tool.hatch.build.targets.wheel]
 packages = ["tweetapi"]