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.
- {justoneapi-3.0.35/justoneapi.egg-info → justoneapi-3.0.37}/PKG-INFO +7 -1
- justoneapi-3.0.35/PKG-INFO → justoneapi-3.0.37/README.md +6 -16
- justoneapi-3.0.37/justoneapi/_version.py +1 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/__init__.py +3 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/douyin.py +32 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/douyin_ec.py +20 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/douyin_xingtu.py +451 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/imdb.py +29 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/taobao.py +49 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/tiktok_shop.py +23 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/toutiao.py +26 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/xiaohongshu.py +305 -0
- justoneapi-3.0.37/justoneapi/generated/resources/xiaohongshu_ec.py +36 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/xiaohongshu_pgy.py +213 -0
- justoneapi-3.0.35/README.md → justoneapi-3.0.37/justoneapi.egg-info/PKG-INFO +22 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi.egg-info/SOURCES.txt +1 -0
- justoneapi-3.0.35/justoneapi/_version.py +0 -1
- {justoneapi-3.0.35 → justoneapi-3.0.37}/LICENSE +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/__init__.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/_exceptions.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/_resource.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/_response.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/_transport.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/client.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/config.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/__init__.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/models.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/amazon.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/beike.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/bilibili.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/dewu.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/douban.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/facebook.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/field_1688.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/instagram.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/jd.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/kuaishou.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/linkedin.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/llm.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/qq_huxuan.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/reddit.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/search.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/tiktok.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/twitter.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/weibo.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/weixin.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/weixin_channels.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/xianyu.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/youku.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/youtube.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/generated/resources/zhihu.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi/log.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi.egg-info/dependency_links.txt +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi.egg-info/requires.txt +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/justoneapi.egg-info/top_level.txt +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/pyproject.toml +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/setup.cfg +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/tests/test_bump_version.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/tests/test_codegen.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/tests/test_generated_surface.py +0 -0
- {justoneapi-3.0.35 → justoneapi-3.0.37}/tests/test_integration_smoke.py +0 -0
- {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.
|
|
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
|
*,
|