justoneapi 2.0.3__tar.gz → 3.0.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 2.0.3
+Version: 3.0.0
 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.0}/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.0/justoneapi/_version.py

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

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

@@ -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.0}/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.0}/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.0}/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.
@@ -759,9 +868,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 +971,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 +1017,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.
@@ -1051,7 +1160,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.0}/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.0}/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.0}/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.0}/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.0}/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.0}/justoneapi/generated/resources/xiaohongshu.py

@@ -227,7 +227,7 @@ class XiaohongshuResource(BaseResource):
             },
         )
 
-    def get_search_note_v2(
+    def search_note_v2(
         self,
         *,
         keyword: str,
@@ -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.0}/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.
@@ -540,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.
@@ -566,9 +566,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 +630,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.0}/justoneapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 2.0.3
+Version: 3.0.0
 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.0}/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.0}/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"