justoneapi 2.0.2__tar.gz → 3.0.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 2.0.2
+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.2 → 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.2 → justoneapi-3.0.0}/justoneapi/generated/models.py

@@ -13,6 +13,7 @@ class Code(Enum):
     field_0 = "0"
     field_100 = "100"
     field_101 = "101"
+    field_202 = "202"
     field_300 = "300"
     field_301 = "301"
     field_302 = "302"

{justoneapi-2.0.2 → justoneapi-3.0.0}/justoneapi/generated/resources/__init__.py

@@ -5,6 +5,7 @@ from justoneapi.generated.resources.beike import BeikeResource
 from justoneapi.generated.resources.bilibili import BilibiliResource
 from justoneapi.generated.resources.douban import DoubanResource
 from justoneapi.generated.resources.douyin import DouyinResource
+from justoneapi.generated.resources.douyin_ec import DouyinEcResource
 from justoneapi.generated.resources.douyin_xingtu import DouyinXingtuResource
 from justoneapi.generated.resources.facebook import FacebookResource
 from justoneapi.generated.resources.imdb import ImdbResource
@@ -18,6 +19,7 @@ from justoneapi.generated.resources.tiktok import TiktokResource
 from justoneapi.generated.resources.tiktok_shop import TiktokShopResource
 from justoneapi.generated.resources.toutiao import ToutiaoResource
 from justoneapi.generated.resources.twitter import TwitterResource
+from justoneapi.generated.resources.web import WebResource
 from justoneapi.generated.resources.weibo import WeiboResource
 from justoneapi.generated.resources.weixin import WeixinResource
 from justoneapi.generated.resources.xiaohongshu import XiaohongshuResource
@@ -32,6 +34,7 @@ RESOURCE_CLASSES = {
     "bilibili": BilibiliResource,
     "douban": DoubanResource,
     "douyin": DouyinResource,
+    "douyin_ec": DouyinEcResource,
     "douyin_xingtu": DouyinXingtuResource,
     "facebook": FacebookResource,
     "imdb": ImdbResource,
@@ -45,6 +48,7 @@ RESOURCE_CLASSES = {
     "tiktok_shop": TiktokShopResource,
     "toutiao": ToutiaoResource,
     "twitter": TwitterResource,
+    "web": WebResource,
     "weibo": WeiboResource,
     "weixin": WeixinResource,
     "xiaohongshu": XiaohongshuResource,
@@ -60,6 +64,7 @@ __all__ = [
     "BilibiliResource",
     "DoubanResource",
     "DouyinResource",
+    "DouyinEcResource",
     "DouyinXingtuResource",
     "FacebookResource",
     "ImdbResource",
@@ -73,6 +78,7 @@ __all__ = [
     "TiktokShopResource",
     "ToutiaoResource",
     "TwitterResource",
+    "WebResource",
     "WeiboResource",
     "WeixinResource",
     "XiaohongshuResource",

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

@@ -16,16 +16,9 @@ class AmazonResource(BaseResource):
         country: str | None = "US",
     ) -> ApiResponse[Any]:
         """
-        Product Details (V1)
+        Product Details
 
-        Retrieves detailed product information from Amazon based on the provided ASIN.
-        It returns core product data such as title, brand, price, availability, rating,
-        review count, product images, category information, and other publicly available details.
-
-        Typical use cases:
-        - Building product catalogs and enriching item content (e.g., images)
-        - Price monitoring and availability tracking
-        - E-commerce analytics and competitor tracking
+        Get Amazon product Details data, including title, brand, and price, for building product catalogs and enriching item content (e.g., images), price monitoring and availability tracking, and e-commerce analytics and competitor tracking.
 
         Args:
             asin: ASIN (Amazon Standard Identification Number).
@@ -46,16 +39,9 @@ class AmazonResource(BaseResource):
         country: str | None = "US",
     ) -> ApiResponse[Any]:
         """
-        Product Top Reviews (V1)
-
-        Retrieves top (most relevant or most helpful) public reviews for an Amazon product based on the provided ASIN.
-        It returns review details such as review ID, reviewer name, rating score,
-        review title, review content, publish time, and helpful vote count (if available).
+        Product Top Reviews
 
-        Typical use cases:
-        - Sentiment analysis and consumer feedback tracking
-        - Product research and quality assessment
-        - Monitoring competitor customer experience
+        Get Amazon product Top Reviews data, including most helpful) public reviews, for sentiment analysis and consumer feedback tracking, product research and quality assessment, and monitoring competitor customer experience.
 
         Args:
             asin: ASIN (Amazon Standard Identification Number).
@@ -77,15 +63,9 @@ class AmazonResource(BaseResource):
         page: int | None = 1,
     ) -> ApiResponse[Any]:
         """
-        Best Sellers (V1)
+        Best Sellers
 
-        Retrieves top performing products for a given category on Amazon.
-        Supports top level best sellers categories (e.g. software). In addition, subcategories / category path can be specified.
-
-        Typical use cases:
-        - Identifying trending products in specific categories
-        - Market share analysis and category research
-        - Tracking sales rank and popularity over time
+        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').
@@ -101,7 +81,7 @@ class AmazonResource(BaseResource):
             },
         )
 
-    def get_products_by_category_v1(
+    def get_category_products_v1(
         self,
         *,
         category_id: str,
@@ -110,15 +90,9 @@ class AmazonResource(BaseResource):
         page: int | None = 1,
     ) -> ApiResponse[Any]:
         """
-        Products By Category (V1)
-
-        Retrieves products under a specified Amazon category.
-            Supports category-based product discovery and returns product information such as title, price, rating, review count, and other available marketplace fields.
+        Products By Category
 
-            Typical use cases:
-            - Discovering products within a specific category
-            - Category research and competitor analysis
-            - Monitoring product assortment, pricing, and popularity trends
+        Get Amazon products By Category data, including title, price, and rating, for category-based product discovery and returns product information such as title, price, and rating.
 
         Args:
             category_id: For example: https://amazon.com/s?node=172282 - the Amazon Category ID is 172282

{justoneapi-2.0.2 → justoneapi-3.0.0}/justoneapi/generated/resources/beike.py

@@ -16,19 +16,9 @@ class BeikeResource(BaseResource):
         house_code: str,
     ) -> ApiResponse[Any]:
         """
-        Resale Housing Details (V1)
+        Resale Housing Details
 
-        Retrieves comprehensive information for a specific second-hand property listing on Beike (Lianjia).
-
-        The data includes:
-        - Pricing (total and unit price).
-        - Physical attributes (area, layout, floor, orientation).
-        - Listing metadata (tags, listing date).
-        - Agent contact information.
-
-        Typical use cases:
-        - Displaying a full property profile to users.
-        - Detailed price comparison between specific listings.
+        Get Beike resale Housing Details data, including - Pricing (total and unit price), Physical attributes (area, and layout, for displaying a full property profile to users and detailed price comparison between specific listings.
 
         Args:
             city_id: The ID of the city (e.g., '110000' for Beijing).
@@ -50,18 +40,9 @@ class BeikeResource(BaseResource):
         offset: int | None = 0,
     ) -> ApiResponse[Any]:
         """
-        Resale Housing List (V1)
-
-        Fetches a list of second-hand property listings from Beike (Lianjia) based on specified filters.
+        Resale Housing List
 
-        Key features:
-        - Supports filtering by city/region, price range, layout, and area.
-        - Returns core listing details such as title, total price, unit price, and community info.
-        - Provides house codes for fetching full details via the detail API.
-
-        Typical use cases:
-        - Building search result pages for property portals.
-        - Aggregating market data for regional housing trends.
+        Get Beike resale Housing List data, including - Supports filtering by city/region, price range, and layout, for building search result pages for property portals and aggregating market data for regional housing trends.
 
         Args:
             city_id: The ID of the city (e.g., '110000' for Beijing).
@@ -85,20 +66,9 @@ class BeikeResource(BaseResource):
         limit_offset: int | None = 0,
     ) -> ApiResponse[Any]:
         """
-        Community List (V1)
-
-        Retrieves a list of residential communities (Xiaoqu) from Beike (Lianjia) within a specified city.
-
-        The data includes:
-        - Community name and unique ID.
-        - Average listing price and historical price trends.
-        - Build year and architectural details.
-        - Geographical coordinates and location information.
+        Community List
 
-        Typical use cases:
-        - Identifying popular residential areas in a city.
-        - Comparing average housing prices across different communities.
-        - Spatial analysis of property development patterns.
+        Get Beike community List data, including - Community name and unique ID and Average listing price and historical price trends, for identifying popular residential areas in a city and comparing average housing prices across different communities.
 
         Args:
             city_id: The ID of the city (e.g., '110000' for Beijing).

{justoneapi-2.0.2 → justoneapi-3.0.0}/justoneapi/generated/resources/bilibili.py

@@ -15,13 +15,9 @@ class BilibiliResource(BaseResource):
         bvid: str,
     ) -> ApiResponse[Any]:
         """
-        Video Details (V2)
+        Video Details
 
-        Retrieve comprehensive details about a specific Bilibili video, including metadata (title, tags, publishing time), statistics (views, likes, danmaku count), and uploader profile information.
-
-        Typical use cases:
-        - Tracking video performance and engagement metrics.
-        - Analyzing content metadata and uploader information.
+        Get Bilibili video Details data, including metadata (title, tags, and publishing time), for tracking video performance and engagement metrics and analyzing content metadata and uploader information.
 
         Args:
             bvid: Bilibili Video ID (BVID).
@@ -40,13 +36,9 @@ class BilibiliResource(BaseResource):
         param: str | None = None,
     ) -> ApiResponse[Any]:
         """
-        User Published Videos (V2)
-
-        Retrieve a list of videos published by a specific Bilibili user, including video metadata, cover images, and engagement metrics.
+        User Published Videos
 
-        Typical use cases:
-        - Monitoring creator's content updates and publishing patterns.
-        - Building user-specific video catalogs for analysis.
+        Get Bilibili user Published Videos data, including titles, covers, and publish times, for creator monitoring and content performance analysis.
 
         Args:
             uid: Bilibili User ID (UID).
@@ -66,13 +58,9 @@ class BilibiliResource(BaseResource):
         uid: str,
     ) -> ApiResponse[Any]:
         """
-        User Profile (V2)
-
-        Retrieve detailed profile information of a specific Bilibili user, including username, avatar, level, and verification status.
+        User Profile
 
-        Typical use cases:
-        - Analyzing creator's profile, level, and verification status.
-        - Verifying user identity and social presence on Bilibili.
+        Get Bilibili user Profile data, including account metadata, audience metrics, and verification-related fields, for analyzing creator's profile, level, and verification status and verifying user identity and social presence on bilibili.
 
         Args:
             uid: Bilibili User ID (UID).
@@ -92,13 +80,9 @@ class BilibiliResource(BaseResource):
         page: str | None = None,
     ) -> ApiResponse[Any]:
         """
-        Video Danmaku (V2)
+        Video Danmaku
 
-        Retrieve danmaku (rolling comments) for a specific Bilibili video.
-
-        Typical use cases:
-        - Analyzing real-time viewer reactions and community trends.
-        - Sentiment analysis based on rolling comments.
+        Get Bilibili video Danmaku data, including timeline positions and comment text, for audience reaction analysis and subtitle-style comment review.
 
         Args:
             aid: Bilibili Archive ID (AID).
@@ -121,13 +105,9 @@ class BilibiliResource(BaseResource):
         cursor: str | None = None,
     ) -> ApiResponse[Any]:
         """
-        Video Comments (V2)
-
-        Retrieve top-level comments for a specific Bilibili video, including commenter info, text, likes, and timestamps.
+        Video Comments
 
-        Typical use cases:
-        - Gathering detailed viewer feedback and community discussions.
-        - Sentiment analysis and public opinion monitoring.
+        Get Bilibili video Comments data, including commenter profiles, text, and likes, for sentiment analysis and comment moderation workflows.
 
         Args:
             aid: Bilibili Archive ID (AID).
@@ -149,13 +129,9 @@ class BilibiliResource(BaseResource):
         order: str | None = "general",
     ) -> ApiResponse[Any]:
         """
-        Video Search (V2)
+        Video Search
 
-        Search for Bilibili videos based on keywords, returning matched videos with metadata, author information, and engagement stats.
-
-        Typical use cases:
-        - Discovering trending videos or creators by specific keywords.
-        - Competitive analysis and market research on Bilibili.
+        Get Bilibili video Search data, including matched videos, creators, and engagement metrics, for topic research and content discovery.
 
         Args:
             keyword: Search keyword.
@@ -177,16 +153,9 @@ class BilibiliResource(BaseResource):
         share_url: str,
     ) -> ApiResponse[Any]:
         """
-        Share Link Resolution (V1)
-
-        Resolve Bilibili share URLs (e.g., https://b23.tv/...) to get the original content metadata.
-
-        Typical use cases:
-        - Converting shortened mobile share links to standard BVID/metadata.
-        - Automating content extraction from shared social media links.
+        Share Link Resolution
 
-        Highlights
-        - Only supports share URLs starting with 'https://b23.tv/'.
+        Get Bilibili share Link Resolution data, including resolved video and page identifier, for converting shortened mobile share links to standard bvid/metadata and automating content extraction from shared social media links.
 
         Args:
             share_url: Bilibili share URL (must start with https://b23.tv/).
@@ -198,19 +167,15 @@ class BilibiliResource(BaseResource):
             },
         )
 
-    def get_user_relation_stat(
+    def get_user_relation_stat_v1(
         self,
         *,
         wmid: str,
     ) -> ApiResponse[Any]:
         """
-        User Relation Stats (V1)
+        User Relation Stats
 
-        Retrieve follower count and following count for a specific Bilibili user.
-
-        Typical use cases:
-        - Tracking creator's follower growth and audience reach.
-        - Analyzing social influence and account popularity.
+        Get Bilibili user Relation Stats data, including following counts, for creator benchmarking and audience growth tracking.
 
         Args:
             wmid: Bilibili User ID (WMID).
@@ -222,7 +187,7 @@ class BilibiliResource(BaseResource):
             },
         )
 
-    def get_video_caption_v1(
+    def get_video_caption_v2(
         self,
         *,
         bvid: str,
@@ -230,13 +195,9 @@ class BilibiliResource(BaseResource):
         cid: str,
     ) -> ApiResponse[Any]:
         """
-        Video Captions (V2)
-
-        Retrieve subtitle/caption information for a specific Bilibili video.
+        Video Captions
 
-        Typical use cases:
-        - Extracting textual content from video subtitles for indexing or analysis.
-        - Multi-language content processing and accessibility analysis.
+        Get Bilibili video Captions data, including caption data, for transcript extraction and multilingual content analysis.
 
         Args:
             bvid: Bilibili Video ID (BVID).

{justoneapi-2.0.2 → justoneapi-3.0.0}/justoneapi/generated/resources/douban.py

@@ -7,7 +7,7 @@ from justoneapi._response import ApiResponse
 
 
 class DoubanResource(BaseResource):
-    """Generated resource for Douban."""
+    """Generated resource for Douban Movie."""
 
     def get_movie_reviews_v1(
         self,
@@ -17,13 +17,9 @@ class DoubanResource(BaseResource):
         page: int | None = 1,
     ) -> ApiResponse[Any]:
         """
-        Movie Reviews (V1)
+        Movie Reviews
 
-        Retrieves long-form user reviews for a specific movie subject (identified by subjectId).
-
-        Typical use cases:
-        - Analyzing detailed audience feedback for movies.
-        - Long-term trend analysis of viewer sentiment.
+        Get Douban movie Reviews data, including review titles, ratings, and snippets, for audience sentiment analysis and review research.
 
         Args:
             subject_id: The unique ID for a movie or TV subject on Douban.
@@ -39,19 +35,15 @@ class DoubanResource(BaseResource):
             },
         )
 
-    def get_movie_review_details_v1(
+    def get_movie_review_detail_v1(
         self,
         *,
         review_id: str,
     ) -> ApiResponse[Any]:
         """
-        Movie Review Details (V1)
-
-        Retrieves the full content and metadata of a specific movie review (identified by reviewId).
+        Review Details
 
-        Typical use cases:
-        - Fetching the complete text of a single long review.
-        - Analyzing the structured data and user engagement (likes, replies) of a specific review.
+        Get Douban movie Review Details data, including metadata, content fields, and engagement signals, for review archiving and detailed opinion analysis.
 
         Args:
             review_id: The unique ID for a specific review on Douban.
@@ -71,13 +63,9 @@ class DoubanResource(BaseResource):
         page: int | None = 1,
     ) -> ApiResponse[Any]:
         """
-        Movie Comments (V1)
-
-        Retrieves short user comments (short reviews) for a specific movie subject (identified by subjectId).
+        Comments
 
-        Typical use cases:
-        - Fast-paced sentiment analysis using quick viewer comments.
-        - Monitoring initial audience reaction upon movie release.
+        Get Douban movie Comments data, including ratings, snippets, and interaction counts, for quick sentiment sampling and review monitoring.
 
         Args:
             subject_id: The unique ID for a movie or TV subject on Douban.
@@ -99,13 +87,9 @@ class DoubanResource(BaseResource):
         subject_id: str,
     ) -> ApiResponse[Any]:
         """
-        Subject Details (V1)
+        Subject Details
 
-        Retrieves detailed information for a specific subject identified by subjectId.
-
-        Typical use cases:
-        - Displaying complete subject metadata in applications or websites.
-        - Supporting content analysis, cataloging, or detail page rendering.
+        Get Douban subject Details data, including title, rating, and cast, for title enrichment and catalog research.
 
         Args:
             subject_id: The unique ID for a movie or TV subject on Douban.
@@ -123,13 +107,9 @@ class DoubanResource(BaseResource):
         page: int | None = 1,
     ) -> ApiResponse[Any]:
         """
-        Recent Hot Movie (V1)
-
-        Retrieves the latest hot movies currently trending on the platform.
+        Recent Hot Movie
 
-        Typical use cases:
-        - Discovering recently popular movies.
-        - Tracking current movie trends for content analysis or recommendation.
+        Get Douban recent Hot Movie data, including ratings, posters, and subject metadata, for movie discovery and trend monitoring.
 
         Args:
             page: Page number for pagination.
@@ -147,13 +127,9 @@ class DoubanResource(BaseResource):
         page: int | None = 1,
     ) -> ApiResponse[Any]:
         """
-        Recent Hot Tv (V1)
-
-        Retrieves the latest hot TV shows currently trending on the platform.
+        Recent Hot Tv
 
-        Typical use cases:
-        - Discovering recently popular TV shows.
-        - Tracking current TV trends for content analysis or recommendation.
+        Get Douban recent Hot Tv data, including ratings, posters, and subject metadata, for series discovery and trend monitoring.
 
         Args:
             page: Page number for pagination.