diff --git a/justoneapi/generated/resources/__init__.py b/justoneapi/generated/resources/__init__.py index 2d7992ee..66a45776 100644 --- a/justoneapi/generated/resources/__init__.py +++ b/justoneapi/generated/resources/__init__.py @@ -8,6 +8,7 @@ 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.field_1688 import Field1688Resource from justoneapi.generated.resources.imdb import ImdbResource from justoneapi.generated.resources.instagram import InstagramResource from justoneapi.generated.resources.jd import JdResource @@ -37,6 +38,7 @@ "douyin_ec": DouyinEcResource, "douyin_xingtu": DouyinXingtuResource, "facebook": FacebookResource, + "field_1688": Field1688Resource, "imdb": ImdbResource, "instagram": InstagramResource, "jd": JdResource, @@ -67,6 +69,7 @@ "DouyinEcResource", "DouyinXingtuResource", "FacebookResource", + "Field1688Resource", "ImdbResource", "InstagramResource", "JdResource", diff --git a/justoneapi/generated/resources/douyin_xingtu.py b/justoneapi/generated/resources/douyin_xingtu.py index 0ae47031..f83bbfbe 100644 --- a/justoneapi/generated/resources/douyin_xingtu.py +++ b/justoneapi/generated/resources/douyin_xingtu.py @@ -14,6 +14,7 @@ def gw_api_author_get_author_base_info_v1( *, o_author_id: str, platform: str | None = "SHORT_VIDEO", + auto: bool | None = False, ) -> ApiResponse[Any]: """ Creator Profile @@ -23,12 +24,14 @@ def gw_api_author_get_author_base_info_v1( Args: o_author_id: Author's unique ID. platform: Platform type. Available Values: - `SHORT_VIDEO`: Short video - `LIVE_STREAMING`: Live streaming - `PICTURE_TEXT`: Picture and text - `SHORT_DRAMA`: Short drama + auto: Do not use unless confirmed by admin. """ return self._get( "/api/douyin-xingtu/gw/api/author/get_author_base_info/v1", { "oAuthorId": o_author_id, "platform": platform, + "auto": auto, }, ) @@ -651,7 +654,6 @@ def get_kol_info_v1( *, kol_id: str, platform_channel: str | None = "_1", - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Creator Profile @@ -661,14 +663,12 @@ def get_kol_info_v1( Args: kol_id: KOL ID. platform_channel: Platform channel. Available Values: - `_1`: Short Video - `_10`: Live Streaming - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-info/v1", { "kolId": kol_id, "platformChannel": platform_channel, - "acceptCache": accept_cache, }, ) @@ -676,7 +676,6 @@ def get_kol_audience_distribution_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Audience Distribution @@ -685,13 +684,11 @@ def get_kol_audience_distribution_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-audience-distribution/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -700,7 +697,6 @@ def get_kol_fans_distribution_v1( *, kol_id: str, fans_type: str | None = "_1", - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Follower Distribution @@ -710,14 +706,12 @@ def get_kol_fans_distribution_v1( Args: kol_id: KOL ID. fans_type: Fans type. Available Values: - `_1`: Fans Portrait - `_2`: Fans Group Portrait - `_5`: Iron Fans Portrait - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-fans-distribution/v1", { "kolId": kol_id, "fansType": fans_type, - "acceptCache": accept_cache, }, ) @@ -726,7 +720,6 @@ def get_kol_marketing_info_v1( *, kol_id: str, platform_channel: str | None = "_1", - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Marketing Metrics @@ -736,14 +729,12 @@ def get_kol_marketing_info_v1( Args: kol_id: KOL ID. platform_channel: Platform channel. Available Values: - `_1`: Short Video - `_10`: Live Streaming - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-marketing-info/v1", { "kolId": kol_id, "platformChannel": platform_channel, - "acceptCache": accept_cache, }, ) @@ -755,7 +746,6 @@ def get_kol_spread_info_v1( range: str | None = "_2", flow_type: str | None = "1", only_assign: bool | None = False, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Spread Metrics @@ -768,7 +758,6 @@ def get_kol_spread_info_v1( range: Time range. Available Values: - `_2`: Last 30 days - `_3`: Last 90 days flow_type: Flow type. only_assign: Only assigned notes. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-spread-info/v1", @@ -778,7 +767,6 @@ def get_kol_spread_info_v1( "range": range, "flowType": flow_type, "onlyAssign": only_assign, - "acceptCache": accept_cache, }, ) @@ -788,7 +776,6 @@ def search_kol_simple_v1( keyword: str, platform_source: str, page: int, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ KOL Keyword Search @@ -799,7 +786,6 @@ def search_kol_simple_v1( keyword: Search keywords. platform_source: Platform source. Available Values: - `_1`: Douyin - `_2`: Toutiao - `_3`: Xigua page: Page number. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/search-kol-simple/v1", @@ -807,7 +793,6 @@ def search_kol_simple_v1( "keyword": keyword, "platformSource": platform_source, "page": page, - "acceptCache": accept_cache, }, ) @@ -816,7 +801,6 @@ def get_kol_convert_ability_v1( *, kol_id: str, range: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Conversion Analysis @@ -826,14 +810,12 @@ def get_kol_convert_ability_v1( Args: kol_id: KOL ID. range: Time range. Available Values: - `_1`: Last 7 days - `_2`: Last 30 days - `_3`: Last 90 days - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-convert-ability/v1", { "kolId": kol_id, "range": range, - "acceptCache": accept_cache, }, ) @@ -842,7 +824,6 @@ def get_kol_show_items_v2_v1( *, kol_id: str, only_assign: bool | None = False, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Showcase Items @@ -852,14 +833,12 @@ def get_kol_show_items_v2_v1( Args: kol_id: KOL ID. only_assign: Whether true is Xingtu video, false is personal video. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-show-items-v2/v1", { "kolId": kol_id, "onlyAssign": only_assign, - "acceptCache": accept_cache, }, ) @@ -868,7 +847,6 @@ def get_kol_link_info_v1( *, kol_id: str, industry_tag: str | None = "", - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Creator Link Metrics @@ -878,14 +856,12 @@ def get_kol_link_info_v1( Args: kol_id: KOL ID. industry_tag: Industry Tag. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-link-info/v1", { "kolId": kol_id, "industryTag": industry_tag, - "acceptCache": accept_cache, }, ) @@ -895,7 +871,6 @@ def get_kol_convert_videos_or_products_v1( kol_id: str, detail_type: str, page: int, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Conversion Resources @@ -906,7 +881,6 @@ def get_kol_convert_videos_or_products_v1( kol_id: KOL ID. detail_type: Resource type. Available Values: - `_1`: Video Data - `_2`: Product Data page: Page number. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-convert-videos-or-products/v1", @@ -914,7 +888,6 @@ def get_kol_convert_videos_or_products_v1( "kolId": kol_id, "detailType": detail_type, "page": page, - "acceptCache": accept_cache, }, ) @@ -922,7 +895,6 @@ def get_kol_link_struct_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Creator Link Structure @@ -931,13 +903,11 @@ def get_kol_link_struct_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-link-struct/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -945,7 +915,6 @@ def get_kol_touch_distribution_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Audience Touchpoint Distribution @@ -954,13 +923,11 @@ def get_kol_touch_distribution_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-touch-distribution/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -968,7 +935,6 @@ def get_kol_cp_info_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Cost Performance Analysis @@ -977,13 +943,11 @@ def get_kol_cp_info_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-cp-info/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -991,7 +955,6 @@ def get_kol_rec_videos_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Recommended Videos @@ -1000,13 +963,11 @@ def get_kol_rec_videos_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-rec-videos/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -1016,7 +977,6 @@ def get_kol_daily_fans_v1( kol_id: str, start_date: str, end_date: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Follower Growth Trend @@ -1027,7 +987,6 @@ def get_kol_daily_fans_v1( kol_id: KOL ID. start_date: Start Date (yyyy-MM-dd). end_date: End Date (yyyy-MM-dd). - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-kol-daily-fans/v1", @@ -1035,7 +994,6 @@ def get_kol_daily_fans_v1( "kolId": kol_id, "startDate": start_date, "endDate": end_date, - "acceptCache": accept_cache, }, ) @@ -1043,7 +1001,6 @@ def get_author_hot_comment_tokens_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ KOL Comment Keyword Analysis @@ -1052,13 +1009,11 @@ def get_author_hot_comment_tokens_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-author-hot-comment-tokens/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -1067,7 +1022,6 @@ def get_author_content_hot_keywords_v1( *, kol_id: str, keyword_type: str | None = "0", - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ KOL Content Keyword Analysis @@ -1077,14 +1031,12 @@ def get_author_content_hot_keywords_v1( Args: kol_id: KOL ID. keyword_type: Type of keywords. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-author-content-hot-keywords/v1", { "kolId": kol_id, "keywordType": keyword_type, - "acceptCache": accept_cache, }, ) @@ -1092,7 +1044,6 @@ def get_author_commerce_spread_info_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Author Commerce Spread Info @@ -1101,13 +1052,11 @@ def get_author_commerce_spread_info_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-author-commerce-spread-info/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -1116,7 +1065,6 @@ def get_author_commerce_seed_base_info_v1( *, kol_id: str, range: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Author Commerce Seeding Base Info @@ -1126,14 +1074,12 @@ def get_author_commerce_seed_base_info_v1( Args: kol_id: KOL ID. range: Time range. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-author-commerce-seed-base-info/v1", { "kolId": kol_id, "range": range, - "acceptCache": accept_cache, }, ) @@ -1141,7 +1087,6 @@ def get_video_detail_v1( self, *, detail_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Video Details @@ -1150,12 +1095,10 @@ def get_video_detail_v1( Args: detail_id: Video detail ID. - accept_cache: Enable cache. """ return self._get( "/api/douyin-xingtu/get-video-detail/v1", { "detailId": detail_id, - "acceptCache": accept_cache, }, ) diff --git a/justoneapi/generated/resources/field_1688.py b/justoneapi/generated/resources/field_1688.py new file mode 100644 index 00000000..712e3313 --- /dev/null +++ b/justoneapi/generated/resources/field_1688.py @@ -0,0 +1,50 @@ +from __future__ import annotations + +from typing import Any + +from justoneapi._resource import BaseResource +from justoneapi._response import ApiResponse + + +class Field1688Resource(BaseResource): + """Generated resource for 1688.""" + + def get_item_detail_v1( + self, + *, + item_id: str, + ) -> ApiResponse[Any]: + """ + Product Details + + Get 1688 product details, including product metadata and offer information, for sourcing research and catalog analysis. + + Args: + item_id: A unique product identifier on 1688. + """ + return self._get( + "/api/1688/get-item-detail/v1", + { + "itemId": item_id, + }, + ) + + def search_item_list_v1( + self, + *, + keyword: str, + ) -> ApiResponse[Any]: + """ + Product Search + + Get 1688 product search results by keyword for sourcing discovery, supplier research, and market monitoring. + + Args: + keyword: Search keyword. + """ + return self._get( + "/api/1688/search-item-list/v1", + { + "keyword": keyword, + }, + ) diff --git a/justoneapi/generated/resources/imdb.py b/justoneapi/generated/resources/imdb.py index 519cc994..0e436f07 100644 --- a/justoneapi/generated/resources/imdb.py +++ b/justoneapi/generated/resources/imdb.py @@ -14,7 +14,6 @@ def title_release_expectation_query_v1( *, id_: str, language_country: str | None = "en_US", - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Release Expectation @@ -24,14 +23,12 @@ def title_release_expectation_query_v1( Args: id_: The unique IMDb ID of the title (e.g., tt12037194). language_country: Language and country preferences. Available Values: - `en_US`: English (US) - `fr_CA`: French (Canada) - `fr_FR`: French (France) - `de_DE`: German (Germany) - `hi_IN`: Hindi (India) - `it_IT`: Italian (Italy) - `pt_BR`: Portuguese (Brazil) - `es_ES`: Spanish (Spain) - `es_US`: Spanish (US) - `es_MX`: Spanish (Mexico) - accept_cache: Whether to accept cached data. """ return self._get( "/api/imdb/title-release-expectation-query/v1", { "id": id_, "languageCountry": language_country, - "acceptCache": accept_cache, }, ) diff --git a/justoneapi/generated/resources/instagram.py b/justoneapi/generated/resources/instagram.py index 2bab8d8f..18b84f35 100644 --- a/justoneapi/generated/resources/instagram.py +++ b/justoneapi/generated/resources/instagram.py @@ -117,3 +117,55 @@ def search_hashtag_posts_v1( "endCursor": end_cursor, }, ) + + def get_post_comments_v1( + self, + *, + code: str, + min_id: str | None = "", + sort_order: str | None = "newest", + ) -> ApiResponse[Any]: + """ + Post Comment List + + Get post comments, commenter profiles, text, like counts, reply counts, and pagination cursors for sentiment review and engagement analysis. + + Args: + code: The unique shortcode for the Instagram post. + min_id: Pagination cursor returned as next_min_id from the previous response. + sort_order: Sort order for the comments. Available Values: - `popular`: Popular - `newest`: Newest + """ + return self._get( + "/api/instagram/get-post-comments/v1", + { + "code": code, + "minId": min_id, + "sortOrder": sort_order, + }, + ) + + def get_comment_replies_v1( + self, + *, + media_id: str, + comment_id: str, + min_id: str | None = "", + ) -> ApiResponse[Any]: + """ + Comment Reply List + + Get replies under a parent comment, including reply text, author details, like counts, IDs, and pagination cursors for threaded discussion analysis. + + Args: + media_id: The numeric media ID of the Instagram post. + comment_id: The parent comment ID whose replies are to be retrieved. + min_id: Pagination cursor returned as next_min_child_cursor from the previous response. + """ + return self._get( + "/api/instagram/get-comment-replies/v1", + { + "mediaId": media_id, + "commentId": comment_id, + "minId": min_id, + }, + ) diff --git a/justoneapi/generated/resources/jd.py b/justoneapi/generated/resources/jd.py index 410614d9..28244d58 100644 --- a/justoneapi/generated/resources/jd.py +++ b/justoneapi/generated/resources/jd.py @@ -29,6 +29,49 @@ def get_item_detail_v1( }, ) + def get_item_price_v1( + self, + *, + item_id: str, + ) -> ApiResponse[Any]: + """ + Product Price + + Get JD.com product Price data for price monitoring, catalog checks, repricing workflows, and ecommerce research. + + Args: + item_id: A unique product identifier on JD.com (item ID). + """ + return self._get( + "/api/jd/get-item-price/v1", + { + "itemId": item_id, + }, + ) + + def search_item_list_v1( + self, + *, + keyword: str, + page: str | None = None, + ) -> ApiResponse[Any]: + """ + Product Search + + Get JD.com product Search data, including matched items and product metadata, for product discovery, catalog research, and market monitoring. + + Args: + keyword: Search keyword. + page: Page number for pagination. + """ + return self._get( + "/api/jd/search-item-list/v1", + { + "keyword": keyword, + "page": page, + }, + ) + def get_item_comments_v1( self, *, diff --git a/justoneapi/generated/resources/xiaohongshu.py b/justoneapi/generated/resources/xiaohongshu.py index ad2064b4..2a2304e4 100644 --- a/justoneapi/generated/resources/xiaohongshu.py +++ b/justoneapi/generated/resources/xiaohongshu.py @@ -99,6 +99,7 @@ def get_note_detail_v1( self, *, note_id: str, + format: bool | None = False, ) -> ApiResponse[Any]: """ Note Details @@ -107,11 +108,13 @@ def get_note_detail_v1( Args: note_id: Unique note identifier on Xiaohongshu. + format: Do not use unless confirmed by admin. """ return self._get( "/api/xiaohongshu/get-note-detail/v1", { "noteId": note_id, + "format": format, }, ) diff --git a/justoneapi/generated/resources/xiaohongshu_pgy.py b/justoneapi/generated/resources/xiaohongshu_pgy.py index 36a859b4..87cb0995 100644 --- a/justoneapi/generated/resources/xiaohongshu_pgy.py +++ b/justoneapi/generated/resources/xiaohongshu_pgy.py @@ -368,7 +368,6 @@ def get_kol_info_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Creator Profile @@ -377,13 +376,11 @@ def get_kol_info_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/xiaohongshu-pgy/get-kol-info/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -395,7 +392,6 @@ def get_kol_note_rate_v1( note_type: str | None = "_3", ad_switch: str | None = "_1", business: str | None = "_0", - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Note Performance Metrics @@ -408,7 +404,6 @@ def get_kol_note_rate_v1( note_type: Note type. Available Values: - `_1`: Photo and Text - `_2`: Video - `_3`: Photo and Video ad_switch: Ad filter. Available Values: - `_1`: Full traffic (All notes) - `_0`: Natural traffic (Organic notes) business: Business type. Available Values: - `_0`: Normal notes - `_1`: Cooperation notes - accept_cache: Enable cache. """ return self._get( "/api/xiaohongshu-pgy/get-kol-note-rate/v1", @@ -418,7 +413,6 @@ def get_kol_note_rate_v1( "noteType": note_type, "adSwitch": ad_switch, "business": business, - "acceptCache": accept_cache, }, ) @@ -426,7 +420,6 @@ def get_kol_fans_portrait_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Follower Distribution @@ -435,13 +428,11 @@ def get_kol_fans_portrait_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/xiaohongshu-pgy/get-kol-fans-portrait/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -449,7 +440,6 @@ def get_kol_fans_summary_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Follower Summary @@ -458,13 +448,11 @@ def get_kol_fans_summary_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/xiaohongshu-pgy/get-kol-fans-summary/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -474,7 +462,6 @@ def get_kol_fans_trend_v1( kol_id: str, date_type: str, increase_type: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Follower Growth History @@ -485,7 +472,6 @@ def get_kol_fans_trend_v1( kol_id: KOL ID. date_type: Date type. Available Values: - `_1`: Last 30 days - `_2`: Last 60 days increase_type: Increase type. Available Values: - `_1`: Total fans - `_2`: New fans increase - accept_cache: Enable cache. """ return self._get( "/api/xiaohongshu-pgy/get-kol-fans-trend/v1", @@ -493,7 +479,6 @@ def get_kol_fans_trend_v1( "kolId": kol_id, "dateType": date_type, "increaseType": increase_type, - "acceptCache": accept_cache, }, ) @@ -505,7 +490,6 @@ def get_kol_note_list_v1( order_type: str, page: int | None = 1, note_type: str | None = "_4", - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Creator Note List @@ -518,7 +502,6 @@ def get_kol_note_list_v1( order_type: Sorting order. Available Values: - `_1`: Latest - `_2`: Most read - `_3`: Most interactions page: Page number. note_type: Note type. Available Values: - `_1`: Photo and Text notes - `_2`: Video notes - `_3`: Cooperation notes - `_4`: All types - accept_cache: Enable cache. """ return self._get( "/api/xiaohongshu-pgy/get-kol-note-list/v1", @@ -528,7 +511,6 @@ def get_kol_note_list_v1( "orderType": order_type, "page": page, "noteType": note_type, - "acceptCache": accept_cache, }, ) @@ -537,7 +519,6 @@ def get_kol_data_summary_v2( *, kol_id: str, business: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Data Summary @@ -547,14 +528,12 @@ def get_kol_data_summary_v2( 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/v2", { "kolId": kol_id, "business": business, - "acceptCache": accept_cache, }, ) @@ -562,7 +541,6 @@ def get_kol_cost_effective_v1( self, *, kol_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Cost Effectiveness Analysis @@ -571,13 +549,11 @@ def get_kol_cost_effective_v1( Args: kol_id: KOL ID. - accept_cache: Enable cache. """ return self._get( "/api/xiaohongshu-pgy/get-kol-cost-effective/v1", { "kolId": kol_id, - "acceptCache": accept_cache, }, ) @@ -585,7 +561,6 @@ def get_note_detail_v1( self, *, note_id: str, - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Note Details @@ -594,13 +569,11 @@ def get_note_detail_v1( Args: note_id: Note ID. - accept_cache: Enable cache. """ return self._get( "/api/xiaohongshu-pgy/get-note-detail/v1", { "noteId": note_id, - "acceptCache": accept_cache, }, ) @@ -612,7 +585,6 @@ def get_kol_core_data_v1( note_type: str | None = "_3", date_type: str | None = "_1", ad_switch: str | None = "_1", - accept_cache: bool | None = False, ) -> ApiResponse[Any]: """ Creator Core Metrics @@ -625,7 +597,6 @@ def get_kol_core_data_v1( note_type: Note type. Available Values: - `_1`: Photo and Text - `_2`: Video - `_3`: Photo and Video date_type: Date type. Available Values: - `_1`: Last 30 days - `_2`: Last 90 days ad_switch: Ad filter. Available Values: - `_1`: Full traffic (All notes) - `_0`: Natural traffic (Organic notes) - accept_cache: Enable cache. """ return self._get( "/api/xiaohongshu-pgy/get-kol-core-data/v1", @@ -635,6 +606,5 @@ def get_kol_core_data_v1( "noteType": note_type, "dateType": date_type, "adSwitch": ad_switch, - "acceptCache": accept_cache, }, ) diff --git a/justoneapi/generated/resources/youtube.py b/justoneapi/generated/resources/youtube.py index 47ddd2c4..d25b3d8a 100644 --- a/justoneapi/generated/resources/youtube.py +++ b/justoneapi/generated/resources/youtube.py @@ -51,3 +51,61 @@ def get_channel_videos_v1( "cursor": cursor, }, ) + + def get_video_comment_v1( + self, + *, + video_id: str, + cursor: str | None = "", + language_code: str | None = "zh-CN", + country_code: str | None = "US", + sort_by: str | None = "newest", + ) -> ApiResponse[Any]: + """ + Video Comment List + + Get first-level video comments, author profiles, like counts, reply counts, and reply cursors for audience feedback and engagement analysis. + + Args: + video_id: The unique identifier for a YouTube video. + cursor: Pagination cursor returned by the previous response. + language_code: Language preference for response data. + country_code: Region code for response data. + sort_by: Sort order for the comment list. Available Values: - `top`: Top comments - `newest`: Newest comments + """ + return self._get( + "/api/youtube/get-video-comment/v1", + { + "videoId": video_id, + "cursor": cursor, + "languageCode": language_code, + "countryCode": country_code, + "sortBy": sort_by, + }, + ) + + def get_video_sub_comment_v1( + self, + *, + cursor: str, + language_code: str | None = "zh-CN", + country_code: str | None = "US", + ) -> ApiResponse[Any]: + """ + Video Sub Comment List + + Get second-level video comment replies, reply authors, like counts, and pagination cursors for threaded discussion analysis. + + Args: + cursor: Reply cursor from a first-level comment response. + language_code: Language preference for response data. + country_code: Region code for response data. + """ + return self._get( + "/api/youtube/get-video-sub-comment/v1", + { + "cursor": cursor, + "languageCode": language_code, + "countryCode": country_code, + }, + ) diff --git a/openapi/public-api.json b/openapi/public-api.json index 423a468c..ae0f76fd 100644 --- a/openapi/public-api.json +++ b/openapi/public-api.json @@ -41,6 +41,96 @@ }, "openapi": "3.1.0", "paths": { + "/api/1688/get-item-detail/v1": { + "get": { + "description": "Get 1688 product details, including product metadata and offer information, for sourcing research and catalog analysis.", + "operationId": "getItemDetailV1", + "parameters": [ + { + "description": "Access token for this API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "A unique product identifier on 1688.", + "in": "query", + "name": "itemId", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Product Details", + "tags": [ + "1688" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "16001000" + } + }, + "/api/1688/search-item-list/v1": { + "get": { + "description": "Get 1688 product search results by keyword for sourcing discovery, supplier research, and market monitoring.", + "operationId": "searchItemListV1", + "parameters": [ + { + "description": "Access token for this API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "Search keyword.", + "in": "query", + "name": "keyword", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Product Search", + "tags": [ + "1688" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "16001100" + } + }, "/api/amazon/get-best-sellers/v1": { "get": { "description": "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.", @@ -1539,16 +1629,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -1595,16 +1675,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -1661,16 +1731,6 @@ "default": "0", "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -1717,16 +1777,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -1773,16 +1823,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -1844,16 +1884,6 @@ ], "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -1924,16 +1954,6 @@ "format": "int32", "type": "integer" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -1980,16 +2000,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2054,16 +2064,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2126,16 +2126,6 @@ ], "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2197,16 +2187,6 @@ ], "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2263,16 +2243,6 @@ "default": "", "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2319,16 +2289,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2390,16 +2350,6 @@ ], "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2446,16 +2396,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2512,16 +2452,6 @@ "default": false, "type": "boolean" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2618,16 +2548,6 @@ "default": false, "type": "boolean" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2674,16 +2594,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2730,16 +2640,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -2967,6 +2867,16 @@ ], "type": "string" } + }, + { + "description": "Do not use unless confirmed by admin.", + "in": "query", + "name": "auto", + "required": false, + "schema": { + "default": false, + "type": "boolean" + } } ], "responses": { @@ -4625,16 +4535,6 @@ "format": "int32", "type": "integer" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -6493,16 +6393,6 @@ ], "type": "string" } - }, - { - "description": "Whether to accept cached data.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -6662,6 +6552,140 @@ "x-order": 34001800 } }, + "/api/instagram/get-comment-replies/v1": { + "get": { + "description": "Get replies under a parent comment, including reply text, author details, like counts, IDs, and pagination cursors for threaded discussion analysis.", + "operationId": "getInstagramCommentRepliesV1", + "parameters": [ + { + "description": "Access token for the API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "The numeric media ID of the Instagram post.", + "in": "query", + "name": "mediaId", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "The parent comment ID whose replies are to be retrieved.", + "in": "query", + "name": "commentId", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "Pagination cursor returned as next_min_child_cursor from the previous response.", + "in": "query", + "name": "minId", + "required": false, + "schema": { + "default": "", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Comment Reply List", + "tags": [ + "Instagram" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "24001600" + } + }, + "/api/instagram/get-post-comments/v1": { + "get": { + "description": "Get post comments, commenter profiles, text, like counts, reply counts, and pagination cursors for sentiment review and engagement analysis.", + "operationId": "getInstagramPostCommentsV1", + "parameters": [ + { + "description": "Access token for the API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "The unique shortcode for the Instagram post.", + "in": "query", + "name": "code", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "Pagination cursor returned as next_min_id from the previous response.", + "in": "query", + "name": "minId", + "required": false, + "schema": { + "default": "", + "type": "string" + } + }, + { + "description": "Sort order for the comments.\n\nAvailable Values:\n- `popular`: Popular\n- `newest`: Newest", + "in": "query", + "name": "sortOrder", + "required": false, + "schema": { + "default": "newest", + "description": "Instagram Comment Sort Order", + "enum": [ + "popular", + "newest" + ], + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Post Comment List", + "tags": [ + "Instagram" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "24001500" + } + }, "/api/instagram/get-post-detail/v1": { "get": { "description": "Get Instagram post Details data, including post caption, media content (images/videos), and publish time, for analyzing engagement metrics (likes/comments) for a specific post and archiving post content and media assets for content analysis.", @@ -7021,6 +7045,51 @@ "x-order": "19001000" } }, + "/api/jd/get-item-price/v1": { + "get": { + "description": "Get JD.com product Price data for price monitoring, catalog checks, repricing workflows, and ecommerce research.", + "operationId": "getJdItemPriceV1", + "parameters": [ + { + "description": "Access token for this API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "A unique product identifier on JD.com (item ID).", + "in": "query", + "name": "itemId", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Product Price", + "tags": [ + "JD.com" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "19001050" + } + }, "/api/jd/get-shop-item-list/v1": { "get": { "description": "Get JD.com shop Product List data, including item titles, prices, and images, for catalog tracking and seller research.", @@ -7075,6 +7144,60 @@ "x-order": "19001200" } }, + "/api/jd/search-item-list/v1": { + "get": { + "description": "Get JD.com product Search data, including matched items and product metadata, for product discovery, catalog research, and market monitoring.", + "operationId": "searchItemListV1", + "parameters": [ + { + "description": "Access token for this API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "Search keyword.", + "in": "query", + "name": "keyword", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "Page number for pagination.", + "in": "query", + "name": "page", + "required": false, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Product Search", + "tags": [ + "JD.com" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "19001075" + } + }, "/api/kuaishou/get-user-detail/v1": { "get": { "description": "Get Kuaishou user Profile data, including account metadata, audience metrics, and verification-related fields, for creator research and building creator profiles and monitoring audience growth and account status.", @@ -11426,16 +11549,6 @@ ], "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -11482,16 +11595,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -11552,16 +11655,6 @@ ], "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -11608,16 +11701,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -11664,16 +11747,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -11748,16 +11821,6 @@ ], "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -11804,16 +11867,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -11916,16 +11969,6 @@ ], "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -12033,16 +12076,6 @@ ], "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -12089,16 +12122,6 @@ "schema": { "type": "string" } - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - } } ], "responses": { @@ -12256,6 +12279,16 @@ "schema": { "type": "string" } + }, + { + "description": "Do not use unless confirmed by admin.", + "in": "query", + "name": "format", + "required": false, + "schema": { + "default": false, + "type": "boolean" + } } ], "responses": { @@ -13174,6 +13207,96 @@ "x-order": "25001001" } }, + "/api/youtube/get-video-comment/v1": { + "get": { + "description": "Get first-level video comments, author profiles, like counts, reply counts, and reply cursors for audience feedback and engagement analysis.", + "operationId": "getVideoCommentV1", + "parameters": [ + { + "description": "Access token for this API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "The unique identifier for a YouTube video.", + "in": "query", + "name": "videoId", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "Pagination cursor returned by the previous response.", + "in": "query", + "name": "cursor", + "required": false, + "schema": { + "default": "", + "type": "string" + } + }, + { + "description": "Language preference for response data.", + "in": "query", + "name": "languageCode", + "required": false, + "schema": { + "default": "zh-CN", + "type": "string" + } + }, + { + "description": "Region code for response data.", + "in": "query", + "name": "countryCode", + "required": false, + "schema": { + "default": "US", + "type": "string" + } + }, + { + "description": "Sort order for the comment list.\n\nAvailable Values:\n- `top`: Top comments\n- `newest`: Newest comments", + "in": "query", + "name": "sortBy", + "required": false, + "schema": { + "default": "newest", + "description": "YouTube Comment Sort", + "enum": [ + "top", + "newest" + ], + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Video Comment List", + "tags": [ + "YouTube" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "25001100" + } + }, "/api/youtube/get-video-detail/v1": { "get": { "description": "Get YouTube video Details data, including its title, description, and view counts, for tracking video engagement and statistics, extracting video metadata for content analysis, and verifying video availability and status.", @@ -13219,6 +13342,71 @@ "x-order": "25001000" } }, + "/api/youtube/get-video-sub-comment/v1": { + "get": { + "description": "Get second-level video comment replies, reply authors, like counts, and pagination cursors for threaded discussion analysis.", + "operationId": "getVideoSubCommentV1", + "parameters": [ + { + "description": "Access token for this API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "Reply cursor from a first-level comment response.", + "in": "query", + "name": "cursor", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "Language preference for response data.", + "in": "query", + "name": "languageCode", + "required": false, + "schema": { + "default": "zh-CN", + "type": "string" + } + }, + { + "description": "Region code for response data.", + "in": "query", + "name": "countryCode", + "required": false, + "schema": { + "default": "US", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Video Sub Comment List", + "tags": [ + "YouTube" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "25001200" + } + }, "/api/zhihu/get-answer-list/v1": { "get": { "description": "Get Zhihu answer List data, including answer content, author profiles, and interaction metrics, for question analysis and answer research.", diff --git a/openapi/public-api.normalized.json b/openapi/public-api.normalized.json index c267985d..5d47ff89 100644 --- a/openapi/public-api.normalized.json +++ b/openapi/public-api.normalized.json @@ -48,6 +48,96 @@ }, "openapi": "3.1.0", "paths": { + "/api/1688/get-item-detail/v1": { + "get": { + "description": "Get 1688 product details, including product metadata and offer information, for sourcing research and catalog analysis.", + "operationId": "getItemDetailV1", + "parameters": [ + { + "description": "A unique product identifier on 1688.", + "in": "query", + "name": "itemId", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "item_id" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Product Details", + "tags": [ + "1688" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "16001000", + "x-sdk-class-name": "Field1688Resource", + "x-sdk-method-name": "get_item_detail_v1", + "x-sdk-resource": "field_1688" + } + }, + "/api/1688/search-item-list/v1": { + "get": { + "description": "Get 1688 product search results by keyword for sourcing discovery, supplier research, and market monitoring.", + "operationId": "searchItemListV1", + "parameters": [ + { + "description": "Search keyword.", + "in": "query", + "name": "keyword", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "keyword" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Product Search", + "tags": [ + "1688" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "16001100", + "x-sdk-class-name": "Field1688Resource", + "x-sdk-method-name": "search_item_list_v1", + "x-sdk-resource": "field_1688" + } + }, "/api/amazon/get-best-sellers/v1": { "get": { "description": "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.", @@ -1564,17 +1654,6 @@ "type": "string" }, "x-sdk-python-name": "range" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -1621,17 +1700,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -1689,17 +1757,6 @@ "type": "string" }, "x-sdk-python-name": "keyword_type" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -1746,17 +1803,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -1803,17 +1849,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -1876,17 +1911,6 @@ "type": "string" }, "x-sdk-python-name": "range" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -1959,17 +1983,6 @@ "type": "integer" }, "x-sdk-python-name": "page" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2016,17 +2029,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2093,17 +2095,6 @@ "type": "string" }, "x-sdk-python-name": "end_date" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2167,17 +2158,6 @@ "type": "string" }, "x-sdk-python-name": "fans_type" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2240,17 +2220,6 @@ "type": "string" }, "x-sdk-python-name": "platform_channel" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2308,17 +2277,6 @@ "type": "string" }, "x-sdk-python-name": "industry_tag" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2365,17 +2323,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2438,17 +2385,6 @@ "type": "string" }, "x-sdk-python-name": "platform_channel" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2495,17 +2431,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2563,17 +2488,6 @@ "type": "boolean" }, "x-sdk-python-name": "only_assign" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2674,17 +2588,6 @@ "type": "boolean" }, "x-sdk-python-name": "only_assign" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2731,17 +2634,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -2788,17 +2680,6 @@ "type": "string" }, "x-sdk-python-name": "detail_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -3029,6 +2910,17 @@ "type": "string" }, "x-sdk-python-name": "platform" + }, + { + "description": "Do not use unless confirmed by admin.", + "in": "query", + "name": "auto", + "required": false, + "schema": { + "default": false, + "type": "boolean" + }, + "x-sdk-python-name": "auto" } ], "responses": { @@ -4725,17 +4617,6 @@ "type": "integer" }, "x-sdk-python-name": "page" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -6626,17 +6507,6 @@ "type": "string" }, "x-sdk-python-name": "language_country" - }, - { - "description": "Whether to accept cached data.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -6806,9 +6676,147 @@ "x-sdk-resource": "imdb" } }, - "/api/instagram/get-post-detail/v1": { + "/api/instagram/get-comment-replies/v1": { "get": { - "description": "Get Instagram post Details data, including post caption, media content (images/videos), and publish time, for analyzing engagement metrics (likes/comments) for a specific post and archiving post content and media assets for content analysis.", + "description": "Get replies under a parent comment, including reply text, author details, like counts, IDs, and pagination cursors for threaded discussion analysis.", + "operationId": "getInstagramCommentRepliesV1", + "parameters": [ + { + "description": "The numeric media ID of the Instagram post.", + "in": "query", + "name": "mediaId", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "media_id" + }, + { + "description": "The parent comment ID whose replies are to be retrieved.", + "in": "query", + "name": "commentId", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "comment_id" + }, + { + "description": "Pagination cursor returned as next_min_child_cursor from the previous response.", + "in": "query", + "name": "minId", + "required": false, + "schema": { + "default": "", + "type": "string" + }, + "x-sdk-python-name": "min_id" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Comment Reply List", + "tags": [ + "Instagram" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "24001600", + "x-sdk-class-name": "InstagramResource", + "x-sdk-method-name": "get_comment_replies_v1", + "x-sdk-resource": "instagram" + } + }, + "/api/instagram/get-post-comments/v1": { + "get": { + "description": "Get post comments, commenter profiles, text, like counts, reply counts, and pagination cursors for sentiment review and engagement analysis.", + "operationId": "getInstagramPostCommentsV1", + "parameters": [ + { + "description": "The unique shortcode for the Instagram post.", + "in": "query", + "name": "code", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "code" + }, + { + "description": "Pagination cursor returned as next_min_id from the previous response.", + "in": "query", + "name": "minId", + "required": false, + "schema": { + "default": "", + "type": "string" + }, + "x-sdk-python-name": "min_id" + }, + { + "description": "Sort order for the comments.\n\nAvailable Values:\n- `popular`: Popular\n- `newest`: Newest", + "in": "query", + "name": "sortOrder", + "required": false, + "schema": { + "default": "newest", + "description": "Instagram Comment Sort Order", + "enum": [ + "popular", + "newest" + ], + "type": "string" + }, + "x-sdk-python-name": "sort_order" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Post Comment List", + "tags": [ + "Instagram" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "24001500", + "x-sdk-class-name": "InstagramResource", + "x-sdk-method-name": "get_post_comments_v1", + "x-sdk-resource": "instagram" + } + }, + "/api/instagram/get-post-detail/v1": { + "get": { + "description": "Get Instagram post Details data, including post caption, media content (images/videos), and publish time, for analyzing engagement metrics (likes/comments) for a specific post and archiving post content and media assets for content analysis.", "operationId": "getInstagramPostDetailV1", "parameters": [ { @@ -7169,6 +7177,51 @@ "x-sdk-resource": "jd" } }, + "/api/jd/get-item-price/v1": { + "get": { + "description": "Get JD.com product Price data for price monitoring, catalog checks, repricing workflows, and ecommerce research.", + "operationId": "getJdItemPriceV1", + "parameters": [ + { + "description": "A unique product identifier on JD.com (item ID).", + "in": "query", + "name": "itemId", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "item_id" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Product Price", + "tags": [ + "JD.com" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "19001050", + "x-sdk-class-name": "JdResource", + "x-sdk-method-name": "get_item_price_v1", + "x-sdk-resource": "jd" + } + }, "/api/jd/get-shop-item-list/v1": { "get": { "description": "Get JD.com shop Product List data, including item titles, prices, and images, for catalog tracking and seller research.", @@ -7224,6 +7277,61 @@ "x-sdk-resource": "jd" } }, + "/api/jd/search-item-list/v1": { + "get": { + "description": "Get JD.com product Search data, including matched items and product metadata, for product discovery, catalog research, and market monitoring.", + "operationId": "searchItemListV1", + "parameters": [ + { + "description": "Search keyword.", + "in": "query", + "name": "keyword", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "keyword" + }, + { + "description": "Page number for pagination.", + "in": "query", + "name": "page", + "required": false, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "page" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Product Search", + "tags": [ + "JD.com" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "19001075", + "x-sdk-class-name": "JdResource", + "x-sdk-method-name": "search_item_list_v1", + "x-sdk-resource": "jd" + } + }, "/api/kuaishou/get-user-detail/v1": { "get": { "description": "Get Kuaishou user Profile data, including account metadata, audience metrics, and verification-related fields, for creator research and building creator profiles and monitoring audience growth and account status.", @@ -11659,17 +11767,6 @@ "type": "string" }, "x-sdk-python-name": "ad_switch" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -11716,17 +11813,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -11788,17 +11874,6 @@ "type": "string" }, "x-sdk-python-name": "business" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -11845,17 +11920,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -11902,17 +11966,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -11989,17 +12042,6 @@ "type": "string" }, "x-sdk-python-name": "increase_type" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -12046,17 +12088,6 @@ "type": "string" }, "x-sdk-python-name": "kol_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -12163,17 +12194,6 @@ "type": "string" }, "x-sdk-python-name": "note_type" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -12285,17 +12305,6 @@ "type": "string" }, "x-sdk-python-name": "business" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -12342,17 +12351,6 @@ "type": "string" }, "x-sdk-python-name": "note_id" - }, - { - "description": "Enable cache.", - "in": "query", - "name": "acceptCache", - "required": false, - "schema": { - "default": false, - "type": "boolean" - }, - "x-sdk-python-name": "accept_cache" } ], "responses": { @@ -12512,6 +12510,17 @@ "type": "string" }, "x-sdk-python-name": "note_id" + }, + { + "description": "Do not use unless confirmed by admin.", + "in": "query", + "name": "format", + "required": false, + "schema": { + "default": false, + "type": "boolean" + }, + "x-sdk-python-name": "format" } ], "responses": { @@ -13452,6 +13461,100 @@ "x-sdk-resource": "youtube" } }, + "/api/youtube/get-video-comment/v1": { + "get": { + "description": "Get first-level video comments, author profiles, like counts, reply counts, and reply cursors for audience feedback and engagement analysis.", + "operationId": "getVideoCommentV1", + "parameters": [ + { + "description": "The unique identifier for a YouTube video.", + "in": "query", + "name": "videoId", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "video_id" + }, + { + "description": "Pagination cursor returned by the previous response.", + "in": "query", + "name": "cursor", + "required": false, + "schema": { + "default": "", + "type": "string" + }, + "x-sdk-python-name": "cursor" + }, + { + "description": "Language preference for response data.", + "in": "query", + "name": "languageCode", + "required": false, + "schema": { + "default": "zh-CN", + "type": "string" + }, + "x-sdk-python-name": "language_code" + }, + { + "description": "Region code for response data.", + "in": "query", + "name": "countryCode", + "required": false, + "schema": { + "default": "US", + "type": "string" + }, + "x-sdk-python-name": "country_code" + }, + { + "description": "Sort order for the comment list.\n\nAvailable Values:\n- `top`: Top comments\n- `newest`: Newest comments", + "in": "query", + "name": "sortBy", + "required": false, + "schema": { + "default": "newest", + "description": "YouTube Comment Sort", + "enum": [ + "top", + "newest" + ], + "type": "string" + }, + "x-sdk-python-name": "sort_by" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Video Comment List", + "tags": [ + "YouTube" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "25001100", + "x-sdk-class-name": "YoutubeResource", + "x-sdk-method-name": "get_video_comment_v1", + "x-sdk-resource": "youtube" + } + }, "/api/youtube/get-video-detail/v1": { "get": { "description": "Get YouTube video Details data, including its title, description, and view counts, for tracking video engagement and statistics, extracting video metadata for content analysis, and verifying video availability and status.", @@ -13497,6 +13600,73 @@ "x-sdk-resource": "youtube" } }, + "/api/youtube/get-video-sub-comment/v1": { + "get": { + "description": "Get second-level video comment replies, reply authors, like counts, and pagination cursors for threaded discussion analysis.", + "operationId": "getVideoSubCommentV1", + "parameters": [ + { + "description": "Reply cursor from a first-level comment response.", + "in": "query", + "name": "cursor", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "cursor" + }, + { + "description": "Language preference for response data.", + "in": "query", + "name": "languageCode", + "required": false, + "schema": { + "default": "zh-CN", + "type": "string" + }, + "x-sdk-python-name": "language_code" + }, + { + "description": "Region code for response data.", + "in": "query", + "name": "countryCode", + "required": false, + "schema": { + "default": "US", + "type": "string" + }, + "x-sdk-python-name": "country_code" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Video Sub Comment List", + "tags": [ + "YouTube" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "25001200", + "x-sdk-class-name": "YoutubeResource", + "x-sdk-method-name": "get_video_sub_comment_v1", + "x-sdk-resource": "youtube" + } + }, "/api/zhihu/get-answer-list/v1": { "get": { "description": "Get Zhihu answer List data, including answer content, author profiles, and interaction metrics, for question analysis and answer research.",