justoneapi 1.0.0__tar.gz

justoneapi-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [year] [fullname]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

justoneapi-1.0.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: justoneapi
+Version: 1.0.0
+Summary: Official Python SDK for Just One API
+Author-email: Just One API <justoneapi@gmail.com>
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Dynamic: license-file
+
+# Just One API - Python SDK
+
+Official Python SDK for accessing [Just One API](https://justoneapi.com) — a unified data service platform offering structured data from Social, E-commerce platforms such as Xiaohongshu, Taobao, Douyin, Kuaishou, Bilibili, and Weibo.
+
+This SDK simplifies API integration and request signing, allowing developers to easily retrieve platform-specific data with minimal setup.
+
+---
+
+## 🚀 Installation
+
+Install via PyPI:
+
+```bash
+pip install justoneapi
+```
+
+---
+
+## 🛠 Quick Start
+
+```python
+from justoneapi.client import JustOneAPIClient
+
+client = JustOneAPIClient(token="your_token")
+
+# Example: Get Douyin Video detail
+result, data, message = client.douyin.get_video_detail_v2(video_id="7428906452091145483")
+print(result)
+print(data)
+print(message)
+
+# Example: Douyin Video Search
+result, data, message, has_next_page = client.douyin.search_video_v4(keyword="deepseek", sort_type="_0", publish_time="_0", duration="_0", page=1)
+print(result)
+print(data)
+print(message)
+print(has_next_page)
+```
+
+### 📦 Return Value Description
+
+Each API method returns one or more of the following values:
+
+| Variable         | Type     | Description |
+|------------------|----------|-------------|
+| `result`         | `bool`   | Whether the request was successful. `True` means success, `False` means failure. |
+| `data`           | `dict` / `list` | The actual data returned from the API. Structure varies by endpoint. |
+| `message`        | `str`    | Message from the server. Contains error info when request fails. |
+| `has_next_page`  | `bool`   | Present in paginated APIs. Indicates whether more data is available. |
+
+---
+
+## 🔐 Authentication
+
+All API requests require a valid API token.  
+You can obtain your token by contact us:  
+👉 [Contact](https://justoneapi.com/contact)
+
+---
+
+## 📚 Documentation
+
+👉 Full API docs: [https://justoneapi.com/docs](https://doc.justoneapi.com)
+
+Includes:
+- Request parameters
+- Response fields
+- Error codes
+
+---
+
+## 🏠 Official Website
+
+👉 [https://justoneapi.com](https://justoneapi.com)
+
+Learn more about the project, data sources, and commercial integration opportunities.
+
+---
+
+## 📬 Contact Us
+
+If you have any questions, feedback, or partnership inquiries:
+
+- Email: **justoneapi@gmail.com**
+- Telegram: [@justoneapi](https://t.me/justoneapi)
+
+---
+
+## 🪪 License
+
+This project is licensed under the MIT License.  
+See the [LICENSE](./LICENSE) file for details.

justoneapi-1.0.0/README.md

@@ -0,0 +1,92 @@
+# Just One API - Python SDK
+
+Official Python SDK for accessing [Just One API](https://justoneapi.com) — a unified data service platform offering structured data from Social, E-commerce platforms such as Xiaohongshu, Taobao, Douyin, Kuaishou, Bilibili, and Weibo.
+
+This SDK simplifies API integration and request signing, allowing developers to easily retrieve platform-specific data with minimal setup.
+
+---
+
+## 🚀 Installation
+
+Install via PyPI:
+
+```bash
+pip install justoneapi
+```
+
+---
+
+## 🛠 Quick Start
+
+```python
+from justoneapi.client import JustOneAPIClient
+
+client = JustOneAPIClient(token="your_token")
+
+# Example: Get Douyin Video detail
+result, data, message = client.douyin.get_video_detail_v2(video_id="7428906452091145483")
+print(result)
+print(data)
+print(message)
+
+# Example: Douyin Video Search
+result, data, message, has_next_page = client.douyin.search_video_v4(keyword="deepseek", sort_type="_0", publish_time="_0", duration="_0", page=1)
+print(result)
+print(data)
+print(message)
+print(has_next_page)
+```
+
+### 📦 Return Value Description
+
+Each API method returns one or more of the following values:
+
+| Variable         | Type     | Description |
+|------------------|----------|-------------|
+| `result`         | `bool`   | Whether the request was successful. `True` means success, `False` means failure. |
+| `data`           | `dict` / `list` | The actual data returned from the API. Structure varies by endpoint. |
+| `message`        | `str`    | Message from the server. Contains error info when request fails. |
+| `has_next_page`  | `bool`   | Present in paginated APIs. Indicates whether more data is available. |
+
+---
+
+## 🔐 Authentication
+
+All API requests require a valid API token.  
+You can obtain your token by contact us:  
+👉 [Contact](https://justoneapi.com/contact)
+
+---
+
+## 📚 Documentation
+
+👉 Full API docs: [https://justoneapi.com/docs](https://doc.justoneapi.com)
+
+Includes:
+- Request parameters
+- Response fields
+- Error codes
+
+---
+
+## 🏠 Official Website
+
+👉 [https://justoneapi.com](https://justoneapi.com)
+
+Learn more about the project, data sources, and commercial integration opportunities.
+
+---
+
+## 📬 Contact Us
+
+If you have any questions, feedback, or partnership inquiries:
+
+- Email: **justoneapi@gmail.com**
+- Telegram: [@justoneapi](https://t.me/justoneapi)
+
+---
+
+## 🪪 License
+
+This project is licensed under the MIT License.  
+See the [LICENSE](./LICENSE) file for details.

justoneapi-1.0.0/justoneapi/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "1.0.0"
+

justoneapi-1.0.0/justoneapi/apis/bilibili.py

@@ -0,0 +1,82 @@
+from justoneapi import config
+from justoneapi.apis import request_util
+from justoneapi.log import logger
+
+
+class BilibiliAPI:
+    def __init__(self, token):
+        self.token = token
+
+    def get_video_detail_v2(self, bvid: str):
+        url = f"{config.BASE_URL}/api/bilibili/get-video-detail/v2"
+        params = {
+            "token": self.token,
+            "bvid": bvid,
+        }
+        return request_util.get_request(url, params)
+
+    def get_user_video_list_v2(self, uid: str, aid: str = None):
+        url = f"{config.BASE_URL}/api/bilibili/get-user-video-list/v2"
+        params = {
+            "token": self.token,
+            "uid": uid,
+        }
+        if aid:
+            params["aid"] = aid
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("data", {}).get("has_next", False) is True:
+                    has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page
+
+    def get_user_detail_v2(self, uid: str):
+        url = f"{config.BASE_URL}/api/bilibili/get-user-detail/v2"
+        params = {
+            "token": self.token,
+            "uid": uid,
+        }
+        return request_util.get_request(url, params)
+
+    def get_video_comment_v2(self, aid: str, cursor: str = None):
+        url = f"{config.BASE_URL}/api/bilibili/get-video-comment/v2"
+        params = {
+            "token": self.token,
+            "aid": aid,
+        }
+        if cursor:
+            params["cursor"] = cursor
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("data", {}).get("has_next", False) is True:
+                    has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page
+
+    def search_video_v2(self, keyword: str, page: int):
+        url = f"{config.BASE_URL}/api/bilibili/search-video/v2"
+        params = {
+            "token": self.token,
+            "keyword": keyword,
+            "page": page,
+        }
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("data", {}).get("result"):
+                    if page < data.get("data", {}).get("numPages", 0):
+                        has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page
+

justoneapi-1.0.0/justoneapi/apis/douyin.py

@@ -0,0 +1,121 @@
+from justoneapi import config
+from justoneapi.apis import request_util
+from justoneapi.log import logger
+
+
+class DouyinAPI:
+    def __init__(self, token):
+        self.token = token
+
+    def get_user_detail_v3(self, sec_uid: str):
+        url = f"{config.BASE_URL}/api/douyin/get-user-detail/v3"
+        params = {
+            "token": self.token,
+            "secUid": sec_uid,
+        }
+        return request_util.get_request(url, params)
+
+    def get_user_video_list_v3(self, sec_uid: str, max_cursor: int):
+        url = f"{config.BASE_URL}/api/douyin/get-user-video-list/v3"
+        params = {
+            "token": self.token,
+            "secUid": sec_uid,
+            "maxCursor": max_cursor,
+        }
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("has_more") == 1:
+                    has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page
+
+    def get_video_detail_v2(self, video_id: str):
+        url = f"{config.BASE_URL}/api/douyin/get-video-detail/v2"
+        params = {
+            "token": self.token,
+            "videoId": video_id,
+        }
+        return request_util.get_request(url, params)
+
+    def search_video_v4(self, keyword: str, sort_type: str, publish_time: str, duration: str, page: int, search_id: str = None):
+        url = f"{config.BASE_URL}/api/douyin/search-video/v4"
+        params = {
+            "token": self.token,
+            "keyword": keyword,
+            "sortType": sort_type,
+            "publishTime": publish_time,
+            "duration": duration,
+            "page": page,
+        }
+        if search_id:
+            params["searchId"] = search_id
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("business_config", {}).get("has_more", 0) == 1:
+                    has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page
+
+    def search_user_v2(self, keyword: str, page: int, user_type: str = None):
+        url = f"{config.BASE_URL}/api/douyin/search-user/v2"
+        params = {
+            "token": self.token,
+            "keyword": keyword,
+            "page": page,
+        }
+        if user_type:
+            params["userType"] = user_type
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("business_config", {}).get("has_more", 0) == 1:
+                    has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page
+
+    def get_video_comment_v1(self, aweme_id: str, page: int):
+        url = f"{config.BASE_URL}/api/douyin/get-video-comment/v1"
+        params = {
+            "token": self.token,
+            "awemeId": aweme_id,
+            "page": page,
+        }
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("has_more") == 1:
+                    has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page
+
+    def get_video_sub_comment_v1(self, comment_id: str, page: int):
+        url = f"{config.BASE_URL}/api/douyin/get-video-sub-comment/v1"
+        params = {
+            "token": self.token,
+            "commentId": comment_id,
+            "page": page,
+        }
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("has_more") == 1:
+                    has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page

justoneapi-1.0.0/justoneapi/apis/kuaishou.py

@@ -0,0 +1,80 @@
+from justoneapi import config
+from justoneapi.apis import request_util
+from justoneapi.log import logger
+
+
+class KuaishouAPI:
+    def __init__(self, token):
+        self.token = token
+
+    def search_user_v2(self, keyword: str, page: int):
+        url = f"{config.BASE_URL}/api/kuaishou/search-user/v2"
+        params = {
+            "token": self.token,
+            "keyword": keyword,
+            "page": page,
+        }
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("users"):
+                    has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page
+
+    def get_user_video_list_v2(self, user_id: str, pcursor: str = None):
+        url = f"{config.BASE_URL}/api/kuaishou/get-user-video-list/v2"
+        params = {
+            "token": self.token,
+            "userId": user_id,
+        }
+        if pcursor:
+            params["pcursor"] = pcursor
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("feeds"):
+                    has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page
+
+    def get_video_detail_v2(self, video_id: str):
+        url = f"{config.BASE_URL}/api/kuaishou/get-video-detail/v2"
+        params = {
+            "token": self.token,
+            "videoId": video_id,
+        }
+        return request_util.get_request(url, params)
+
+    def search_video_v2(self, keyword: str, page: int):
+        url = f"{config.BASE_URL}/api/kuaishou/search-video/v2"
+        params = {
+            "token": self.token,
+            "keyword": keyword,
+            "page": page,
+        }
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("feeds"):
+                    has_next_page = True
+        except Exception as e:
+            logger.warning(f"Pagination parse error at {url}. Contact us to fix it.")
+        return result, data, message, has_next_page
+
+    def get_user_detail_v2(self, user_id: str):
+        url = f"{config.BASE_URL}/api/kuaishou/get-user-detail/v1"
+        params = {
+            "token": self.token,
+            "userId": user_id,
+        }
+        return request_util.get_request(url, params)
+

justoneapi-1.0.0/justoneapi/apis/request_util.py

@@ -0,0 +1,58 @@
+import requests
+from justoneapi import __version__
+
+from justoneapi.log import logger
+
+
+def _request(method: str, url: str, params: dict, timeout: int) -> requests.Response:
+    headers = {
+        "JUSTONEAPI_PYTHON_SKD_VERSION": __version__,
+    }
+    response = requests.request(method, url, params=params, timeout=timeout, headers=headers)
+
+    log_message = response.headers.get("JUSTONEAPI_PYTHON_SDK_LOG_MESSAGE")
+    if log_message:
+        logger.warning(log_message)
+    version_deprecated = response.headers.get("JUSTONEAPI_PYTHON_SDK_VERSION_DEPRECATED")
+    if version_deprecated:
+        raise RuntimeError(f"JustoneAPI Python SDK version {__version__} is deprecated, please update to the latest version.")
+
+    return response
+
+
+def get_request(url: str, params: dict):
+    try:
+        response_data = _request(method="GET", url=url, params=params, timeout=60).json()
+        code = response_data["code"]
+        data = response_data["data"]
+        message = response_data["message"]
+
+        if code == 0:
+            return True, data, message
+        if str(code).startswith('2'):
+            return True, data, message
+        return False, data, message
+    except RuntimeError as re:
+        raise re
+    except Exception as e:
+        logger.exception(e)
+        return False, None, "request error"
+
+
+def get_request_page(url: str, params: dict):
+    try:
+        response_data = _request(method="GET", url=url, params=params, timeout=60).json()
+        code = response_data["code"]
+        data = response_data["data"]
+        message = response_data["message"]
+
+        if code == 0:
+            return True, data, message
+        if str(code).startswith('2'):
+            return True, data, message
+        return False, data, message
+    except RuntimeError as re:
+        raise re
+    except Exception as e:
+        logger.exception(e)
+        return False, None, "request error"