justoneapi 3.0.35__tar.gz → 3.0.37__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. {justoneapi-3.0.35/justoneapi.egg-info → justoneapi-3.0.37}/PKG-INFO +7 -1
  2. justoneapi-3.0.35/PKG-INFO → justoneapi-3.0.37/README.md +6 -16
  3. justoneapi-3.0.37/justoneapi/_version.py +1 -0
  4. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/__init__.py +3 -0
  5. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/douyin.py +32 -0
  6. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/douyin_ec.py +20 -0
  7. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/douyin_xingtu.py +451 -0
  8. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/imdb.py +29 -0
  9. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/taobao.py +49 -0
  10. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/tiktok_shop.py +23 -0
  11. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/toutiao.py +26 -0
  12. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/xiaohongshu.py +305 -0
  13. justoneapi-3.0.37/justoneapi/generated/resources/xiaohongshu_ec.py +36 -0
  14. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/xiaohongshu_pgy.py +213 -0
  15. justoneapi-3.0.35/README.md → justoneapi-3.0.37/justoneapi.egg-info/PKG-INFO +22 -0
  16. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi.egg-info/SOURCES.txt +1 -0
  17. justoneapi-3.0.35/justoneapi/_version.py +0 -1
  18. {justoneapi-3.0.35 → justoneapi-3.0.37}/LICENSE +0 -0
  19. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/__init__.py +0 -0
  20. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/_exceptions.py +0 -0
  21. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/_resource.py +0 -0
  22. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/_response.py +0 -0
  23. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/_transport.py +0 -0
  24. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/client.py +0 -0
  25. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/config.py +0 -0
  26. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/__init__.py +0 -0
  27. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/models.py +0 -0
  28. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/amazon.py +0 -0
  29. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/beike.py +0 -0
  30. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/bilibili.py +0 -0
  31. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/dewu.py +0 -0
  32. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/douban.py +0 -0
  33. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/facebook.py +0 -0
  34. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/field_1688.py +0 -0
  35. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/instagram.py +0 -0
  36. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/jd.py +0 -0
  37. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/kuaishou.py +0 -0
  38. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/linkedin.py +0 -0
  39. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/llm.py +0 -0
  40. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/qq_huxuan.py +0 -0
  41. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/reddit.py +0 -0
  42. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/search.py +0 -0
  43. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/tiktok.py +0 -0
  44. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/twitter.py +0 -0
  45. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/weibo.py +0 -0
  46. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/weixin.py +0 -0
  47. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/weixin_channels.py +0 -0
  48. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/xianyu.py +0 -0
  49. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/youku.py +0 -0
  50. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/youtube.py +0 -0
  51. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/zhihu.py +0 -0
  52. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/log.py +0 -0
  53. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi.egg-info/dependency_links.txt +0 -0
  54. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi.egg-info/requires.txt +0 -0
  55. {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi.egg-info/top_level.txt +0 -0
  56. {justoneapi-3.0.35 → justoneapi-3.0.37}/pyproject.toml +0 -0
  57. {justoneapi-3.0.35 → justoneapi-3.0.37}/setup.cfg +0 -0
  58. {justoneapi-3.0.35 → justoneapi-3.0.37}/tests/test_bump_version.py +0 -0
  59. {justoneapi-3.0.35 → justoneapi-3.0.37}/tests/test_codegen.py +0 -0
  60. {justoneapi-3.0.35 → justoneapi-3.0.37}/tests/test_generated_surface.py +0 -0
  61. {justoneapi-3.0.35 → justoneapi-3.0.37}/tests/test_integration_smoke.py +0 -0
  62. {justoneapi-3.0.35 → justoneapi-3.0.37}/tests/test_runtime.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: justoneapi
3
- Version: 3.0.35
3
+ Version: 3.0.37
4
4
  Summary: OpenAPI-driven Python SDK for Just One API
5
5
  Author-email: Just One API <support@justoneapi.com>
6
6
  Requires-Python: >=3.10
@@ -143,8 +143,10 @@ except BusinessError as exc:
143
143
 
144
144
  - [商品详情 (V1)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
145
145
  - [商品详情 (V2)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v2?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
146
+ - [商品详情 (V3)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v3?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
146
147
  - [商品详情 (V4)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v4?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
147
148
  - [商品详情 (V5)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v5?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
149
+ - [商品详情 (V6)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v6?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
148
150
  - [商品详情 (V9)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v9?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
149
151
  - [商品评价 (V3)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-reviews-v3?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
150
152
  - [商品问答 (V1)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-questions-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -171,6 +173,10 @@ except BusinessError as exc:
171
173
  - [话题笔记列表 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/topic-note-list-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
172
174
  - [分享链接解析 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/share-link-resolution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
173
175
 
176
+ ### 小红书电商 (RedNote)
177
+
178
+ - [商品搜索 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-e-commerce-rednote/product-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
179
+
174
180
  ### 小红书蒲公英
175
181
 
176
182
  - [创作者搜索 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -1,19 +1,3 @@
1
- Metadata-Version: 2.4
2
- Name: justoneapi
3
- Version: 3.0.35
4
- Summary: OpenAPI-driven Python SDK for Just One API
5
- Author-email: Just One API <support@justoneapi.com>
6
- Requires-Python: >=3.10
7
- Description-Content-Type: text/markdown
8
- License-File: LICENSE
9
- Requires-Dist: httpx<0.29,>=0.28
10
- Requires-Dist: pydantic<3,>=2.12
11
- Provides-Extra: dev
12
- Requires-Dist: datamodel-code-generator<0.56,>=0.55; extra == "dev"
13
- Requires-Dist: PyYAML<7,>=6; extra == "dev"
14
- Requires-Dist: pytest<10,>=9; extra == "dev"
15
- Dynamic: license-file
16
-
17
1
  <p align="center">
18
2
  <a href="https://justoneapi.com/zh?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_logo">
19
3
  <img src="https://justoneapi.com/logo/logo_text.png" alt="Just One API Logo" width="200">
@@ -143,8 +127,10 @@ except BusinessError as exc:
143
127
 
144
128
  - [商品详情 (V1)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
145
129
  - [商品详情 (V2)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v2?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
130
+ - [商品详情 (V3)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v3?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
146
131
  - [商品详情 (V4)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v4?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
147
132
  - [商品详情 (V5)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v5?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
133
+ - [商品详情 (V6)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v6?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
148
134
  - [商品详情 (V9)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-details-v9?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
149
135
  - [商品评价 (V3)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-reviews-v3?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
150
136
  - [商品问答 (V1)](https://docs.justoneapi.com/zh/api/taobao-and-tmall/product-questions-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -171,6 +157,10 @@ except BusinessError as exc:
171
157
  - [话题笔记列表 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/topic-note-list-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
172
158
  - [分享链接解析 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-rednote/share-link-resolution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
173
159
 
160
+ ### 小红书电商 (RedNote)
161
+
162
+ - [商品搜索 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-e-commerce-rednote/product-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
163
+
174
164
  ### 小红书蒲公英
175
165
 
176
166
  - [创作者搜索 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -0,0 +1 @@
1
+ __version__ = "3.0.37"
@@ -29,6 +29,7 @@ from justoneapi.generated.resources.weixin import WeixinResource
29
29
  from justoneapi.generated.resources.weixin_channels import WeixinChannelsResource
30
30
  from justoneapi.generated.resources.xianyu import XianyuResource
31
31
  from justoneapi.generated.resources.xiaohongshu import XiaohongshuResource
32
+ from justoneapi.generated.resources.xiaohongshu_ec import XiaohongshuEcResource
32
33
  from justoneapi.generated.resources.xiaohongshu_pgy import XiaohongshuPgyResource
33
34
  from justoneapi.generated.resources.youku import YoukuResource
34
35
  from justoneapi.generated.resources.youtube import YoutubeResource
@@ -64,6 +65,7 @@ RESOURCE_CLASSES = {
64
65
  "weixin_channels": WeixinChannelsResource,
65
66
  "xianyu": XianyuResource,
66
67
  "xiaohongshu": XiaohongshuResource,
68
+ "xiaohongshu_ec": XiaohongshuEcResource,
67
69
  "xiaohongshu_pgy": XiaohongshuPgyResource,
68
70
  "youku": YoukuResource,
69
71
  "youtube": YoutubeResource,
@@ -100,6 +102,7 @@ __all__ = [
100
102
  "WeixinChannelsResource",
101
103
  "XianyuResource",
102
104
  "XiaohongshuResource",
105
+ "XiaohongshuEcResource",
103
106
  "XiaohongshuPgyResource",
104
107
  "YoukuResource",
105
108
  "YoutubeResource",
@@ -9,6 +9,38 @@ from justoneapi._response import ApiResponse
9
9
  class DouyinResource(BaseResource):
10
10
  """Generated resource for Douyin (TikTok China)."""
11
11
 
12
+ def search_video_v1(
13
+ self,
14
+ *,
15
+ keyword: str | None = None,
16
+ sort_type: str | None = "_0",
17
+ publish_time: str | None = "_0",
18
+ duration: str | None = "_0",
19
+ search_id: str | None = None,
20
+ ) -> ApiResponse[Any]:
21
+ """
22
+ Video Search
23
+
24
+ Searches Douyin (TikTok China) videos through the mobile-app flow. Start with a keyword and optional filters. Continue with only data.business_config.next_page.search_id from the preceding response; pagination state is retained for up to 24 hours.
25
+
26
+ Args:
27
+ keyword: The search keyword. Required when starting a new search; omit it when continuing with searchId.
28
+ sort_type: Sorting criteria for a new search. Stored settings are reused when continuing. Available Values: - `_0`: General - `_1`: Most Likes - `_2`: Newest - `_3`: Most Comments - `_4`: Most Favorites
29
+ publish_time: Publish-time filter for a new search. Stored settings are reused when continuing. Available Values: - `_0`: No Limit - `_1`: Last 24 Hours - `_7`: Last 7 Days - `_180`: Last 6 Months
30
+ duration: Duration filter for a new search. Stored settings are reused when continuing. Available Values: - `_0`: No Limit - `_1`: Under 1 Minute - `_2`: 1-5 Minutes - `_3`: Over 5 Minutes
31
+ search_id: For continuation only. Use data.business_config.next_page.search_id from the previous response. The stored pagination state expires after 24 hours.
32
+ """
33
+ return self._get(
34
+ "/api/douyin/search-video/v1",
35
+ {
36
+ "keyword": keyword,
37
+ "sortType": sort_type,
38
+ "publishTime": publish_time,
39
+ "duration": duration,
40
+ "searchId": search_id,
41
+ },
42
+ )
43
+
12
44
  def search_video_v4(
13
45
  self,
14
46
  *,
@@ -9,6 +9,26 @@ from justoneapi._response import ApiResponse
9
9
  class DouyinEcResource(BaseResource):
10
10
  """Generated resource for Douyin E-commerce."""
11
11
 
12
+ def get_item_detail_v1(
13
+ self,
14
+ *,
15
+ item_id: str,
16
+ ) -> ApiResponse[Any]:
17
+ """
18
+ Item Details
19
+
20
+ Get Douyin E-commerce item details, including price, title, and stock, for product monitoring and competitive analysis.
21
+
22
+ Args:
23
+ item_id: The unique ID of the item on Douyin E-commerce.
24
+ """
25
+ return self._get(
26
+ "/api/douyin-ec/get-item-detail/v1",
27
+ {
28
+ "itemId": item_id,
29
+ },
30
+ )
31
+
12
32
  def get_item_detail_v2(
13
33
  self,
14
34
  *,
@@ -534,6 +534,32 @@ class DouyinXingtuResource(BaseResource):
534
534
  },
535
535
  )
536
536
 
537
+ def search_kol_simple_v1(
538
+ self,
539
+ *,
540
+ keyword: str,
541
+ platform_source: str,
542
+ page: int,
543
+ ) -> ApiResponse[Any]:
544
+ """
545
+ Creator Search Light
546
+
547
+ Get Douyin Creator Marketplace (Xingtu) kOL Keyword Search data, including matching creators and discovery data, for creator sourcing and shortlist building.
548
+
549
+ Args:
550
+ keyword: Search keywords.
551
+ platform_source: Platform source. Available Values: - `_1`: Douyin - `_2`: Toutiao - `_3`: Xigua
552
+ page: Page number.
553
+ """
554
+ return self._get(
555
+ "/api/douyin-xingtu/search-kol-simple/v1",
556
+ {
557
+ "keyword": keyword,
558
+ "platformSource": platform_source,
559
+ "page": page,
560
+ },
561
+ )
562
+
537
563
  def gw_api_data_sp_item_report_trend_v1(
538
564
  self,
539
565
  *,
@@ -881,3 +907,428 @@ class DouyinXingtuResource(BaseResource):
881
907
  "range": range,
882
908
  },
883
909
  )
910
+
911
+ def get_kol_info_v1(
912
+ self,
913
+ *,
914
+ kol_id: str,
915
+ platform_channel: str | None = "_1",
916
+ ) -> ApiResponse[Any]:
917
+ """
918
+ Creator Profile
919
+
920
+ Get Douyin Creator Marketplace (Xingtu) creator Profile data, including audience and pricing data, for influencer vetting, benchmark analysis, and campaign planning.
921
+
922
+ Args:
923
+ kol_id: KOL ID.
924
+ platform_channel: Platform channel. Available Values: - `_1`: Short Video - `_10`: Live Streaming
925
+ """
926
+ return self._get(
927
+ "/api/douyin-xingtu/get-kol-info/v1",
928
+ {
929
+ "kolId": kol_id,
930
+ "platformChannel": platform_channel,
931
+ },
932
+ )
933
+
934
+ def get_kol_audience_distribution_v1(
935
+ self,
936
+ *,
937
+ kol_id: str,
938
+ ) -> ApiResponse[Any]:
939
+ """
940
+ Audience Distribution
941
+
942
+ Get Douyin Creator Marketplace (Xingtu) audience Distribution data, including demographic and interest-based audience segmentation, for creator evaluation, campaign planning, and marketplace research.
943
+
944
+ Args:
945
+ kol_id: KOL ID.
946
+ """
947
+ return self._get(
948
+ "/api/douyin-xingtu/get-kol-audience-distribution/v1",
949
+ {
950
+ "kolId": kol_id,
951
+ },
952
+ )
953
+
954
+ def get_kol_fans_distribution_v1(
955
+ self,
956
+ *,
957
+ kol_id: str,
958
+ fans_type: str | None = "_1",
959
+ ) -> ApiResponse[Any]:
960
+ """
961
+ Follower Distribution
962
+
963
+ Get Douyin Creator Marketplace (Xingtu) follower distribution data, including audience demographics, interests, and distribution metrics, for creator evaluation, campaign planning, and marketplace research.
964
+
965
+ Args:
966
+ kol_id: KOL ID.
967
+ fans_type: Fans type. Available Values: - `_1`: Fans Portrait - `_5`: Iron Fans Portrait
968
+ """
969
+ return self._get(
970
+ "/api/douyin-xingtu/get-kol-fans-distribution/v1",
971
+ {
972
+ "kolId": kol_id,
973
+ "fansType": fans_type,
974
+ },
975
+ )
976
+
977
+ def get_kol_marketing_info_v1(
978
+ self,
979
+ *,
980
+ kol_id: str,
981
+ platform_channel: str | None = "_1",
982
+ ) -> ApiResponse[Any]:
983
+ """
984
+ Marketing Metrics
985
+
986
+ Get Douyin Creator Marketplace (Xingtu) marketing metrics data, including rate card details and commercial service metrics, for creator evaluation, campaign planning, and marketplace research.
987
+
988
+ Args:
989
+ kol_id: KOL ID.
990
+ platform_channel: Platform channel. Available Values: - `_1`: Short Video - `_10`: Live Streaming
991
+ """
992
+ return self._get(
993
+ "/api/douyin-xingtu/get-kol-marketing-info/v1",
994
+ {
995
+ "kolId": kol_id,
996
+ "platformChannel": platform_channel,
997
+ },
998
+ )
999
+
1000
+ def get_kol_spread_info_v1(
1001
+ self,
1002
+ *,
1003
+ kol_id: str,
1004
+ type: str | None = "_1",
1005
+ range: str | None = "_2",
1006
+ flow_type: str | None = "1",
1007
+ only_assign: bool | None = False,
1008
+ ) -> ApiResponse[Any]:
1009
+ """
1010
+ Spread Metrics
1011
+
1012
+ Get Douyin Creator Marketplace (Xingtu) spread metrics data, including audience, content performance, and commercial indicators, for quick evaluation.
1013
+
1014
+ Args:
1015
+ kol_id: KOL ID.
1016
+ type: Spread info type. Available Values: - `_1`: Personal Video - `_2`: Xingtu Video
1017
+ range: Time range. Available Values: - `_2`: Last 30 days - `_3`: Last 90 days
1018
+ flow_type: Flow type.
1019
+ only_assign: Only assigned notes.
1020
+ """
1021
+ return self._get(
1022
+ "/api/douyin-xingtu/get-kol-spread-info/v1",
1023
+ {
1024
+ "kolId": kol_id,
1025
+ "type": type,
1026
+ "range": range,
1027
+ "flowType": flow_type,
1028
+ "onlyAssign": only_assign,
1029
+ },
1030
+ )
1031
+
1032
+ def get_kol_convert_ability_v1(
1033
+ self,
1034
+ *,
1035
+ kol_id: str,
1036
+ range: str,
1037
+ ) -> ApiResponse[Any]:
1038
+ """
1039
+ Conversion Analysis
1040
+
1041
+ Get Douyin Creator Marketplace (Xingtu) conversion Analysis data, including conversion efficiency and commercial performance indicators, for creator evaluation, campaign planning, and marketplace research.
1042
+
1043
+ Args:
1044
+ kol_id: KOL ID.
1045
+ range: Time range. Available Values: - `_2`: Last 30 days - `_3`: Last 90 days
1046
+ """
1047
+ return self._get(
1048
+ "/api/douyin-xingtu/get-kol-convert-ability/v1",
1049
+ {
1050
+ "kolId": kol_id,
1051
+ "range": range,
1052
+ },
1053
+ )
1054
+
1055
+ def get_kol_show_items_v2_v1(
1056
+ self,
1057
+ *,
1058
+ kol_id: str,
1059
+ only_assign: bool | None = False,
1060
+ ) -> ApiResponse[Any]:
1061
+ """
1062
+ Showcase Items
1063
+
1064
+ Get Douyin Creator Marketplace (Xingtu) showcase items data, including core metrics, trend signals, and performance indicators, for creator evaluation, campaign planning, and marketplace research.
1065
+
1066
+ Args:
1067
+ kol_id: KOL ID.
1068
+ only_assign: Whether true is Xingtu video, false is personal video.
1069
+ """
1070
+ return self._get(
1071
+ "/api/douyin-xingtu/get-kol-show-items-v2/v1",
1072
+ {
1073
+ "kolId": kol_id,
1074
+ "onlyAssign": only_assign,
1075
+ },
1076
+ )
1077
+
1078
+ def get_kol_link_info_v1(
1079
+ self,
1080
+ *,
1081
+ kol_id: str,
1082
+ industry_tag: str | None = "",
1083
+ ) -> ApiResponse[Any]:
1084
+ """
1085
+ Creator Link Metrics
1086
+
1087
+ Get Douyin Creator Marketplace (Xingtu) creator Link Metrics data, including creator ranking, traffic structure, and related performance indicators, for creator evaluation, campaign planning, and marketplace research.
1088
+
1089
+ Args:
1090
+ kol_id: KOL ID.
1091
+ industry_tag: Industry Tag.
1092
+ """
1093
+ return self._get(
1094
+ "/api/douyin-xingtu/get-kol-link-info/v1",
1095
+ {
1096
+ "kolId": kol_id,
1097
+ "industryTag": industry_tag,
1098
+ },
1099
+ )
1100
+
1101
+ def get_kol_convert_videos_or_products_v1(
1102
+ self,
1103
+ *,
1104
+ kol_id: str,
1105
+ detail_type: str,
1106
+ page: int,
1107
+ ) -> ApiResponse[Any]:
1108
+ """
1109
+ Conversion Resources
1110
+
1111
+ Get Douyin Creator Marketplace (Xingtu) conversion Resources data, including products tied to a Douyin Xingtu creator's conversion activity, for commerce analysis and campaign optimization.
1112
+
1113
+ Args:
1114
+ kol_id: KOL ID.
1115
+ detail_type: Resource type. Available Values: - `_1`: Video Data - `_2`: Product Data
1116
+ page: Page number.
1117
+ """
1118
+ return self._get(
1119
+ "/api/douyin-xingtu/get-kol-convert-videos-or-products/v1",
1120
+ {
1121
+ "kolId": kol_id,
1122
+ "detailType": detail_type,
1123
+ "page": page,
1124
+ },
1125
+ )
1126
+
1127
+ def get_kol_link_struct_v1(
1128
+ self,
1129
+ *,
1130
+ kol_id: str,
1131
+ ) -> ApiResponse[Any]:
1132
+ """
1133
+ Creator Link Structure
1134
+
1135
+ Get Douyin Creator Marketplace (Xingtu) creator Link Structure data, including engagement and conversion metrics, for creator performance analysis.
1136
+
1137
+ Args:
1138
+ kol_id: KOL ID.
1139
+ """
1140
+ return self._get(
1141
+ "/api/douyin-xingtu/get-kol-link-struct/v1",
1142
+ {
1143
+ "kolId": kol_id,
1144
+ },
1145
+ )
1146
+
1147
+ def get_kol_touch_distribution_v1(
1148
+ self,
1149
+ *,
1150
+ kol_id: str,
1151
+ ) -> ApiResponse[Any]:
1152
+ """
1153
+ Audience Touchpoint Distribution
1154
+
1155
+ Get Douyin Creator Marketplace (Xingtu) audience touchpoint distribution data, including segment breakdowns, audience composition, and distribution signals, for traffic analysis and existing integration compatibility.
1156
+
1157
+ Args:
1158
+ kol_id: KOL ID.
1159
+ """
1160
+ return self._get(
1161
+ "/api/douyin-xingtu/get-kol-touch-distribution/v1",
1162
+ {
1163
+ "kolId": kol_id,
1164
+ },
1165
+ )
1166
+
1167
+ def get_kol_cp_info_v1(
1168
+ self,
1169
+ *,
1170
+ kol_id: str,
1171
+ ) -> ApiResponse[Any]:
1172
+ """
1173
+ Cost Performance Analysis
1174
+
1175
+ Get Douyin Creator Marketplace (Xingtu) cost Performance Analysis data, including pricing, exposure, and engagement efficiency indicators, for creator evaluation, campaign planning, and marketplace research.
1176
+
1177
+ Args:
1178
+ kol_id: KOL ID.
1179
+ """
1180
+ return self._get(
1181
+ "/api/douyin-xingtu/get-kol-cp-info/v1",
1182
+ {
1183
+ "kolId": kol_id,
1184
+ },
1185
+ )
1186
+
1187
+ def get_kol_rec_videos_v1(
1188
+ self,
1189
+ *,
1190
+ kol_id: str,
1191
+ ) -> ApiResponse[Any]:
1192
+ """
1193
+ Recommended Videos
1194
+
1195
+ Get Douyin Creator Marketplace (Xingtu) recommended videos data, including video performance metrics, for creator evaluation, campaign planning, and marketplace research.
1196
+
1197
+ Args:
1198
+ kol_id: KOL ID.
1199
+ """
1200
+ return self._get(
1201
+ "/api/douyin-xingtu/get-kol-rec-videos/v1",
1202
+ {
1203
+ "kolId": kol_id,
1204
+ },
1205
+ )
1206
+
1207
+ def get_kol_daily_fans_v1(
1208
+ self,
1209
+ *,
1210
+ kol_id: str,
1211
+ start_date: str,
1212
+ end_date: str,
1213
+ ) -> ApiResponse[Any]:
1214
+ """
1215
+ Follower Growth Trend
1216
+
1217
+ Get Douyin Creator Marketplace (Xingtu) follower Growth Trend data, including historical audience changes over time, for creator evaluation, campaign planning, and marketplace research.
1218
+
1219
+ Args:
1220
+ kol_id: KOL ID.
1221
+ start_date: Start Date (yyyy-MM-dd).
1222
+ end_date: End Date (yyyy-MM-dd).
1223
+ """
1224
+ return self._get(
1225
+ "/api/douyin-xingtu/get-kol-daily-fans/v1",
1226
+ {
1227
+ "kolId": kol_id,
1228
+ "startDate": start_date,
1229
+ "endDate": end_date,
1230
+ },
1231
+ )
1232
+
1233
+ def get_author_hot_comment_tokens_v1(
1234
+ self,
1235
+ *,
1236
+ kol_id: str,
1237
+ ) -> ApiResponse[Any]:
1238
+ """
1239
+ Comment Keyword Analysis
1240
+
1241
+ Get Douyin Creator Marketplace (Xingtu) kOL Comment Keyword Analysis data, including core metrics, trend signals, and performance indicators, for audience language analysis and comment-topic research.
1242
+
1243
+ Args:
1244
+ kol_id: KOL ID.
1245
+ """
1246
+ return self._get(
1247
+ "/api/douyin-xingtu/get-author-hot-comment-tokens/v1",
1248
+ {
1249
+ "kolId": kol_id,
1250
+ },
1251
+ )
1252
+
1253
+ def get_author_content_hot_keywords_v1(
1254
+ self,
1255
+ *,
1256
+ kol_id: str,
1257
+ ) -> ApiResponse[Any]:
1258
+ """
1259
+ Content Keyword Analysis
1260
+
1261
+ Get Douyin Creator Marketplace (Xingtu) kOL Content Keyword Analysis data, including core metrics, trend signals, and performance indicators, for content theme analysis and creator positioning research.
1262
+
1263
+ Args:
1264
+ kol_id: KOL ID.
1265
+ """
1266
+ return self._get(
1267
+ "/api/douyin-xingtu/get-author-content-hot-keywords/v1",
1268
+ {
1269
+ "kolId": kol_id,
1270
+ },
1271
+ )
1272
+
1273
+ def get_author_commerce_spread_info_v1(
1274
+ self,
1275
+ *,
1276
+ kol_id: str,
1277
+ ) -> ApiResponse[Any]:
1278
+ """
1279
+ Creator Commerce Spread Info
1280
+
1281
+ Get Douyin Creator Marketplace (Xingtu) author Commerce Spread Info data, including spread metrics, for creator evaluation for campaign planning and media buying.
1282
+
1283
+ Args:
1284
+ kol_id: KOL ID.
1285
+ """
1286
+ return self._get(
1287
+ "/api/douyin-xingtu/get-author-commerce-spread-info/v1",
1288
+ {
1289
+ "kolId": kol_id,
1290
+ },
1291
+ )
1292
+
1293
+ def get_author_commerce_seed_base_info_v1(
1294
+ self,
1295
+ *,
1296
+ kol_id: str,
1297
+ range: str,
1298
+ ) -> ApiResponse[Any]:
1299
+ """
1300
+ Commerce Seeding Base Info
1301
+
1302
+ Get Douyin Creator Marketplace (Xingtu) author Commerce Seeding Base Info data, including baseline metrics, commercial signals, and seeding indicators, for product seeding analysis, creator vetting, and campaign planning.
1303
+
1304
+ Args:
1305
+ kol_id: KOL ID.
1306
+ range: Time range.
1307
+ """
1308
+ return self._get(
1309
+ "/api/douyin-xingtu/get-author-commerce-seed-base-info/v1",
1310
+ {
1311
+ "kolId": kol_id,
1312
+ "range": range,
1313
+ },
1314
+ )
1315
+
1316
+ def get_video_detail_v1(
1317
+ self,
1318
+ *,
1319
+ detail_id: str,
1320
+ ) -> ApiResponse[Any]:
1321
+ """
1322
+ Video Details
1323
+
1324
+ Get Douyin Creator Marketplace (Xingtu) video Details data, including performance fields from the legacy Douyin Xingtu endpoint, for content review and integration compatibility.
1325
+
1326
+ Args:
1327
+ detail_id: Video detail ID.
1328
+ """
1329
+ return self._get(
1330
+ "/api/douyin-xingtu/get-video-detail/v1",
1331
+ {
1332
+ "detailId": detail_id,
1333
+ },
1334
+ )
@@ -331,6 +331,35 @@ class ImdbResource(BaseResource):
331
331
  },
332
332
  )
333
333
 
334
+ def main_search_query_v1(
335
+ self,
336
+ *,
337
+ search_term: str,
338
+ type: str | None = "Top",
339
+ limit: int | None = 25,
340
+ language_country: str | None = "en_US",
341
+ ) -> ApiResponse[Any]:
342
+ """
343
+ Keyword Search
344
+
345
+ Get IMDb keyword Search data, including matched results, metadata, and ranking signals, for entity discovery and entertainment research.
346
+
347
+ Args:
348
+ search_term: The text to search for.
349
+ type: Category of results to include in search. Available Values: - `Top`: Top Results - `Movies`: Movies - `Shows`: TV Shows - `People`: People - `Interests`: Interests - `Episodes`: Episodes - `Podcast`: Podcasts - `Video_games`: Video Games
350
+ limit: Maximum number of results to return (1-300).
351
+ 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)
352
+ """
353
+ return self._get(
354
+ "/api/imdb/main-search-query/v1",
355
+ {
356
+ "searchTerm": search_term,
357
+ "type": type,
358
+ "limit": limit,
359
+ "languageCountry": language_country,
360
+ },
361
+ )
362
+
334
363
  def streaming_picks_query_v1(
335
364
  self,
336
365
  *,