tweetapi 1.1.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.1.0 → tweetapi-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tweetapi
-Version: 1.1.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
@@ -113,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 |
@@ -145,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
 
@@ -156,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 |
@@ -203,6 +216,77 @@ 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:

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

@@ -83,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 |
@@ -115,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
 
@@ -126,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 |
@@ -173,6 +186,77 @@ 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:

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tweetapi"
-version = "1.1.0"
+version = "1.2.0"
 description = "Official Python SDK for TweetAPI — Twitter/X Data API for developers and researchers"
 readme = "README.md"
 license = "MIT"

{tweetapi-1.1.0 → tweetapi-1.2.0}/tests/test_client.py

@@ -35,7 +35,7 @@ class TestClientInit:
     def test_all_resources_exist(self):
         client = make_client()
         for attr in ["user", "tweet", "post", "interaction", "list", "community",
-                      "space", "explore", "auth", "xchat", "dm"]:
+                      "profile", "space", "explore", "auth", "xchat", "dm"]:
             assert hasattr(client, attr), f"Missing resource: {attr}"
 
 
@@ -132,6 +132,251 @@ class TestPostRequests:
         body = json.loads(responses.calls[0].request.body)
         assert "disableLinkPreview" not in body
 
+    @responses.activate
+    def test_create_post_serializes_reply_option(self):
+        responses.add(
+            responses.POST,
+            f"{BASE_URL}/tw-v2/interaction/create-post",
+            json={"data": {"id": "1", "action": "create_tweet", "success": True}},
+            status=200,
+        )
+
+        client = make_client()
+        client.post.create_post(
+            auth_token="auth",
+            text="Hello",
+            proxy="h:p@u:p",
+            reply_option={"mode": "followers", "regions": ["US"]},
+        )
+
+        body = json.loads(responses.calls[0].request.body)
+        assert body["replyOption"] == {"mode": "followers", "regions": ["US"]}
+
+    @responses.activate
+    def test_create_post_with_media_preserves_media_id(self):
+        responses.add(
+            responses.POST,
+            f"{BASE_URL}/tw-v2/interaction/create-post-with-media",
+            json={"data": {"id": "1", "action": "create_tweet", "success": True}},
+            status=200,
+        )
+
+        client = make_client()
+        client.post.create_post_with_media(
+            auth_token="auth",
+            text="Hello",
+            media=[{"media_id": "1971008286821380096"}],
+            proxy="h:p@u:p",
+        )
+
+        body = json.loads(responses.calls[0].request.body)
+        assert body["media"] == [{"media_id": "1971008286821380096"}]
+
+
+class TestListParity:
+    @responses.activate
+    def test_create_sends_camel_case_body(self):
+        responses.add(
+            responses.POST,
+            f"{BASE_URL}/tw-v2/list/create",
+            json={"data": {"id": "list-1", "name": "Research"}},
+            status=200,
+        )
+
+        client = make_client()
+        client.list.create(
+            auth_token="auth",
+            name="Research",
+            description="Signals",
+            is_private=False,
+        )
+
+        body = json.loads(responses.calls[0].request.body)
+        assert body == {
+            "authToken": "auth",
+            "name": "Research",
+            "description": "Signals",
+            "isPrivate": False,
+        }
+
+    @responses.activate
+    def test_add_member_sends_camel_case_body_and_strips_none(self):
+        responses.add(
+            responses.POST,
+            f"{BASE_URL}/tw-v2/list/add-member",
+            json={"data": {"success": True}},
+            status=200,
+        )
+
+        client = make_client()
+        client.list.add_member(auth_token="auth", list_id="list-1", user_id="user-1")
+
+        body = json.loads(responses.calls[0].request.body)
+        assert body == {
+            "authToken": "auth",
+            "listId": "list-1",
+            "userId": "user-1",
+        }
+        assert "proxy" not in body
+
+    @responses.activate
+    def test_remove_member_sends_camel_case_body(self):
+        responses.add(
+            responses.POST,
+            f"{BASE_URL}/tw-v2/list/remove-member",
+            json={"data": {"success": True}},
+            status=200,
+        )
+
+        client = make_client()
+        client.list.remove_member(
+            auth_token="auth",
+            list_id="list-1",
+            user_id="user-1",
+            proxy="h:p@u:p",
+        )
+
+        body = json.loads(responses.calls[0].request.body)
+        assert body == {
+            "authToken": "auth",
+            "listId": "list-1",
+            "userId": "user-1",
+            "proxy": "h:p@u:p",
+        }
+
+
+class TestProfileParity:
+    @responses.activate
+    def test_update_sends_body_and_strips_none(self):
+        responses.add(
+            responses.POST,
+            f"{BASE_URL}/tw-v2/profile/update",
+            json={"data": {"id": "user-1", "name": "New Name"}},
+            status=200,
+        )
+
+        client = make_client()
+        client.profile.update(
+            auth_token="auth",
+            name="New Name",
+            bio=None,
+            location="Bangkok",
+        )
+
+        body = json.loads(responses.calls[0].request.body)
+        assert body == {
+            "authToken": "auth",
+            "name": "New Name",
+            "location": "Bangkok",
+        }
+        assert "bio" not in body
+        assert "website" not in body
+        assert "proxy" not in body
+
+    @responses.activate
+    def test_avatar_sends_media_body(self):
+        responses.add(
+            responses.POST,
+            f"{BASE_URL}/tw-v2/profile/avatar",
+            json={"data": {"id": "user-1", "avatar": "https://example.com/a.jpg"}},
+            status=200,
+        )
+
+        client = make_client()
+        client.profile.avatar(
+            auth_token="auth",
+            media={"url": "https://example.com/a.jpg"},
+            proxy="h:p@u:p",
+        )
+
+        body = json.loads(responses.calls[0].request.body)
+        assert body == {
+            "authToken": "auth",
+            "media": {"url": "https://example.com/a.jpg"},
+            "proxy": "h:p@u:p",
+        }
+
+    @responses.activate
+    def test_banner_sends_media_body(self):
+        responses.add(
+            responses.POST,
+            f"{BASE_URL}/tw-v2/profile/banner",
+            json={"data": {"id": "user-1", "banner": "https://example.com/b.jpg"}},
+            status=200,
+        )
+
+        client = make_client()
+        client.profile.banner(
+            auth_token="auth",
+            media={"data": "base64", "type": "image/png"},
+        )
+
+        body = json.loads(responses.calls[0].request.body)
+        assert body == {
+            "authToken": "auth",
+            "media": {"data": "base64", "type": "image/png"},
+        }
+
+
+class TestCommunityParity:
+    @responses.activate
+    def test_create_quote_sends_path_and_body(self):
+        responses.add(
+            responses.POST,
+            f"{BASE_URL}/tw-v2/interaction/create-community-quote",
+            json={"data": {"id": "tweet-1", "success": True}},
+            status=200,
+        )
+
+        client = make_client()
+        client.community.create_quote(
+            auth_token="auth",
+            text="Quote",
+            attachment_url="https://x.com/user/status/1",
+            community_id="community-1",
+            proxy="h:p@u:p",
+            disable_link_preview=True,
+        )
+
+        body = json.loads(responses.calls[0].request.body)
+        assert body == {
+            "authToken": "auth",
+            "text": "Quote",
+            "attachmentUrl": "https://x.com/user/status/1",
+            "communityId": "community-1",
+            "proxy": "h:p@u:p",
+            "disableLinkPreview": True,
+        }
+
+    @responses.activate
+    def test_create_quote_with_media_sends_path_and_body(self):
+        responses.add(
+            responses.POST,
+            f"{BASE_URL}/tw-v2/interaction/create-community-quote-with-media",
+            json={"data": {"id": "tweet-1", "success": True}},
+            status=200,
+        )
+
+        client = make_client()
+        client.community.create_quote_with_media(
+            auth_token="auth",
+            text="Quote",
+            attachment_url="https://x.com/user/status/1",
+            community_id="community-1",
+            media=[{"media_id": "1971008286821380096"}],
+            proxy="h:p@u:p",
+        )
+
+        body = json.loads(responses.calls[0].request.body)
+        assert body == {
+            "authToken": "auth",
+            "text": "Quote",
+            "attachmentUrl": "https://x.com/user/status/1",
+            "communityId": "community-1",
+            "media": [{"media_id": "1971008286821380096"}],
+            "proxy": "h:p@u:p",
+        }
+
 
 class TestErrorHandling:
     @responses.activate

{tweetapi-1.1.0 → tweetapi-1.2.0}/tweetapi/__init__.py

@@ -37,4 +37,4 @@ __all__ = [
     "paginate_pages",
 ]
 
-__version__ = "1.1.0"
+__version__ = "1.2.0"

{tweetapi-1.1.0 → tweetapi-1.2.0}/tweetapi/client.py

@@ -78,6 +78,7 @@ class TweetAPI:
         from .resources.post import PostResource
         from .resources.interaction import InteractionResource
         from .resources.list_ import ListResource
+        from .resources.profile import ProfileResource
         from .resources.community import CommunityResource
         from .resources.space import SpaceResource
         from .resources.explore import ExploreResource
@@ -90,6 +91,7 @@ class TweetAPI:
         self.post = PostResource(self)
         self.interaction = InteractionResource(self)
         self.list = ListResource(self)
+        self.profile = ProfileResource(self)
         self.community = CommunityResource(self)
         self.space = SpaceResource(self)
         self.explore = ExploreResource(self)

{tweetapi-1.1.0 → tweetapi-1.2.0}/tweetapi/resources/community.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Any, Optional, TYPE_CHECKING
+from typing import Optional, TYPE_CHECKING
 
 if TYPE_CHECKING:
     from ..client import TweetAPI
@@ -9,6 +9,7 @@ if TYPE_CHECKING:
         CommunityResponse,
         CommunityMemberPaginatedResponse,
         CommunitySearchPaginatedResponse,
+        TweetMediaInput,
         TweetsPaginatedResponse,
     )
 
@@ -40,13 +41,29 @@ class CommunityResource:
             "proxy": proxy, "disableLinkPreview": disable_link_preview,
         })
 
-    def create_post_with_media(self, *, auth_token: str, text: str, community_id: str, media: list[Any], proxy: str, disable_link_preview: Optional[bool] = None) -> ActionResponse:
+    def create_post_with_media(self, *, auth_token: str, text: str, community_id: str, media: list[TweetMediaInput], proxy: str, disable_link_preview: Optional[bool] = None) -> ActionResponse:
         """Create a post with media in a community."""
         return self._client._post("/tw-v2/interaction/create-community-post-with-media", {
             "authToken": auth_token, "text": text, "communityId": community_id,
             "media": media, "proxy": proxy, "disableLinkPreview": disable_link_preview,
         })
 
+    def create_quote(self, *, auth_token: str, text: str, attachment_url: str, community_id: str, proxy: str, disable_link_preview: Optional[bool] = None) -> ActionResponse:
+        """Create a quote post in a community."""
+        return self._client._post("/tw-v2/interaction/create-community-quote", {
+            "authToken": auth_token, "text": text, "attachmentUrl": attachment_url,
+            "communityId": community_id, "proxy": proxy,
+            "disableLinkPreview": disable_link_preview,
+        })
+
+    def create_quote_with_media(self, *, auth_token: str, text: str, attachment_url: str, community_id: str, media: list[TweetMediaInput], proxy: str, disable_link_preview: Optional[bool] = None) -> ActionResponse:
+        """Create a quote post with media in a community."""
+        return self._client._post("/tw-v2/interaction/create-community-quote-with-media", {
+            "authToken": auth_token, "text": text, "attachmentUrl": attachment_url,
+            "communityId": community_id, "media": media, "proxy": proxy,
+            "disableLinkPreview": disable_link_preview,
+        })
+
     def reply_post(self, *, auth_token: str, text: str, tweet_id: str, community_id: str, proxy: str, disable_link_preview: Optional[bool] = None) -> ActionResponse:
         """Reply to a community post."""
         return self._client._post("/tw-v2/interaction/reply-community-post", {

{tweetapi-1.1.0 → tweetapi-1.2.0}/tweetapi/resources/list_.py

@@ -1,10 +1,11 @@
 from __future__ import annotations
 
-from typing import Any, Optional, TYPE_CHECKING
+from typing import Optional, TYPE_CHECKING
 
 if TYPE_CHECKING:
     from ..client import TweetAPI
     from ..types import (
+        ActionResponse,
         ListResponse,
         TweetsPaginatedResponse,
         UserPaginatedResponse,
@@ -30,3 +31,24 @@ class ListResource:
     def get_followers(self, *, list_id: str, cursor: Optional[str] = None) -> UserPaginatedResponse:
         """Get followers of a list."""
         return self._client._get("/tw-v2/list/followers", {"listId": list_id, "cursor": cursor})
+
+    def create(self, *, auth_token: str, name: str, description: str = "", is_private: bool = True) -> ListResponse:
+        """Create a list."""
+        return self._client._post("/tw-v2/list/create", {
+            "authToken": auth_token, "name": name, "description": description,
+            "isPrivate": is_private,
+        })
+
+    def add_member(self, *, auth_token: str, list_id: str, user_id: str, proxy: Optional[str] = None) -> ActionResponse:
+        """Add a user to a list."""
+        return self._client._post("/tw-v2/list/add-member", {
+            "authToken": auth_token, "listId": list_id, "userId": user_id,
+            "proxy": proxy,
+        })
+
+    def remove_member(self, *, auth_token: str, list_id: str, user_id: str, proxy: Optional[str] = None) -> ActionResponse:
+        """Remove a user from a list."""
+        return self._client._post("/tw-v2/list/remove-member", {
+            "authToken": auth_token, "listId": list_id, "userId": user_id,
+            "proxy": proxy,
+        })

{tweetapi-1.1.0 → tweetapi-1.2.0}/tweetapi/resources/post.py

@@ -4,32 +4,38 @@ from typing import Any, Optional, TYPE_CHECKING
 
 if TYPE_CHECKING:
     from ..client import TweetAPI
-    from ..types import ActionResponse
+    from ..types import ActionResponse, ReplyOption, TweetMediaInput
 
 
 class PostResource:
     def __init__(self, client: TweetAPI) -> None:
         self._client = client
 
-    def create_post(self, *, auth_token: str, text: str, proxy: str, disable_link_preview: Optional[bool] = None) -> ActionResponse:
+    def create_post(self, *, auth_token: str, text: str, proxy: str, disable_link_preview: Optional[bool] = None, reply_option: Optional[ReplyOption] = None) -> ActionResponse:
         """Create a new tweet."""
         return self._client._post("/tw-v2/interaction/create-post", {
             "authToken": auth_token, "text": text, "proxy": proxy,
-            "disableLinkPreview": disable_link_preview,
+            "disableLinkPreview": disable_link_preview, "replyOption": reply_option,
         })
 
-    def create_post_quote(self, *, auth_token: str, text: str, attachment_url: str, proxy: str, disable_link_preview: Optional[bool] = None) -> ActionResponse:
+    def create_post_quote(self, *, auth_token: str, text: str, attachment_url: str, proxy: str, disable_link_preview: Optional[bool] = None, reply_option: Optional[ReplyOption] = None) -> ActionResponse:
         """Create a quote tweet."""
         return self._client._post("/tw-v2/interaction/create-post-quote", {
             "authToken": auth_token, "text": text, "attachmentUrl": attachment_url,
             "proxy": proxy, "disableLinkPreview": disable_link_preview,
+            "replyOption": reply_option,
         })
 
-    def create_post_with_media(self, *, auth_token: str, text: str, media: list[Any], proxy: str, disable_link_preview: Optional[bool] = None) -> ActionResponse:
-        """Create a tweet with media attachments."""
+    def create_post_with_media(self, *, auth_token: str, text: str, media: list[TweetMediaInput], proxy: str, disable_link_preview: Optional[bool] = None, reply_option: Optional[ReplyOption] = None) -> ActionResponse:
+        """Create a tweet with media attachments.
+
+        ``media`` accepts items shaped as ``{"media_id": str}``,
+        ``{"url": str, "type": str | None}``, or ``{"data": str, "type": str}``.
+        """
         return self._client._post("/tw-v2/interaction/create-post-with-media", {
             "authToken": auth_token, "text": text, "media": media,
             "proxy": proxy, "disableLinkPreview": disable_link_preview,
+            "replyOption": reply_option,
         })
 
     def reply_post(self, *, auth_token: str, text: str, tweet_id: str, proxy: str, disable_link_preview: Optional[bool] = None) -> ActionResponse:

tweetapi-1.2.0/tweetapi/resources/profile.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from typing import Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..client import TweetAPI
+    from ..types import ProfileMediaInput, UserResponse
+
+
+class ProfileResource:
+    def __init__(self, client: TweetAPI) -> None:
+        self._client = client
+
+    def update(self, *, auth_token: str, name: Optional[str] = None, bio: Optional[str] = None, location: Optional[str] = None, website: Optional[str] = None, proxy: Optional[str] = None) -> UserResponse:
+        """Update the authenticated user's profile."""
+        return self._client._post("/tw-v2/profile/update", {
+            "authToken": auth_token, "name": name, "bio": bio,
+            "location": location, "website": website, "proxy": proxy,
+        })
+
+    def avatar(self, *, auth_token: str, media: ProfileMediaInput, proxy: Optional[str] = None) -> UserResponse:
+        """Update the authenticated user's avatar."""
+        return self._client._post("/tw-v2/profile/avatar", {
+            "authToken": auth_token, "media": media, "proxy": proxy,
+        })
+
+    def banner(self, *, auth_token: str, media: ProfileMediaInput, proxy: Optional[str] = None) -> UserResponse:
+        """Update the authenticated user's banner."""
+        return self._client._post("/tw-v2/profile/banner", {
+            "authToken": auth_token, "media": media, "proxy": proxy,
+        })

{tweetapi-1.1.0 → tweetapi-1.2.0}/tweetapi/types.py

@@ -6,7 +6,7 @@ All types mirror the API's JSON response shapes exactly.
 
 from __future__ import annotations
 
-from typing import Any, List as TypingList, Optional, TypedDict
+from typing import Any, List as TypingList, Optional, TypedDict, Union
 
 
 # ─── Response Wrappers ───────────────────────────────────────────────────────
@@ -146,6 +146,42 @@ class UserAnalytics(TypedDict, total=False):
 # ─── Media ───────────────────────────────────────────────────────────────────
 
 
+class TweetMediaIdInput(TypedDict):
+    media_id: str
+
+
+class TweetMediaUrlInputRequired(TypedDict):
+    url: str
+
+
+class TweetMediaUrlInput(TweetMediaUrlInputRequired, total=False):
+    type: str
+
+
+class TweetMediaDataInput(TypedDict):
+    data: str
+    type: str
+
+
+TweetMediaInput = Union[TweetMediaIdInput, TweetMediaUrlInput, TweetMediaDataInput]
+
+
+class ProfileMediaUrlInputRequired(TypedDict):
+    url: str
+
+
+class ProfileMediaUrlInput(ProfileMediaUrlInputRequired, total=False):
+    type: str
+
+
+class ProfileMediaDataInput(TypedDict):
+    data: str
+    type: str
+
+
+ProfileMediaInput = Union[ProfileMediaUrlInput, ProfileMediaDataInput]
+
+
 class MediaSize(TypedDict, total=False):
     width: int
     height: int
@@ -280,6 +316,27 @@ class ConversationControl(TypedDict, total=False):
     allowedUserIds: list[str]
 
 
+class ReplyOptionRequired(TypedDict):
+    mode: str
+
+
+class ReplyOption(ReplyOptionRequired, total=False):
+    regions: list[str]
+
+
+class ReactionTargetAuthor(TypedDict, total=False):
+    id: str
+    username: str
+    name: str
+
+
+class ReactionContext(TypedDict, total=False):
+    type: str
+    targetTweetId: str
+    targetTweetUrl: str
+    targetAuthor: ReactionTargetAuthor
+
+
 class Tweet(TypedDict, total=False):
     id: str
     conversationId: Optional[str]
@@ -316,6 +373,7 @@ class Tweet(TypedDict, total=False):
     hasBirdwatchNotes: bool
     birdwatchPivot: Optional[BirdwatchPivot]
     conversationControl: Optional[ConversationControl]
+    reactionContext: Optional[ReactionContext]
     isPromoted: bool
     communityId: Optional[str]
     createdAt: Optional[str]