justoneapi 2.0.3__tar.gz → 3.0.1__tar.gz

{justoneapi-2.0.3 → justoneapi-3.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 2.0.3
+Version: 3.0.1
 Summary: OpenAPI-driven Python SDK for Just One API
 Author-email: Just One API <support@justoneapi.com>
 Requires-Python: >=3.10
@@ -21,9 +21,9 @@ Dynamic: license-file
 
 # Just One API - Python SDK
 
-Official Python SDK for accessing [Just One API](https://justoneapi.com) - a unified data service platform that provides structured data from social media, e-commerce, and content platforms.
+Official Python SDK for accessing [Just One API](https://justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme) - a unified data service platform that provides structured data from social media, e-commerce, and content platforms.
 
-Supported platforms include Taobao & Tmall, Xiaohongshu, Xiaohongshu Pugongying, Douyin, Douyin Xingtu, Kuaishou, Weibo, Bilibili, JD, WeChat, Douban, TikTok, TikTok Shop, Youku, Instagram, YouTube, Reddit, Toutiao, Zhihu, Amazon, Facebook, X (Twitter), Beike, IMDb, and more. To explore the full API catalog, visit the [official website](https://justoneapi.com).
+Supported platforms include Taobao & Tmall, Xiaohongshu, Xiaohongshu Pugongying, Douyin, Douyin Xingtu, Kuaishou, Weibo, Bilibili, JD, WeChat, Douban, TikTok, TikTok Shop, Youku, Instagram, YouTube, Reddit, Toutiao, Zhihu, Amazon, Facebook, X (Twitter), Beike, IMDb, and more. To explore the full API catalog, visit the [official website]([https://justoneapi.com](https://justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)).
 
 ## Installation
 
@@ -86,13 +86,13 @@ All API requests require a valid API token.
 
 Register here:
 
-- [Get API Token](https://dashboard.justoneapi.com/en/register)
+- [Get API Token](https://dashboard.justoneapi.com/en/login?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 ## Documentation
 
 Full API documentation:
 
-- [API Documentation](https://docs.justoneapi.com/en)
+- [API Documentation](https://docs.justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 The documentation includes:
 
@@ -103,13 +103,13 @@ The documentation includes:
 
 ## Official Website
 
-- [Home Page](https://justoneapi.com)
+- [Home Page](https://justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 ## Contact
 
 If you have questions, feedback, or partnership inquiries:
 
-- [Contact Us](https://justoneapi.com/en/contact)
+- [Contact Us](https://justoneapi.com/en/contact?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 ## License
 

{justoneapi-2.0.3 → justoneapi-3.0.1}/README.md

@@ -5,9 +5,9 @@
 
 # Just One API - Python SDK
 
-Official Python SDK for accessing [Just One API](https://justoneapi.com) - a unified data service platform that provides structured data from social media, e-commerce, and content platforms.
+Official Python SDK for accessing [Just One API](https://justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme) - a unified data service platform that provides structured data from social media, e-commerce, and content platforms.
 
-Supported platforms include Taobao & Tmall, Xiaohongshu, Xiaohongshu Pugongying, Douyin, Douyin Xingtu, Kuaishou, Weibo, Bilibili, JD, WeChat, Douban, TikTok, TikTok Shop, Youku, Instagram, YouTube, Reddit, Toutiao, Zhihu, Amazon, Facebook, X (Twitter), Beike, IMDb, and more. To explore the full API catalog, visit the [official website](https://justoneapi.com).
+Supported platforms include Taobao & Tmall, Xiaohongshu, Xiaohongshu Pugongying, Douyin, Douyin Xingtu, Kuaishou, Weibo, Bilibili, JD, WeChat, Douban, TikTok, TikTok Shop, Youku, Instagram, YouTube, Reddit, Toutiao, Zhihu, Amazon, Facebook, X (Twitter), Beike, IMDb, and more. To explore the full API catalog, visit the [official website]([https://justoneapi.com](https://justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)).
 
 ## Installation
 
@@ -70,13 +70,13 @@ All API requests require a valid API token.
 
 Register here:
 
-- [Get API Token](https://dashboard.justoneapi.com/en/register)
+- [Get API Token](https://dashboard.justoneapi.com/en/login?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 ## Documentation
 
 Full API documentation:
 
-- [API Documentation](https://docs.justoneapi.com/en)
+- [API Documentation](https://docs.justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 The documentation includes:
 
@@ -87,13 +87,13 @@ The documentation includes:
 
 ## Official Website
 
-- [Home Page](https://justoneapi.com)
+- [Home Page](https://justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 ## Contact
 
 If you have questions, feedback, or partnership inquiries:
 
-- [Contact Us](https://justoneapi.com/en/contact)
+- [Contact Us](https://justoneapi.com/en/contact?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 ## License
 

justoneapi-3.0.1/justoneapi/_version.py

@@ -0,0 +1 @@
+__version__ = "3.0.1"

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/amazon.py

@@ -68,7 +68,7 @@ class AmazonResource(BaseResource):
         Get Amazon best Sellers data, including rank positions, product metadata, and pricing, for identifying trending products in specific categories, market share analysis and category research, and tracking sales rank and popularity over time.
 
         Args:
-            category: Best sellers category to return products for (e.g. 'software' or 'software/229535').
+            category: Best sellers category to return products for (e.g. 'baby-products' or 'baby-products/166777011'). The value is derived from the URL path of the Amazon Best Sellers page, such as: https://www.amazon.com/Best-Sellers-Baby-Baby-Toddler-Feeding-Supplies/zgbs/baby-products/166777011
             country: Country code for the Amazon product.  Available Values: - `US`: United States - `AU`: Australia - `BR`: Brazil - `CA`: Canada - `CN`: China - `FR`: France - `DE`: Germany - `IN`: India - `IT`: Italy - `MX`: Mexico - `NL`: Netherlands - `SG`: Singapore - `ES`: Spain - `TR`: Turkey - `AE`: United Arab Emirates - `GB`: United Kingdom - `JP`: Japan - `SA`: Saudi Arabia - `PL`: Poland - `SE`: Sweden - `BE`: Belgium - `EG`: Egypt - `ZA`: South Africa - `IE`: Ireland
             page: Page number for pagination.
         """
@@ -81,7 +81,7 @@ class AmazonResource(BaseResource):
             },
         )
 
-    def get_products_by_category_v1(
+    def get_category_products_v1(
         self,
         *,
         category_id: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/bilibili.py

@@ -167,7 +167,7 @@ class BilibiliResource(BaseResource):
             },
         )
 
-    def get_user_relation_stat(
+    def get_user_relation_stat_v1(
         self,
         *,
         wmid: str,
@@ -187,7 +187,7 @@ class BilibiliResource(BaseResource):
             },
         )
 
-    def get_video_caption_v1(
+    def get_video_caption_v2(
         self,
         *,
         bvid: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/douban.py

@@ -35,7 +35,7 @@ class DoubanResource(BaseResource):
             },
         )
 
-    def get_movie_review_details_v1(
+    def get_movie_review_detail_v1(
         self,
         *,
         review_id: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/douyin.py

@@ -29,29 +29,6 @@ class DouyinResource(BaseResource):
             },
         )
 
-    def get_user_video_list_v1(
-        self,
-        *,
-        sec_uid: str,
-        max_cursor: int | None = 0,
-    ) -> ApiResponse[Any]:
-        """
-        User Published Videos
-
-        Get Douyin (TikTok China) user Published Videos data, including captions, covers, and publish times, for account monitoring.
-
-        Args:
-            sec_uid: The unique user ID (sec_uid) on Douyin.
-            max_cursor: Pagination cursor; use 0 for the first page, and the `max_cursor` from the previous response for subsequent pages.
-        """
-        return self._get(
-            "/api/douyin/get-user-video-list/v1",
-            {
-                "secUid": sec_uid,
-                "maxCursor": max_cursor,
-            },
-        )
-
     def get_user_video_list_v3(
         self,
         *,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/douyin_xingtu.py

@@ -206,9 +206,9 @@ class DouyinXingtuResource(BaseResource):
         platform: str | None = "SHORT_VIDEO",
     ) -> ApiResponse[Any]:
         """
-        Marketing Rates
+        Marketing Metrics
 
-        Get Douyin Creator Marketplace (Xingtu) marketing Rates data, including rate card details and commercial service metrics, for creator evaluation, campaign planning, and marketplace research.
+        Get Douyin Creator Marketplace (Xingtu) marketing metrics data, including rate card details and commercial service metrics, for creator evaluation, campaign planning, and marketplace research.
 
         Args:
             o_author_id: Author's unique ID.
@@ -233,9 +233,9 @@ class DouyinXingtuResource(BaseResource):
         flow_type: str | None = "EXCLUDE",
     ) -> ApiResponse[Any]:
         """
-        Distribution Metrics
+        Spread Metrics
 
-        Get Douyin Creator Marketplace (Xingtu) distribution Metrics data, including exposure, spread, and related performance indicators, for creator evaluation, campaign planning, and marketplace research.
+        Get Douyin Creator Marketplace (Xingtu) spread metrics data, including exposure, spread, and related performance indicators, for creator evaluation, campaign planning, and marketplace research.
 
         Args:
             o_author_id: Author's unique ID.
@@ -483,7 +483,7 @@ class DouyinXingtuResource(BaseResource):
         item_id: str,
     ) -> ApiResponse[Any]:
         """
-        Item Report Trend
+        Item Report Trends
 
         Get Douyin Creator Marketplace (Xingtu) item Report Trend data, including time-based changes in item performance metrics, for creator evaluation, campaign planning, and marketplace research.
 
@@ -537,6 +537,115 @@ class DouyinXingtuResource(BaseResource):
             },
         )
 
+    def gw_api_data_get_author_hot_comment_tokens_v1(
+        self,
+        *,
+        o_author_id: str,
+    ) -> ApiResponse[Any]:
+        """
+        KOL Comment Keyword Analysis
+
+        Get Douyin Creator Marketplace (Xingtu) kOL Comment Keyword Analysis data, including core metrics, trend signals, and performance indicators, for audience language analysis and comment-topic research.
+
+        Args:
+            o_author_id: Author's unique ID.
+        """
+        return self._get(
+            "/api/douyin-xingtu/gw/api/data/get_author_hot_comment_tokens/v1",
+            {
+                "oAuthorId": o_author_id,
+            },
+        )
+
+    def gw_api_data_sp_get_author_daily_fans_v1(
+        self,
+        *,
+        o_author_id: str,
+        start_date: str,
+        end_date: str,
+    ) -> ApiResponse[Any]:
+        """
+        Follower Growth Trend
+
+        Get Douyin Creator Marketplace (Xingtu) follower Growth Trend data, including historical audience changes over time, for creator evaluation, campaign planning, and marketplace research.
+
+        Args:
+            o_author_id: Author's unique ID.
+            start_date: Start Date (yyyy-MM-dd).
+            end_date: End Date (yyyy-MM-dd).
+        """
+        return self._get(
+            "/api/douyin-xingtu/gw/api/data_sp/get_author_daily_fans/v1",
+            {
+                "oAuthorId": o_author_id,
+                "startDate": start_date,
+                "endDate": end_date,
+            },
+        )
+
+    def gw_api_gauthor_get_author_content_hot_keywords_v1(
+        self,
+        *,
+        o_author_id: str,
+    ) -> ApiResponse[Any]:
+        """
+        KOL Content Keyword Analysis
+
+        Get Douyin Creator Marketplace (Xingtu) kOL Content Keyword Analysis data, including core metrics, trend signals, and performance indicators, for content theme analysis and creator positioning research.
+
+        Args:
+            o_author_id: Author's unique ID.
+        """
+        return self._get(
+            "/api/douyin-xingtu/gw/api/gauthor/get_author_content_hot_keywords/v1",
+            {
+                "oAuthorId": o_author_id,
+            },
+        )
+
+    def gw_api_aggregator_get_author_commerce_spread_info_v1(
+        self,
+        *,
+        o_author_id: str,
+    ) -> ApiResponse[Any]:
+        """
+        Author Commerce Spread Info
+
+        Get Douyin Creator Marketplace (Xingtu) author Commerce Spread Info data, including spread metrics, for creator evaluation for campaign planning and media buying.
+
+        Args:
+            o_author_id: Author's unique ID.
+        """
+        return self._get(
+            "/api/douyin-xingtu/gw/api/aggregator/get_author_commerce_spread_info/v1",
+            {
+                "oAuthorId": o_author_id,
+            },
+        )
+
+    def gw_api_aggregator_get_author_commerce_seed_base_info_v1(
+        self,
+        *,
+        o_author_id: str,
+        range: str | None = "DAY_90",
+    ) -> ApiResponse[Any]:
+        """
+        Author Commerce Seeding Base Info
+
+        Get Douyin Creator Marketplace (Xingtu) author Commerce Seeding Base Info data, including baseline metrics, commercial signals, and seeding indicators, for product seeding analysis, creator vetting, and campaign planning.
+
+        Args:
+            o_author_id: Author's unique ID.
+            range: Time range.  Available Values: - `DAY_30`: Last 30 days - `DAY_90`: Last 90 days
+        """
+        return self._get(
+            "/api/douyin-xingtu/gw/api/aggregator/get_author_commerce_seed_base_info/v1",
+            {
+                "oAuthorId": o_author_id,
+                "range": range,
+            },
+        )
+
     def get_kol_info_v1(
         self,
         *,
@@ -594,9 +703,9 @@ class DouyinXingtuResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        Follower Profile
+        Follower Distribution
 
-        Get Douyin Creator Marketplace (Xingtu) follower Profile data, including audience demographics, interests, and distribution metrics, for creator evaluation, campaign planning, and marketplace research.
+        Get Douyin Creator Marketplace (Xingtu) follower distribution data, including audience demographics, interests, and distribution metrics, for creator evaluation, campaign planning, and marketplace research.
 
         Args:
             kol_id: KOL ID.
@@ -620,9 +729,9 @@ class DouyinXingtuResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        Marketing Rates
+        Marketing Metrics
 
-        Get Douyin Creator Marketplace (Xingtu) marketing Rates data, including rate card details and commercial service metrics, for creator evaluation, campaign planning, and marketplace research.
+        Get Douyin Creator Marketplace (Xingtu) marketing metrics data, including rate card details and commercial service metrics, for creator evaluation, campaign planning, and marketplace research.
 
         Args:
             kol_id: KOL ID.
@@ -649,9 +758,9 @@ class DouyinXingtuResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        Creator Performance Overview
+        Spread Metrics
 
-        Get Douyin Creator Marketplace (Xingtu) creator Performance Overview data, including audience, content performance, and commercial indicators, for quick evaluation.
+        Get Douyin Creator Marketplace (Xingtu) spread metrics data, including audience, content performance, and commercial indicators, for quick evaluation.
 
         Args:
             kol_id: KOL ID.
@@ -673,29 +782,6 @@ class DouyinXingtuResource(BaseResource):
             },
         )
 
-    def search_douyin_kol_v1(
-        self,
-        *,
-        body: str,
-        accept_cache: bool | None = False,
-    ) -> ApiResponse[Any]:
-        """
-        Legacy KOL Search
-
-        Get Douyin Creator Marketplace (Xingtu) legacy KOL Search data, including preserving the request format, for creator evaluation, campaign planning, and marketplace research.
-
-        Args:
-            body: JSON request body.
-            accept_cache: Enable cache.
-        """
-        return self._get(
-            "/api/douyin-xingtu/search-douyin-kol/v1",
-            {
-                "body": body,
-                "acceptCache": accept_cache,
-            },
-        )
-
     def search_kol_simple_v1(
         self,
         *,
@@ -759,9 +845,9 @@ class DouyinXingtuResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        Video Performance
+        Showcase Items
 
-        Get Douyin Creator Marketplace (Xingtu) video Performance data, including core metrics, trend signals, and performance indicators, for creator evaluation, campaign planning, and marketplace research.
+        Get Douyin Creator Marketplace (Xingtu) showcase items data, including core metrics, trend signals, and performance indicators, for creator evaluation, campaign planning, and marketplace research.
 
         Args:
             kol_id: KOL ID.
@@ -862,9 +948,9 @@ class DouyinXingtuResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        Audience Source Distribution
+        Audience Touchpoint Distribution
 
-        Get Douyin Creator Marketplace (Xingtu) audience Source Distribution data, including segment breakdowns, audience composition, and distribution signals, for traffic analysis and existing integration compatibility.
+        Get Douyin Creator Marketplace (Xingtu) audience touchpoint distribution data, including segment breakdowns, audience composition, and distribution signals, for traffic analysis and existing integration compatibility.
 
         Args:
             kol_id: KOL ID.
@@ -908,9 +994,9 @@ class DouyinXingtuResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        KOL Content Performance
+        Recommended Videos
 
-        Get Douyin Creator Marketplace (Xingtu) kOL Content Performance data, including video performance metrics, for creator evaluation, campaign planning, and marketplace research.
+        Get Douyin Creator Marketplace (Xingtu) recommended videos data, including video performance metrics, for creator evaluation, campaign planning, and marketplace research.
 
         Args:
             kol_id: KOL ID.
@@ -924,32 +1010,6 @@ class DouyinXingtuResource(BaseResource):
             },
         )
 
-    def search_for_author_square_v3(
-        self,
-        *,
-        page: int,
-        fans_low: int,
-        fans_high: int,
-    ) -> ApiResponse[Any]:
-        """
-        Creator Search
-
-        Get Douyin Creator Marketplace (Xingtu) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building.
-
-        Args:
-            page: Page number.
-            fans_low: Minimum fans count.
-            fans_high: Maximum fans count.
-        """
-        return self._get(
-            "/api/douyin-xingtu/search-for-author-square/v3",
-            {
-                "page": page,
-                "fansLow": fans_low,
-                "fansHigh": fans_high,
-            },
-        )
-
     def get_kol_daily_fans_v1(
         self,
         *,
@@ -1051,7 +1111,7 @@ class DouyinXingtuResource(BaseResource):
             },
         )
 
-    def get_author_commerce_seeding_base_info_v1(
+    def get_author_commerce_seed_base_info_v1(
         self,
         *,
         kol_id: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/facebook.py

@@ -9,7 +9,7 @@ from justoneapi._response import ApiResponse
 class FacebookResource(BaseResource):
     """Generated resource for Facebook."""
 
-    def search_v1(
+    def search_post_v1(
         self,
         *,
         keyword: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/imdb.py

@@ -9,7 +9,7 @@ from justoneapi._response import ApiResponse
 class ImdbResource(BaseResource):
     """Generated resource for IMDb."""
 
-    def title_release_expectation_query(
+    def title_release_expectation_query_v1(
         self,
         *,
         id_: str,
@@ -35,7 +35,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_extended_details_query(
+    def title_extended_details_query_v1(
         self,
         *,
         id_: str,
@@ -58,7 +58,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_top_cast_and_crew(
+    def title_top_cast_and_crew_v1(
         self,
         *,
         id_: str,
@@ -81,7 +81,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_base_query(
+    def title_base_query_v1(
         self,
         *,
         id_: str,
@@ -104,7 +104,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_redux_overview_query(
+    def title_redux_overview_query_v1(
         self,
         *,
         id_: str,
@@ -127,7 +127,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_did_you_know_query(
+    def title_did_you_know_query_v1(
         self,
         *,
         id_: str,
@@ -150,7 +150,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_critics_review_summary_query(
+    def title_critics_review_summary_query_v1(
         self,
         *,
         id_: str,
@@ -173,7 +173,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_awards_summary_query(
+    def title_awards_summary_query_v1(
         self,
         *,
         id_: str,
@@ -196,7 +196,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_user_reviews_summary_query(
+    def title_user_reviews_summary_query_v1(
         self,
         *,
         id_: str,
@@ -219,7 +219,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_plot_query(
+    def title_plot_query_v1(
         self,
         *,
         id_: str,
@@ -242,7 +242,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_contribution_questions(
+    def title_contribution_questions_v1(
         self,
         *,
         id_: str,
@@ -265,7 +265,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_details_query(
+    def title_details_query_v1(
         self,
         *,
         id_: str,
@@ -288,7 +288,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_box_office_summary(
+    def title_box_office_summary_v1(
         self,
         *,
         id_: str,
@@ -311,7 +311,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_more_like_this_query(
+    def title_more_like_this_query_v1(
         self,
         *,
         id_: str,
@@ -334,7 +334,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def main_search_query(
+    def main_search_query_v1(
         self,
         *,
         search_term: str,
@@ -363,7 +363,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def streaming_picks_query(
+    def streaming_picks_query_v1(
         self,
         *,
         language_country: str | None = "en_US",
@@ -383,7 +383,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def news_by_category_query(
+    def news_by_category_query_v1(
         self,
         *,
         category: str,
@@ -406,7 +406,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_chart_rankings(
+    def title_chart_rankings_v1(
         self,
         *,
         rankings_chart_type: str,
@@ -429,7 +429,7 @@ class ImdbResource(BaseResource):
             },
         )
 
-    def title_countries_of_origin(
+    def title_countries_of_origin_v1(
         self,
         *,
         id_: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/kuaishou.py

@@ -55,7 +55,7 @@ class KuaishouResource(BaseResource):
             },
         )
 
-    def get_video_details_v2(
+    def get_video_detail_v2(
         self,
         *,
         video_id: str,
@@ -98,7 +98,7 @@ class KuaishouResource(BaseResource):
             },
         )
 
-    def get_user_profile_v1(
+    def get_user_detail_v1(
         self,
         *,
         user_id: str,
@@ -118,7 +118,7 @@ class KuaishouResource(BaseResource):
             },
         )
 
-    def share_link_resolution_v1(
+    def share_url_transfer_v1(
         self,
         *,
         share_url: str,
@@ -138,7 +138,7 @@ class KuaishouResource(BaseResource):
             },
         )
 
-    def get_video_comments_v1(
+    def get_video_comment_v1(
         self,
         *,
         video_id: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/taobao.py

@@ -29,6 +29,26 @@ class TaobaoResource(BaseResource):
             },
         )
 
+    def get_item_detail_v2(
+        self,
+        *,
+        item_id: str,
+    ) -> ApiResponse[Any]:
+        """
+        Product Details
+
+        Get Taobao and Tmall product Details data through the task-backed v2 flow. If data is not ready within a short wait, the response returns a pending task status.
+
+        Args:
+            item_id: AUnique product identifier on Taobao/Tmall (item ID).
+        """
+        return self._get(
+            "/api/taobao/get-item-detail/v2",
+            {
+                "itemId": item_id,
+            },
+        )
+
     def get_item_detail_v4(
         self,
         *,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/weibo.py

@@ -50,7 +50,7 @@ class WeiboResource(BaseResource):
             },
         )
 
-    def get_weibo_details_v1(
+    def get_weibo_detail_v1(
         self,
         *,
         id_: str,
@@ -70,7 +70,7 @@ class WeiboResource(BaseResource):
             },
         )
 
-    def get_user_profile_v3(
+    def get_user_detail_v3(
         self,
         *,
         uid: str,
@@ -136,7 +136,7 @@ class WeiboResource(BaseResource):
             },
         )
 
-    def get_user_published_posts_v1(
+    def get_user_post_v1(
         self,
         *,
         uid: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/weixin.py

@@ -9,7 +9,7 @@ from justoneapi._response import ApiResponse
 class WeixinResource(BaseResource):
     """Generated resource for WeChat Official Accounts."""
 
-    def get_user_post(
+    def get_user_post_v1(
         self,
         *,
         wxid: str,
@@ -29,7 +29,7 @@ class WeixinResource(BaseResource):
             },
         )
 
-    def get_article_feedback(
+    def get_article_feedback_v1(
         self,
         *,
         article_url: str,
@@ -49,7 +49,7 @@ class WeixinResource(BaseResource):
             },
         )
 
-    def get_article_comment(
+    def get_article_comment_v1(
         self,
         *,
         article_url: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/xiaohongshu.py

@@ -227,7 +227,7 @@ class XiaohongshuResource(BaseResource):
             },
         )
 
-    def get_search_note_v2(
+    def search_note_v2(
         self,
         *,
         keyword: str,
@@ -246,7 +246,7 @@ class XiaohongshuResource(BaseResource):
             page: Page number for pagination.
             sort: Sort order for the result set.  Available Values: - `general`: General - `popularity_descending`: Popularity Descending - `time_descending`: Time Descending - `comment_descending`: Comment Descending - `collect_descending`: Collect Descending
             note_type: Note type filter.  Available Values: - `_0`: General - `_1`: Video - `_2`: Normal
-            note_time: Note publish time filter.  Available Values: - `一天内`: Within one day - `一周内`: Within a week - `半年内`: Within half a year
+            note_time: Note publish time filter. This parameter is for reference only and does not have much effect.  Available Values: - `一天内`: Within one day - `一周内`: Within a week - `半年内`: Within half a year
         """
         return self._get(
             "/api/xiaohongshu/search-note/v2",
@@ -259,7 +259,7 @@ class XiaohongshuResource(BaseResource):
             },
         )
 
-    def get_search_note_v3(
+    def search_note_v3(
         self,
         *,
         keyword: str,
@@ -288,7 +288,7 @@ class XiaohongshuResource(BaseResource):
             },
         )
 
-    def get_search_user_v2(
+    def search_user_v2(
         self,
         *,
         keyword: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi/generated/resources/xiaohongshu_pgy.py

@@ -171,9 +171,9 @@ class XiaohongshuPgyResource(BaseResource):
         advertise_switch: str | None = "ALL",
     ) -> ApiResponse[Any]:
         """
-        Note Performance Rates
+        Note Performance Metrics
 
-        Get Xiaohongshu Creator Marketplace (Pugongying) note Performance Rates data, including core metrics, trend signals, and performance indicators, for content efficiency analysis, creator benchmarking, and campaign planning.
+        Get Xiaohongshu Creator Marketplace (Pugongying) note performance metrics data, including core metrics, trend signals, and performance indicators, for content efficiency analysis, creator benchmarking, and campaign planning.
 
         Args:
             user_id: KOL's user ID.
@@ -234,9 +234,9 @@ class XiaohongshuPgyResource(BaseResource):
         user_id: str,
     ) -> ApiResponse[Any]:
         """
-        Follower Profile
+        Follower Distribution
 
-        Get Xiaohongshu Creator Marketplace (Pugongying) follower Profile data, including audience demographics, interests, and distribution metrics, for creator evaluation, campaign planning, and creator benchmarking.
+        Get Xiaohongshu Creator Marketplace (Pugongying) follower distribution data, including audience demographics, interests, and distribution metrics, for creator evaluation, campaign planning, and creator benchmarking.
 
         Args:
             user_id: KOL's user ID.
@@ -398,9 +398,9 @@ class XiaohongshuPgyResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        Note Performance Rates
+        Note Performance Metrics
 
-        Get Xiaohongshu Creator Marketplace (Pugongying) note Performance Rates data, including core metrics, trend signals, and performance indicators, for content efficiency analysis, creator benchmarking, and campaign planning.
+        Get Xiaohongshu Creator Marketplace (Pugongying) note performance metrics data, including core metrics, trend signals, and performance indicators, for content efficiency analysis, creator benchmarking, and campaign planning.
 
         Args:
             kol_id: KOL ID.
@@ -429,9 +429,9 @@ class XiaohongshuPgyResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        Follower Profile
+        Follower Distribution
 
-        Get Xiaohongshu Creator Marketplace (Pugongying) follower Profile data, including audience demographics, interests, and distribution metrics, for creator evaluation, campaign planning, and creator benchmarking.
+        Get Xiaohongshu Creator Marketplace (Pugongying) follower distribution data, including audience demographics, interests, and distribution metrics, for creator evaluation, campaign planning, and creator benchmarking.
 
         Args:
             kol_id: KOL ID.
@@ -452,9 +452,9 @@ class XiaohongshuPgyResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        Follower Analysis
+        Follower Summary
 
-        Get Xiaohongshu Creator Marketplace (Pugongying) follower Analysis data, including core metrics, trend signals, and performance indicators, for creator evaluation, campaign planning, and creator benchmarking.
+        Get Xiaohongshu Creator Marketplace (Pugongying) follower summary data, including core metrics, trend signals, and performance indicators, for creator evaluation, campaign planning, and creator benchmarking.
 
         Args:
             kol_id: KOL ID.
@@ -477,9 +477,9 @@ class XiaohongshuPgyResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        Follower Growth Trend
+        Follower Growth History
 
-        Get Xiaohongshu Creator Marketplace (Pugongying) follower Growth Trend data, including historical audience changes over time, for creator evaluation, campaign planning, and creator benchmarking.
+        Get Xiaohongshu Creator Marketplace (Pugongying) follower growth history data, including historical audience changes over time, for creator evaluation, campaign planning, and creator benchmarking.
 
         Args:
             kol_id: KOL ID.
@@ -532,32 +532,6 @@ class XiaohongshuPgyResource(BaseResource):
             },
         )
 
-    def get_kol_data_summary_v1(
-        self,
-        *,
-        kol_id: str,
-        business: str,
-        accept_cache: bool | None = False,
-    ) -> ApiResponse[Any]:
-        """
-        Creator Performance Overview
-
-        Get Xiaohongshu Creator Marketplace (Pugongying) creator Performance Overview data, including audience, content performance, and commercial indicators, for quick evaluation.
-
-        Args:
-            kol_id: KOL ID.
-            business: Business type.  Available Values: - `_0`: Normal notes - `_1`: Cooperation notes
-            accept_cache: Enable cache.
-        """
-        return self._get(
-            "/api/xiaohongshu-pgy/get-kol-data-summary/v1",
-            {
-                "kolId": kol_id,
-                "business": business,
-                "acceptCache": accept_cache,
-            },
-        )
-
     def get_kol_data_summary_v2(
         self,
         *,
@@ -566,9 +540,9 @@ class XiaohongshuPgyResource(BaseResource):
         accept_cache: bool | None = False,
     ) -> ApiResponse[Any]:
         """
-        Creator Performance Overview
+        Data Summary
 
-        Get Xiaohongshu Creator Marketplace (Pugongying) creator Performance Overview data, including audience, content performance, and commercial indicators, for quick evaluation.
+        Get Xiaohongshu Creator Marketplace (Pugongying) summary data, including activity, engagement, and audience growth, for creator evaluation, campaign planning, and creator benchmarking.
 
         Args:
             kol_id: KOL ID.
@@ -630,7 +604,7 @@ class XiaohongshuPgyResource(BaseResource):
             },
         )
 
-    def get_kol_data_core_v1(
+    def get_kol_core_data_v1(
         self,
         *,
         kol_id: str,

{justoneapi-2.0.3 → justoneapi-3.0.1}/justoneapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 2.0.3
+Version: 3.0.1
 Summary: OpenAPI-driven Python SDK for Just One API
 Author-email: Just One API <support@justoneapi.com>
 Requires-Python: >=3.10
@@ -21,9 +21,9 @@ Dynamic: license-file
 
 # Just One API - Python SDK
 
-Official Python SDK for accessing [Just One API](https://justoneapi.com) - a unified data service platform that provides structured data from social media, e-commerce, and content platforms.
+Official Python SDK for accessing [Just One API](https://justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme) - a unified data service platform that provides structured data from social media, e-commerce, and content platforms.
 
-Supported platforms include Taobao & Tmall, Xiaohongshu, Xiaohongshu Pugongying, Douyin, Douyin Xingtu, Kuaishou, Weibo, Bilibili, JD, WeChat, Douban, TikTok, TikTok Shop, Youku, Instagram, YouTube, Reddit, Toutiao, Zhihu, Amazon, Facebook, X (Twitter), Beike, IMDb, and more. To explore the full API catalog, visit the [official website](https://justoneapi.com).
+Supported platforms include Taobao & Tmall, Xiaohongshu, Xiaohongshu Pugongying, Douyin, Douyin Xingtu, Kuaishou, Weibo, Bilibili, JD, WeChat, Douban, TikTok, TikTok Shop, Youku, Instagram, YouTube, Reddit, Toutiao, Zhihu, Amazon, Facebook, X (Twitter), Beike, IMDb, and more. To explore the full API catalog, visit the [official website]([https://justoneapi.com](https://justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)).
 
 ## Installation
 
@@ -86,13 +86,13 @@ All API requests require a valid API token.
 
 Register here:
 
-- [Get API Token](https://dashboard.justoneapi.com/en/register)
+- [Get API Token](https://dashboard.justoneapi.com/en/login?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 ## Documentation
 
 Full API documentation:
 
-- [API Documentation](https://docs.justoneapi.com/en)
+- [API Documentation](https://docs.justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 The documentation includes:
 
@@ -103,13 +103,13 @@ The documentation includes:
 
 ## Official Website
 
-- [Home Page](https://justoneapi.com)
+- [Home Page](https://justoneapi.com/en?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 ## Contact
 
 If you have questions, feedback, or partnership inquiries:
 
-- [Contact Us](https://justoneapi.com/en/contact)
+- [Contact Us](https://justoneapi.com/en/contact?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme)
 
 ## License
 

{justoneapi-2.0.3 → justoneapi-3.0.1}/tests/test_codegen.py

@@ -90,3 +90,36 @@ def test_diff_summary_reports_operation_changes():
     assert "demoV2 [GET /api/demo/v2]" in summary
     assert "demoV1 [GET /api/demo/v1]" in summary
     assert "Changed operationId count: 1" in summary
+
+
+def test_normalize_spec_derives_method_name_from_path():
+    spec = {
+        "paths": {
+            "/api/demo/v1": {"get": {"operationId": "stillWrong"}},
+            "/api/demo/path-derived/v1": {"get": {"operationId": "totallyWrongMethod"}},
+            "/api/demo/nested/child/v2": {"get": {"operationId": "anotherBadNameV9"}},
+            "/api/demo/get-kol-show-items-v2/v1": {
+                "get": {"operationId": "irrelevantOperationId"}
+            },
+        }
+    }
+
+    normalized = normalize_spec(spec, {})
+
+    assert (
+        normalized["paths"]["/api/demo/v1"]["get"]["x-sdk-method-name"] == "demo_v1"
+    )
+    assert (
+        normalized["paths"]["/api/demo/path-derived/v1"]["get"]["x-sdk-method-name"]
+        == "path_derived_v1"
+    )
+    assert (
+        normalized["paths"]["/api/demo/nested/child/v2"]["get"]["x-sdk-method-name"]
+        == "nested_child_v2"
+    )
+    assert (
+        normalized["paths"]["/api/demo/get-kol-show-items-v2/v1"]["get"][
+            "x-sdk-method-name"
+        ]
+        == "get_kol_show_items_v2_v1"
+    )

{justoneapi-2.0.3 → justoneapi-3.0.1}/tests/test_generated_surface.py

@@ -34,6 +34,11 @@ def test_client_exposes_generated_resources():
         assert type(client.douyin_xingtu).__name__ == "DouyinXingtuResource"
         assert type(client.xiaohongshu_pgy).__name__ == "XiaohongshuPgyResource"
         assert hasattr(client.search, "search_v1")
+        assert hasattr(client.weixin, "get_article_comment_v1")
+        assert hasattr(client.weixin, "get_article_feedback_v1")
+        assert hasattr(client.weixin, "get_user_post_v1")
+        assert hasattr(client.bilibili, "get_user_relation_stat_v1")
+        assert hasattr(client.bilibili, "get_video_caption_v2")
         assert hasattr(client.douyin, "get_video_detail_v2")
         assert hasattr(client.twitter, "get_user_posts_v1")
     finally:

justoneapi-2.0.3/justoneapi/_version.py

@@ -1 +0,0 @@
-__version__ = "2.0.3"