justoneapi 1.0.0__py3-none-any.whl

justoneapi/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "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/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/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/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"

justoneapi/apis/taobao.py

@@ -0,0 +1,158 @@
+from justoneapi import config
+from justoneapi.apis import request_util
+from justoneapi.log import logger
+
+
+class TaobaoAPI:
+    def __init__(self, token):
+        self.token = token
+
+    def get_item_detail_v1(self, item_id: str):
+        url = f"{config.BASE_URL}/api/taobao/get-item-detail/v1"
+        params = {
+            "token": self.token,
+            "itemId": item_id,
+        }
+        return request_util.get_request(url, params)
+
+    def get_item_detail_v2(self, item_id: str):
+        url = f"{config.BASE_URL}/api/taobao/get-item-detail/v2"
+        params = {
+            "token": self.token,
+            "itemId": item_id,
+        }
+        return request_util.get_request(url, params)
+
+    def get_item_detail_v3(self, item_id: str):
+        url = f"{config.BASE_URL}/api/taobao/get-item-detail/v3"
+        params = {
+            "token": self.token,
+            "itemId": item_id,
+        }
+        return request_util.get_request(url, params)
+
+    def get_item_detail_v4(self, item_id: str):
+        url = f"{config.BASE_URL}/api/taobao/get-item-detail/v4"
+        params = {
+            "token": self.token,
+            "itemId": item_id,
+        }
+        return request_util.get_request(url, params)
+
+    def get_item_detail_v5(self, item_id: str):
+        url = f"{config.BASE_URL}/api/taobao/get-item-detail/v5"
+        params = {
+            "token": self.token,
+            "itemId": item_id,
+        }
+        return request_util.get_request(url, params)
+
+    def get_item_comment_v6(self, item_id: str, page: int, order_type: str = None):
+        url = f"{config.BASE_URL}/api/taobao/get-item-comment/v6"
+        params = {
+            "token": self.token,
+            "itemId": item_id,
+            "page": page,
+        }
+        if order_type:
+            params["orderType"] = order_type
+
+        has_next_page = False
+        result, data, message =  request_util.get_request_page(url, params)
+        try:
+            if data:
+                if page < data.get("paginator", {}).get("lastPage", -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_item_comment_v7(self, item_id: str, page: int, order_type: str = None):
+        url = f"{config.BASE_URL}/api/taobao/get-item-comment/v7"
+        params = {
+            "token": self.token,
+            "itemId": item_id,
+            "page": page,
+        }
+        if order_type:
+            params["orderType"] = order_type
+
+        has_next_page = False
+        result, data, message =  request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("hasNext", "false") == "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_social_feed_v1(self, item_id: str, page: int):
+        url = f"{config.BASE_URL}/api/taobao/get-social-feed/v1"
+        params = {
+            "token": self.token,
+            "itemId": item_id,
+            "page": page,
+        }
+
+        has_next_page = False
+        result, data, message =  request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("pagination", {}).get("hasMore", "false") == "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_shop_item_list_v9(self, user_id: str, shop_id: str, sort: str, page: int):
+        url = f"{config.BASE_URL}/api/taobao/get-shop-item-list/v9"
+        params = {
+            "token": self.token,
+            "userId": user_id,
+            "shopId": shop_id,
+            "sort": sort,
+            "page": page,
+        }
+
+        has_next_page = False
+        result, data, message =  request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("itemsArray"):
+                    if page < int(data.get("totalPage", '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
+
+    def get_item_sale_v5(self, item_id: str):
+        url = f"{config.BASE_URL}/api/taobao/get-item-sale/v5"
+        params = {
+            "token": self.token,
+            "itemId": item_id,
+        }
+        return request_util.get_request(url, params)
+
+    def search_item_list_v6(self, keyword: str, sort: str, page: int, tab: str = None):
+        url = f"{config.BASE_URL}/api/taobao/search-item-list/v6"
+        params = {
+            "token": self.token,
+            "keyword": keyword,
+            "sort": sort,
+            "page": page,
+        }
+        if tab:
+            params["tab"] = tab
+
+        has_next_page = False
+        result, data, message =  request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("itemsArray"):
+                    if page < int(data.get("totalPage", '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/apis/user.py

@@ -0,0 +1,23 @@
+from justoneapi import config
+from justoneapi.apis import request_util
+
+
+class UserAPI:
+    def __init__(self, token):
+        self.token = token
+
+    def get_balance(self):
+        url = f"{config.BASE_URL}/user/get-balance"
+        params = {
+            "token": self.token,
+        }
+        return request_util.get_request(url, params)
+
+    def get_record(self, order_year: int, order_month: int):
+        url = f"{config.BASE_URL}/user/get-record"
+        params = {
+            "token": self.token,
+            "orderYear": order_year,
+            "orderMonth": order_month,
+        }
+        return request_util.get_request(url, params)

justoneapi/apis/weibo.py

@@ -0,0 +1,57 @@
+from justoneapi import config
+from justoneapi.apis import request_util
+from justoneapi.log import logger
+
+
+class WeiboAPI:
+    def __init__(self, token):
+        self.token = token
+
+    def search_all_v2(self, q: str, start_day: str, start_hour: int, end_day: str, end_hour: int, page: int):
+        url = f"{config.BASE_URL}/api/weibo/search-all/v2"
+        params = {
+            "token": self.token,
+            "q": q,
+            "startDay": start_day,
+            "startHour": start_hour,
+            "endDay": end_day,
+            "endHour": end_hour,
+            "page": page,
+        }
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("has_next_page", 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_all_v3(self, q: str, page: int):
+        url = f"{config.BASE_URL}/api/weibo/search-all/v3"
+        params = {
+            "token": self.token,
+            "q": q,
+            "page": page,
+        }
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("cards"):
+                    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_weibo_detail_v1(self, id: str):
+        url = f"{config.BASE_URL}/api/weibo/get-weibo-detail/v1"
+        params = {
+            "token": self.token,
+            "id": id,
+        }
+        return request_util.get_request(url, params)
+

justoneapi/apis/xiaohongshu.py

@@ -0,0 +1,139 @@
+from justoneapi import config
+from justoneapi.apis import request_util
+from justoneapi.log import logger
+
+
+class XiaohongshuAPI:
+    def __init__(self, token):
+        self.token = token
+
+    def get_user_v3(self, user_id: str):
+        url = f"{config.BASE_URL}/api/xiaohongshu/get-user/v3"
+        params = {
+            "token": self.token,
+            "userId": user_id,
+        }
+        return request_util.get_request(url, params)
+
+    def get_user_note_list_v4(self, user_id: str, last_cursor: str = None):
+        url = f"{config.BASE_URL}/api/xiaohongshu/get-user-note-list/v4"
+        params = {
+            "token": self.token,
+            "userId": user_id,
+        }
+        if last_cursor:
+            params["lastCursor"] = last_cursor
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                has_more = data.get("has_more")
+                if has_more is not None and isinstance(has_more, bool) and has_more 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_note_detail_v7(self, note_id: str):
+        url = f"{config.BASE_URL}/api/xiaohongshu/get-note-detail/v7"
+        params = {
+            "token": self.token,
+            "noteId": note_id,
+        }
+        return request_util.get_request(url, params)
+
+    def get_note_comment_v2(self, note_id: str, last_cursor: str = None):
+        url = f"{config.BASE_URL}/api/xiaohongshu/get-note-comment/v2"
+        params = {
+            "token": self.token,
+            "noteId": note_id,
+        }
+        if last_cursor:
+            params["lastCursor"] = last_cursor
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                has_more = data.get("has_more")
+                if has_more is not None and isinstance(has_more, bool) and has_more 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_note_sub_comment_v2(self, note_id: str, comment_id: str, last_cursor: str = None):
+        url = f"{config.BASE_URL}/api/xiaohongshu/get-note-sub-comment/v2"
+        params = {
+            "token": self.token,
+            "noteId": note_id,
+            "commentId": comment_id,
+        }
+        if last_cursor:
+            params["lastCursor"] = last_cursor
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                has_more = data.get("has_more")
+                if has_more is not None and isinstance(has_more, bool) and has_more 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_note_v2(self, keyword: str, page: int, sort: str, note_type: str, note_time: str = None):
+        url = f"{config.BASE_URL}/api/xiaohongshu/search-note/v2"
+        params = {
+            "token": self.token,
+            "keyword": keyword,
+            "page": page,
+            "sort": sort,
+            "noteType": note_type,
+        }
+        if note_time:
+            params["noteTime"] = note_time
+
+        has_next_page = False
+        result, data, message = request_util.get_request_page(url, params)
+        try:
+            if data:
+                if data.get("items"):
+                    has_more = data.get("has_more")
+                    if has_more is None or (isinstance(has_more, bool) and has_more 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_user_v2(self, keyword: str, page: int):
+        url = f"{config.BASE_URL}/api/xiaohongshu/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_more = data.get("has_more")
+                    if has_more is None or (isinstance(has_more, bool) and has_more 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_note_feed_v1(self, oid: str, page: int):
+        url = f"{config.BASE_URL}/api/xiaohongshu/get-note-feed/v1"
+        params = {
+            "token": self.token,
+            "oid": oid,
+            "page": page,
+        }
+        return request_util.get_request(url, params)
+

justoneapi/client.py

@@ -0,0 +1,21 @@
+from justoneapi.apis.bilibili import BilibiliAPI
+from justoneapi.apis.douyin import DouyinAPI
+from justoneapi.apis.kuaishou import KuaishouAPI
+from justoneapi.apis.taobao import TaobaoAPI
+from justoneapi.apis.user import UserAPI
+from justoneapi.apis.weibo import WeiboAPI
+from justoneapi.apis.xiaohongshu import XiaohongshuAPI
+
+
+class JustOneAPIClient:
+    def __init__(self, token: str):
+        if not token:
+            raise ValueError("Token is required. Please contact us to obtain one.")
+        self.token = token
+        self.user = UserAPI(self.token)
+        self.taobao = TaobaoAPI(self.token)
+        self.xiaohongshu = XiaohongshuAPI(self.token)
+        self.douyin = DouyinAPI(self.token)
+        self.kuaishou = KuaishouAPI(self.token)
+        self.weibo = WeiboAPI(self.token)
+        self.bilibili = BilibiliAPI(self.token)

justoneapi/config.py

@@ -0,0 +1 @@
+BASE_URL = "http://47.117.133.51:30015"

justoneapi/log.py

@@ -0,0 +1,13 @@
+import logging
+
+logger = logging.getLogger("justoneapi")
+
+# 如果用户未配置过 handler，则添加默认控制台输出
+if not logger.hasHandlers():
+    handler = logging.StreamHandler()
+    formatter = logging.Formatter(
+        '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+    )
+    handler.setFormatter(formatter)
+    logger.addHandler(handler)
+    logger.setLevel(logging.INFO)

justoneapi-1.0.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,18 @@
+justoneapi/__init__.py,sha256=uyfGiipFnhOCQlqywx7wsgp6d-SYnqPqsPQd_xePZl8,23
+justoneapi/client.py,sha256=bHQBLrNJyo8bVqCD_cAJ0HxuNpNy6Vl-eEsYuwaHxNQ,842
+justoneapi/config.py,sha256=YWxWthGg4Xh7IjM1vkqlbBMvSQhW-0lF_wSf3paD9Qk,39
+justoneapi/log.py,sha256=u7gB90CVitO47cA97lYaQJZEqjKzIZEPUuWPOpRFls4,397
+justoneapi/apis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+justoneapi/apis/bilibili.py,sha256=6W2Opbb65mPpBCOLZc1PGKa-ebVCHnj7UzSDDMOyyn4,2807
+justoneapi/apis/douyin.py,sha256=bu_ecjPdYVEuRemrI7Cnk_r0Rbgp5voCNU9zWeKRTKk,4344
+justoneapi/apis/kuaishou.py,sha256=H_KZi8NP2zdS8vU0bxYGqDwDbf7-pjkc37AU2pJx7l8,2656
+justoneapi/apis/request_util.py,sha256=kOUkreLihiLFZV_BI96I7lWFFboYAHtBi16NWsxEc94,1908
+justoneapi/apis/taobao.py,sha256=wwqUwcNTMSff4_GqJv9IWpJb6pOCLo1dhweLmVYrHow,5528
+justoneapi/apis/user.py,sha256=HQAmOTmZ34i4r_IxU62ILCxdPc2Iichud4xmWbEP-gw,645
+justoneapi/apis/weibo.py,sha256=JUGVUIHOwJjjl2QHwQRegmzOEA7MAH7WZZYiX9rlmh8,1858
+justoneapi/apis/xiaohongshu.py,sha256=R8tJsmmjWIXB9MeD8PlkEVDXcbh4hp5K0aIsteva_Ek,5196
+justoneapi-1.0.0.dist-info/licenses/LICENSE,sha256=pAZXnNE2dxxwXFIduGyn1gpvPefJtUYOYZOi3yeGG94,1068
+justoneapi-1.0.0.dist-info/METADATA,sha256=ADg14HYJU4HOaIzPdPy5tthUZVYehflbl1KvU1xnYvE,2711
+justoneapi-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+justoneapi-1.0.0.dist-info/top_level.txt,sha256=9doBh84p8kJHxld542lD2zGnraRN92aWN3f6jEDph7Y,11
+justoneapi-1.0.0.dist-info/RECORD,,

justoneapi-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

justoneapi-1.0.0.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+justoneapi