twitter-openapi-python 0.1.3__tar.gz → 0.1.4__tar.gz

{twitter_openapi_python-0.1.3 → twitter_openapi_python-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: twitter_openapi_python
-Version: 0.1.3
+Version: 0.1.4
 Summary: Twitter OpenAPI
 Keywords: twitter,api,python,scraper
 Author: fa0311
@@ -8,7 +8,7 @@ Author-email: fa0311 <yuki@yuki0311.com>
 License-Expression: LicenseRef-Custom OR AGPL-3.0-or-later
 License-File: LICENSE
 License-File: LICENSE.AGPL
-Requires-Dist: twitter-openapi-python-generated==0.1.3
+Requires-Dist: twitter-openapi-python-generated==0.1.4
 Requires-Dist: pydantic>=2.6
 Requires-Dist: requests>=2.31.0,<3.0.0
 Requires-Dist: urllib3>=2.1.0,<3.0.0
@@ -100,6 +100,19 @@ client.additional_api_headers = {
 };
 ```
 
+### Endpoint
+
+The generated client accepts any host that keeps X's path shape (`/graphql/{queryId}/{operationName}`, `/1.1/...`, `/2/...` under `https://x.com/i/api`). Build the `ApiClient` yourself and hand it to `get_twitter_openapi_python_client`; the login helpers are not involved, so cookies and headers are then up to you (or to whatever answers at that host). For example, [twitter_api_safe_relay](https://github.com/fa0311/twitter_api_safe_relay) answers at `http://localhost:3000/i/api` with a logged-in browser session.
+
+```python
+import twitter_openapi_python_generated as twitter
+from twitter_openapi_python import TwitterOpenapiPython
+
+api_client = twitter.ApiClient(twitter.Configuration(host="http://localhost:3000/i/api"))
+client = TwitterOpenapiPython().get_twitter_openapi_python_client(api_client)
+response = client.get_user_api().get_user_by_screen_name(screen_name="elonmusk")
+```
+
 ## Development
 
 ```shell

{twitter_openapi_python-0.1.3 → twitter_openapi_python-0.1.4}/README.md

@@ -81,6 +81,19 @@ client.additional_api_headers = {
 };
 ```
 
+### Endpoint
+
+The generated client accepts any host that keeps X's path shape (`/graphql/{queryId}/{operationName}`, `/1.1/...`, `/2/...` under `https://x.com/i/api`). Build the `ApiClient` yourself and hand it to `get_twitter_openapi_python_client`; the login helpers are not involved, so cookies and headers are then up to you (or to whatever answers at that host). For example, [twitter_api_safe_relay](https://github.com/fa0311/twitter_api_safe_relay) answers at `http://localhost:3000/i/api` with a logged-in browser session.
+
+```python
+import twitter_openapi_python_generated as twitter
+from twitter_openapi_python import TwitterOpenapiPython
+
+api_client = twitter.ApiClient(twitter.Configuration(host="http://localhost:3000/i/api"))
+client = TwitterOpenapiPython().get_twitter_openapi_python_client(api_client)
+response = client.get_user_api().get_user_by_screen_name(screen_name="elonmusk")
+```
+
 ## Development
 
 ```shell

{twitter_openapi_python-0.1.3 → twitter_openapi_python-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "twitter_openapi_python"
-version = "0.1.3"
+version = "0.1.4"
 description = "Twitter OpenAPI"
 readme = "README.md"
 license = "LicenseRef-Custom OR AGPL-3.0-or-later"
@@ -16,7 +16,7 @@ keywords = [
 ]
 requires-python = ">=3.10"
 dependencies = [
-    "twitter_openapi_python_generated==0.1.3",
+    "twitter_openapi_python_generated==0.1.4",
     "pydantic>=2.6",
     "requests>=2.31.0,<3.0.0",
     "urllib3>=2.1.0,<3.0.0",

{twitter_openapi_python-0.1.3 → twitter_openapi_python-0.1.4}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "twitter_openapi_python"
-version = "0.1.3"
+version = "0.1.4"
 description = "Twitter OpenAPI"
 authors = [{ name = "fa0311", email = "yuki@yuki0311.com" }]
 readme = "README.md"
@@ -9,7 +9,7 @@ license-files = ["LICENSE", "LICENSE.AGPL"]
 keywords = ["twitter", "api", "python", "scraper"]
 requires-python = ">=3.10"
 dependencies = [
-    "twitter_openapi_python_generated==0.1.3",
+    "twitter_openapi_python_generated==0.1.4",
     "pydantic>=2.6",
     "requests>=2.31.0,<3.0.0",
     "urllib3>=2.1.0,<3.0.0",

{twitter_openapi_python-0.1.3 → twitter_openapi_python-0.1.4}/twitter_openapi_python/api/user_api.py

@@ -70,6 +70,7 @@ class UserApiUtils:
         user_id: str,
         extra_param: Optional[ParamType] = None,
     ) -> ResponseType:
+        """Deprecated: X answers 403 outside a browser since 2026-10."""
         param: ParamType = {"userId": user_id}
         if extra_param is not None:
             param.update(extra_param)

{twitter_openapi_python-0.1.3 → twitter_openapi_python-0.1.4}/twitter_openapi_python/api/users_api.py

@@ -46,6 +46,7 @@ class UsersApiUtils:
         user_ids: list[str],
         extra_param: Optional[ParamType] = None,
     ) -> ResponseType:
+        """Deprecated: X answers 403 outside a browser since 2026-10."""
         param: ParamType = {"userIds": user_ids}
         if extra_param is not None:
             param.update(extra_param)

{twitter_openapi_python-0.1.3 → twitter_openapi_python-0.1.4}/twitter_openapi_python/client.py

@@ -69,7 +69,7 @@ class TwitterOpenapiPythonClient:
 
 
 class TwitterOpenapiPython:
-    hash: str = "82d12f1e93e93cd283534f6abb4102bf7dc31c74"
+    hash: str = "8535fd9baca301ede55b10da03495a7d413f5102"
     placeholder_url = "https://raw.githubusercontent.com/fa0311/twitter-openapi/{hash}/src/config/placeholder.json"
     header = "https://raw.githubusercontent.com/fa0311/latest-user-agent/refs/heads/main/header.json"
     access_token: str = (

{twitter_openapi_python-0.1.3 → twitter_openapi_python-0.1.4}/twitter_openapi_python/utils/api.py

@@ -196,7 +196,7 @@ def tweet_results_converter(tweetResults: models.ItemResult) -> Optional[models.
         return properties
     elif isinstance(properties, models.TweetWithVisibilityResults):
         return properties.tweet
-    elif isinstance(properties, models.TweetTombstone):
+    elif isinstance(properties, (models.TweetTombstone, models.TweetUnavailable, models.TweetPreviewDisplay)):
         return None
     raise Exception()