justoneapi 3.0.28__tar.gz → 3.0.30__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 (60) hide show
  1. {justoneapi-3.0.28 → justoneapi-3.0.30}/PKG-INFO +3 -3
  2. justoneapi-3.0.30/justoneapi/_version.py +1 -0
  3. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/douyin_xingtu.py +95 -95
  4. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi.egg-info/PKG-INFO +3 -3
  5. justoneapi-3.0.28/justoneapi/_version.py +0 -1
  6. {justoneapi-3.0.28 → justoneapi-3.0.30}/LICENSE +0 -0
  7. {justoneapi-3.0.28 → justoneapi-3.0.30}/README.md +2 -2
  8. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/__init__.py +0 -0
  9. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/_exceptions.py +0 -0
  10. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/_resource.py +0 -0
  11. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/_response.py +0 -0
  12. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/_transport.py +0 -0
  13. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/client.py +0 -0
  14. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/config.py +0 -0
  15. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/__init__.py +0 -0
  16. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/models.py +0 -0
  17. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/__init__.py +0 -0
  18. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/amazon.py +0 -0
  19. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/beike.py +0 -0
  20. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/bilibili.py +0 -0
  21. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/dewu.py +0 -0
  22. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/douban.py +0 -0
  23. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/douyin.py +0 -0
  24. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/douyin_ec.py +0 -0
  25. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/facebook.py +0 -0
  26. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/field_1688.py +0 -0
  27. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/imdb.py +0 -0
  28. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/instagram.py +0 -0
  29. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/jd.py +0 -0
  30. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/kuaishou.py +0 -0
  31. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/llm.py +0 -0
  32. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/qq_huxuan.py +0 -0
  33. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/reddit.py +0 -0
  34. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/search.py +0 -0
  35. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/taobao.py +0 -0
  36. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/tiktok.py +0 -0
  37. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/tiktok_shop.py +0 -0
  38. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/toutiao.py +0 -0
  39. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/twitter.py +0 -0
  40. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/weibo.py +0 -0
  41. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/weixin.py +0 -0
  42. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/weixin_channels.py +0 -0
  43. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/xianyu.py +0 -0
  44. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/xiaohongshu.py +0 -0
  45. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/xiaohongshu_pgy.py +173 -173
  46. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/youku.py +0 -0
  47. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/youtube.py +0 -0
  48. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/generated/resources/zhihu.py +0 -0
  49. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi/log.py +0 -0
  50. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi.egg-info/SOURCES.txt +0 -0
  51. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi.egg-info/dependency_links.txt +0 -0
  52. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi.egg-info/requires.txt +0 -0
  53. {justoneapi-3.0.28 → justoneapi-3.0.30}/justoneapi.egg-info/top_level.txt +0 -0
  54. {justoneapi-3.0.28 → justoneapi-3.0.30}/pyproject.toml +0 -0
  55. {justoneapi-3.0.28 → justoneapi-3.0.30}/setup.cfg +0 -0
  56. {justoneapi-3.0.28 → justoneapi-3.0.30}/tests/test_bump_version.py +0 -0
  57. {justoneapi-3.0.28 → justoneapi-3.0.30}/tests/test_codegen.py +0 -0
  58. {justoneapi-3.0.28 → justoneapi-3.0.30}/tests/test_generated_surface.py +0 -0
  59. {justoneapi-3.0.28 → justoneapi-3.0.30}/tests/test_integration_smoke.py +0 -0
  60. {justoneapi-3.0.28 → justoneapi-3.0.30}/tests/test_runtime.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: justoneapi
3
- Version: 3.0.28
3
+ Version: 3.0.30
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
@@ -186,6 +186,7 @@ except BusinessError as exc:
186
186
 
187
187
  ### 小红书蒲公英
188
188
 
189
+ - [创作者搜索 (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)
189
190
  - [创作者资料 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-profile-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
190
191
  - [数据摘要 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/data-summary-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
191
192
  - [粉丝增长历史 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/follower-growth-history-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -197,7 +198,6 @@ except BusinessError as exc:
197
198
  - [粉丝分布 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/follower-distribution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
198
199
  - [成本效益分析 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/cost-effectiveness-analysis-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
199
200
  - [笔记详情 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/note-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
200
- - [创作者搜索 (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)
201
201
  - [创作者核心指标 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-core-metrics-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
202
202
  - [内容广场笔记 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/content-square-notes-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
203
203
  - [创作者资料 (V1)(已弃用)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-profile-v1-deprecated?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list#deprecated)
@@ -235,6 +235,7 @@ except BusinessError as exc:
235
235
 
236
236
  ### 抖音巨量星图
237
237
 
238
+ - [创作者搜索 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
238
239
  - [创作者资料 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-profile-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
239
240
  - [创作者链接结构 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-link-structure-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
240
241
  - [创作者可见性状态 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-visibility-status-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -252,7 +253,6 @@ except BusinessError as exc:
252
253
  - [受众触点分布 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/audience-touchpoint-distribution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
253
254
  - [推荐视频 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/recommended-videos-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
254
255
  - [粉丝分布 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/follower-distribution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
255
- - [创作者搜索 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
256
256
  - [创作者搜索轻量版 (V1)(已弃用)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-search-light-v1-deprecated?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list#deprecated)
257
257
  - [商品报告趋势 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/item-report-trends-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
258
258
  - [视频详情 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/video-details-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.30"
@@ -9,6 +9,101 @@ from justoneapi._response import ApiResponse
9
9
  class DouyinXingtuResource(BaseResource):
10
10
  """Generated resource for Douyin Creator Marketplace (Xingtu)."""
11
11
 
12
+ def gw_api_gsearch_search_for_author_square_v1(
13
+ self,
14
+ *,
15
+ keyword: str | None = "",
16
+ page: int | None = 1,
17
+ sort: str | None = "FANS",
18
+ search_type: str | None = "NICKNAME",
19
+ marketing_target: str | None = None,
20
+ industry: str | None = "ALL",
21
+ is_superstar: bool | None = False,
22
+ follower_range: str | None = None,
23
+ kol_price_type: str | None = None,
24
+ kol_price_range: str | None = None,
25
+ content_tag: str | None = None,
26
+ content_theme: str | None = None,
27
+ persona_tag: str | None = None,
28
+ gender: str | None = None,
29
+ location: str | None = None,
30
+ tonality_tag: str | None = None,
31
+ connected_user_range: str | None = None,
32
+ audience_image: str | None = None,
33
+ fans_image: str | None = None,
34
+ expected_play_range: str | None = None,
35
+ expected_cpm_range: str | None = None,
36
+ expected_cpe_range: str | None = None,
37
+ interaction_rate_range: str | None = None,
38
+ completion_rate_range: str | None = None,
39
+ viral_rate_range: str | None = None,
40
+ progress_task_range: str | None = None,
41
+ ) -> ApiResponse[Any]:
42
+ """
43
+ Creator Search
44
+
45
+ Get Douyin Creator Marketplace (Xingtu) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building.
46
+
47
+ Args:
48
+ keyword: Search keyword.
49
+ page: Page number for pagination.
50
+ sort: Creator search sorting. Values: FANS sorts by follower count descending, DEFAULT uses Xingtu score ranking. Available Values: - `DEFAULT`: Platform default score ranking - `FANS`: Sort by follower count descending
51
+ search_type: Search criteria type. Available Values: - `NICKNAME`: By Nickname - `CONTENT`: By Content
52
+ marketing_target: Marketing goal. Available values: BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化. Available Values: - `BRAND_EXPOSURE`: Brand exposure - `CIRCLE_SEEDING`: Out-of-circle seeding - `ACTION_CONVERSION`: Action conversion
53
+ industry: Recommended industry filter. Pass enum name, numeric industry ID, or Chinese industry label. Available values: - ALL/0/不限; - 1901: 3C及电器; - 1938: 购物; - 1903: 食品饮料; - 1904: 服装配饰; - 1905: 医药健康; - 1936: 医疗机构; - 1909: 家居建材; - 1907: 生活服务; - 1906: 商务服务; - 1921: 休闲娱乐; - 1937: 丽人; - 1908: 房地产; - 1910: 教育培训; - 1911: 出行旅游; - 1912: 社会公共; - 1913: 游戏; - 1914: 互联网电商服务; - 1915: 交通工具; - 1916: 汽车; - 1917: 农资园艺; - 1920: 机械设备; - 1939: 文化用品; - 1940: 运动户外; - 1922: 传媒资讯; - 1924: 通信; - 1925: 金融业; - 1927: 餐饮服务; - 1928: 工具类软件; - 1929: 招商加盟; - 1930: 美妆; - 1931: 母婴宠物; - 1933: 日化; - 1934: 实体书籍; - 1935: 社交通讯. Example: 美妆 Available Values: - `ALL`: All - `ELECTRONICS_AND_APPLIANCES`: Electronics and Appliances - `SHOPPING`: Shopping - `FOOD_AND_BEVERAGE`: Food and Beverage - `CLOTHING_AND_ACCESSORIES`: Clothing and Accessories - `HEALTHCARE_AND_MEDICAL`: Healthcare and Medical - `MEDICAL_INSTITUTIONS`: Medical Institutions - `HOME_AND_BUILDING_MATERIALS`: Home and Building Materials - `LOCAL_SERVICES`: Local Services - `BUSINESS_SERVICES`: Business Services - `CULTURE_SPORTS_ENTERTAINMENT`: Leisure and Entertainment - `BEAUTY_SERVICES`: Beauty Services - `REAL_ESTATE`: Real Estate - `EDUCATION_AND_TRAINING`: Education and Training - `TRAVEL_AND_TOURISM`: Travel and Tourism - `PUBLIC_SERVICES`: Public Services - `GAMES`: Games - `RETAIL`: Internet E-commerce Services - `TRANSPORTATION_EQUIPMENT`: Transportation Equipment - `AUTOMOTIVE`: Automotive - `AGRICULTURE_FORESTRY_FISHERY`: Agriculture Forestry Fishery - `CHEMICAL_AND_ENERGY`: Chemical and Energy - `ELECTRONICS_AND_ELECTRICAL`: Electronics and Electrical - `MACHINERY_EQUIPMENT`: Machinery Equipment - `MEDIA_AND_INFORMATION`: Media and Information - `LOGISTICS`: Logistics - `TELECOMMUNICATIONS`: Telecommunications - `FINANCIAL_SERVICES`: Financial Services - `CATERING_SERVICES`: Catering Services - `SOFTWARE_TOOLS`: Software Tools - `FRANCHISING_AND_INVESTMENT`: Franchising and Investment - `BEAUTY_AND_COSMETICS`: Beauty and Cosmetics - `MOTHER_BABY_AND_PET`: Mother Baby and Pet - `DAILY_CHEMICALS`: Daily Chemicals - `PHYSICAL_BOOKS`: Physical Books - `SOCIAL_AND_COMMUNICATION`: Social and Communication - `CULTURAL_SUPPLIES`: Cultural Supplies - `SPORTS_OUTDOOR`: Sports and Outdoors
54
+ is_superstar: Whether to filter celebrity creators.
55
+ follower_range: Raw follower count range in min-max format. Example: 1000-2000 means 1,000 to 2,000 followers; 5000000-10000000 means 5 million to 10 million followers.
56
+ kol_price_type: KOL price type. Available Values: - `VIDEO_1_20S`: Video 1-20s - `VIDEO_21_60S`: Video 21-60s - `VIDEO_OVER_60S`: Video > 60s - `CUSTOM_SHORT_DRAMA_EPISODE`: Mini-drama episode - `NATURAL_PLAY_CPM`: CPM naturally - `SHORT_LIVE_SEEDING_VIDEO`: Short-live seeding video - `SHORT_LIVE_WARMUP_VIDEO`: Short-live warm-up video - `CELEBRITY_SHORT_LIVE_SEEDING`: Celebrity short-live seeding - `CELEBRITY_SHORT_LIVE_WARMUP`: Celebrity short-live warm-up - `CELEBRITY_VIDEO`: Celebrity video - `COLLECTION_VIDEO`: Collection video - `DOUYIN_SHORT_VIDEO_CO_CREATION_MAIN_CREATOR`: Douyin short video co-creation - main creator - `DOUYIN_SHORT_VIDEO_CO_CREATION_PARTICIPANT`: Douyin short video co-creation - participant
57
+ kol_price_range: KOL price range (e.g., 10000-50000).
58
+ content_tag: Creator category filter. Pass Xingtu first-level or second-level category labels separated by commas. Available values: - 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次元: 二次元真人, 动画漫画, 配音声优, 宅物手办; - 旅行: 旅行记录, 旅行攻略, 旅行推荐, 户外生活; - 汽车: 汽车测评, 汽车知识, 汽车周边; - 生活: 生活记录, 生活小窍门, 好物推荐, 健康养生, 婚恋; - 音乐: 歌曲演唱, 乐器演奏, 音乐教学, 音乐其他, 音乐剪辑; - 舞蹈; - 美食: 美食教程, 美食探店, 美食产品测评, 乡村野食, 美食其他, 酒类; - 母婴亲子: 育儿科普, 萌娃日常, 亲子互动, 测评种草; - 运动健身: 健身, 极限运动, 体育资讯, 冰雪, 垂钓, 格斗, 球类项目, 综合体育; - 科技数码: 3C数码, 家居电器, 科技; - 教育培训: 考学培训, 语言教学, 个人管理, 职业教育; - 颜值达人: 美女, 帅哥; - 生活家居: 硬装, 软装, 生活技巧, 家居氛围; - 才艺技能: 创意才能, 手工, 摄影, 绘画, 其他才艺; - 影视娱乐: 影视解说, 影视混剪, 明星资讯, 综艺解说, 综艺混剪; - 艺术文化: 传统文化, 人文科普, 自然科学; - 财经投资: 传统金融, 互联网金融, 财经知识; - 三农; - 剧情搞笑: 剧情, 搞笑; - 情感; - 园艺; - 房产: 其他房产, 房产知识, 房产及投资, 楼盘评测, 楼市资讯, 租房; - 随拍; - 媒体号. Example: 美妆,穿搭,剧情搞笑
59
+ content_theme: Content theme filter. Pass Xingtu second-level content theme labels separated by commas. Available values include: - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常菜谱, 美食探店, 零食测评, 酒水品鉴, 厨房用品, 海鲜烹饪, 减脂美食; - 精彩车生活: 汽车行业资讯, 用车知识, 车辆保养, 自驾旅行, 新能源汽车资讯, 汽车用品测评, SUV测评; - 手机/数码/家电分享: 科技科普, 电子产品测评, 家电推荐, 手机评测, 智能家居, AI应用, 数码开箱; - 剧情演绎: 搞笑剧情, 剧情反转, 情感演绎, 家庭幽默演绎, 职场趣闻, 古风剧情, 生存挑战; - 萌宠养护: 宠物狗故事, 动物萌态, 宠物养护, 猫咪萌态, 宠物健康, 宠物护理, 宠物救助; - 旅行攻略: 国内旅行, 海外旅行, 城市旅行攻略, 酒店体验, 露营体验, 亲子旅行, 网红景点种草; - 家居好物: 清洁技巧, 生活好物评测, 家居选购, 家居装修, 家居收纳, 家装避坑, 房间布置; - 运动户外: 户外运动, 健身塑形, 赛事回顾, 体重管理, 极限运动, 跑步健身, 户外露营. Example: 亲子活动,宝宝辅食
60
+ persona_tag: Creator persona or background labels. Pass Xingtu labels or numeric tag IDs separated by commas. Available values: - 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白, 抗老, 祛皱, 抗炎, 修复, 控油, 眼部护理, 补水保湿, 祛斑, 祛痘祛闭口, 隔离防晒; - 母婴阶段: 孕期, 0-6月, 7-12月, 1-3岁, 3-6岁, 6-12岁, 12-15岁, 15-18岁; - 爱好: 摄影, 时尚穿搭, 美食制作, 科普, 星座, 绘画; - 职业: 法律从业者, 航空业从业者, 健身/舞蹈教练, 专业美食从业者, 室内设计师; - 学历: 大学生, 硕士生, 博士, 留学生; - 黄v认证: 美妆创作者, 体育创作者, 媒体人/主持人, 科技创作者, 运动员; - Other labels: 潮流运动, 球类, 非球类, 室内健身, 城市运动, 户外运动, 数码潮流玩家, 户外爱好者, 室内设计师, 品酒家/调酒师, 美食评论人, 母婴行业专家, 奶爸, 旧屋改造, 装修设计, 收纳, 新生儿妈妈, 孕妈, 时尚妈妈, 二三胎妈妈, 西餐, 火锅, 国风爱好者, 成分党. Example: 大学生,美妆创作者
61
+ gender: Creator gender. Available values: MALE/1/男性, FEMALE/2/女性. Available Values: - `MALE`: Male - `FEMALE`: Female
62
+ location: Creator location filter. Pass Chinese province or city names separated by commas. Available province values include: 北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别行政区, 澳门特别行政区. Example: 广东省,深圳市
63
+ tonality_tag: Creator tonality labels. Pass Xingtu first-level or second-level tonality labels separated by commas. Available values: - 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球. Example: 精致达人,设计师
64
+ connected_user_range: Connected user count range. Pass raw user counts in min-max format. Example: 1000000-3000000
65
+ audience_image: Audience profile filter from Xingtu Audience Image. Pass one or more shortcut values separated by commas. Available values: - Gender: GENDER_MALE_50, GENDER_MALE_60, GENDER_MALE_70, GENDER_MALE_80, GENDER_FEMALE_50, GENDER_FEMALE_60, GENDER_FEMALE_70, GENDER_FEMALE_80; - Age: AGE_18_23, AGE_24_30, AGE_31_40, AGE_41_50, AGE_GT_50; - Device: DEVICE_IPHONE, DEVICE_HUAWEI, DEVICE_XIAOMI, DEVICE_VIVO, DEVICE_OPPO; - City tier: CITY_TIER_1, CITY_TIER_2, CITY_TIER_3, CITY_TIER_4, CITY_TIER_5; - Average order amount: SPEND_0_50, SPEND_50_100, SPEND_100_200, SPEND_200_500, SPEND_GT_500; - Crowd profile: CROWD_REFINED_MOTHER(53 精致妈妈), CROWD_URBAN_SILVER(54 都市银发), CROWD_NEW_WHITE_COLLAR(55 新锐白领), CROWD_SENIOR_MIDDLE_CLASS(56 资深中产), CROWD_URBAN_BLUE_COLLAR(57 都市蓝领), CROWD_GEN_Z(58 Z世代), CROWD_TOWN_MIDDLE_AGED(59 小镇中老年), CROWD_TOWN_YOUTH(60 小镇青年). Example: GENDER_FEMALE_50,CROWD_REFINED_MOTHER
66
+ fans_image: Fan profile filter from Xingtu Fan Image. Pass one or more shortcut values separated by commas. Available values: - Gender: GENDER_MALE_50, GENDER_MALE_60, GENDER_MALE_70, GENDER_MALE_80, GENDER_FEMALE_50, GENDER_FEMALE_60, GENDER_FEMALE_70, GENDER_FEMALE_80; - Age: AGE_18_23, AGE_24_30, AGE_31_40, AGE_41_50, AGE_GT_50; - Device: DEVICE_IPHONE, DEVICE_HUAWEI, DEVICE_XIAOMI, DEVICE_VIVO, DEVICE_OPPO; - City tier: CITY_TIER_1, CITY_TIER_2, CITY_TIER_3, CITY_TIER_4, CITY_TIER_5; - Average order amount: SPEND_0_50, SPEND_50_100, SPEND_100_200, SPEND_200_500, SPEND_GT_500; - Crowd profile: CROWD_REFINED_MOTHER(53 精致妈妈), CROWD_URBAN_SILVER(54 都市银发), CROWD_NEW_WHITE_COLLAR(55 新锐白领), CROWD_SENIOR_MIDDLE_CLASS(56 资深中产), CROWD_URBAN_BLUE_COLLAR(57 都市蓝领), CROWD_GEN_Z(58 Z世代), CROWD_TOWN_MIDDLE_AGED(59 小镇中老年), CROWD_TOWN_YOUTH(60 小镇青年). Example: GENDER_FEMALE_50,CROWD_REFINED_MOTHER
67
+ expected_play_range: Expected play count range. Use raw counts in min-max format. Page presets include 10000000 or above, 5000000-10000000, 3000000-5000000, 1000000-3000000, 100000-1000000, and 0-100000. For open-ended presets, pass a high upper bound such as 10000000-1000000000. Example: 1000000-3000000.
68
+ expected_cpm_range: Expected CPM range in min-max format. Example values matching Xingtu packs: 0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000.
69
+ expected_cpe_range: Expected CPE range in min-max format. Example values matching Xingtu packs: 0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000.
70
+ interaction_rate_range: Interaction rate range in decimal min-max format. Example values: 0.01-1 for 1% or above, 0.02-1 for 2% or above.
71
+ completion_rate_range: Completion rate range in decimal min-max format. Example values: 0.1-1 for 10% or above, 0.2-1 for 20% or above.
72
+ viral_rate_range: Viral content rate range in decimal min-max format. Page presets include 0-0.1, 0.1-0.25, 0.25-0.5, 0.5-0.99, and 0.99 or above. For open-ended presets, pass a high upper bound such as 0.99-1. Example: 0.1-0.25.
73
+ progress_task_range: In-progress task count range. Format is days:min-max. Use open-ended ranges as days:min- or days:-max. Example: 30:8-
74
+ """
75
+ return self._get(
76
+ "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1",
77
+ {
78
+ "keyword": keyword,
79
+ "page": page,
80
+ "sort": sort,
81
+ "searchType": search_type,
82
+ "marketingTarget": marketing_target,
83
+ "industry": industry,
84
+ "isSuperstar": is_superstar,
85
+ "followerRange": follower_range,
86
+ "kolPriceType": kol_price_type,
87
+ "kolPriceRange": kol_price_range,
88
+ "contentTag": content_tag,
89
+ "contentTheme": content_theme,
90
+ "personaTag": persona_tag,
91
+ "gender": gender,
92
+ "location": location,
93
+ "tonalityTag": tonality_tag,
94
+ "connectedUserRange": connected_user_range,
95
+ "audienceImage": audience_image,
96
+ "fansImage": fans_image,
97
+ "expectedPlayRange": expected_play_range,
98
+ "expectedCpmRange": expected_cpm_range,
99
+ "expectedCpeRange": expected_cpe_range,
100
+ "interactionRateRange": interaction_rate_range,
101
+ "completionRateRange": completion_rate_range,
102
+ "viralRateRange": viral_rate_range,
103
+ "progressTaskRange": progress_task_range,
104
+ },
105
+ )
106
+
12
107
  def gw_api_author_get_author_base_info_v1(
13
108
  self,
14
109
  *,
@@ -439,101 +534,6 @@ class DouyinXingtuResource(BaseResource):
439
534
  },
440
535
  )
441
536
 
442
- def gw_api_gsearch_search_for_author_square_v1(
443
- self,
444
- *,
445
- keyword: str | None = "",
446
- page: int | None = 1,
447
- sort: str | None = "FANS",
448
- search_type: str | None = "NICKNAME",
449
- marketing_target: str | None = None,
450
- industry: str | None = "ALL",
451
- is_superstar: bool | None = False,
452
- follower_range: str | None = None,
453
- kol_price_type: str | None = None,
454
- kol_price_range: str | None = None,
455
- content_tag: str | None = None,
456
- content_theme: str | None = None,
457
- persona_tag: str | None = None,
458
- gender: str | None = None,
459
- location: str | None = None,
460
- tonality_tag: str | None = None,
461
- connected_user_range: str | None = None,
462
- audience_image: str | None = None,
463
- fans_image: str | None = None,
464
- expected_play_range: str | None = None,
465
- expected_cpm_range: str | None = None,
466
- expected_cpe_range: str | None = None,
467
- interaction_rate_range: str | None = None,
468
- completion_rate_range: str | None = None,
469
- viral_rate_range: str | None = None,
470
- progress_task_range: str | None = None,
471
- ) -> ApiResponse[Any]:
472
- """
473
- Creator Search
474
-
475
- Get Douyin Creator Marketplace (Xingtu) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building.
476
-
477
- Args:
478
- keyword: Search keyword.
479
- page: Page number for pagination.
480
- sort: Creator search sorting. Values: FANS sorts by follower count descending, DEFAULT uses Xingtu score ranking. Available Values: - `DEFAULT`: Platform default score ranking - `FANS`: Sort by follower count descending
481
- search_type: Search criteria type. Available Values: - `NICKNAME`: By Nickname - `CONTENT`: By Content
482
- marketing_target: Marketing goal. Available values: BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化. Available Values: - `BRAND_EXPOSURE`: Brand exposure - `CIRCLE_SEEDING`: Out-of-circle seeding - `ACTION_CONVERSION`: Action conversion
483
- industry: Recommended industry filter. Pass enum name, numeric industry ID, or Chinese industry label. Available values: - ALL/0/不限; - 1901: 3C及电器; - 1938: 购物; - 1903: 食品饮料; - 1904: 服装配饰; - 1905: 医药健康; - 1936: 医疗机构; - 1909: 家居建材; - 1907: 生活服务; - 1906: 商务服务; - 1921: 休闲娱乐; - 1937: 丽人; - 1908: 房地产; - 1910: 教育培训; - 1911: 出行旅游; - 1912: 社会公共; - 1913: 游戏; - 1914: 互联网电商服务; - 1915: 交通工具; - 1916: 汽车; - 1917: 农资园艺; - 1920: 机械设备; - 1939: 文化用品; - 1940: 运动户外; - 1922: 传媒资讯; - 1924: 通信; - 1925: 金融业; - 1927: 餐饮服务; - 1928: 工具类软件; - 1929: 招商加盟; - 1930: 美妆; - 1931: 母婴宠物; - 1933: 日化; - 1934: 实体书籍; - 1935: 社交通讯. Example: 美妆 Available Values: - `ALL`: All - `ELECTRONICS_AND_APPLIANCES`: Electronics and Appliances - `SHOPPING`: Shopping - `FOOD_AND_BEVERAGE`: Food and Beverage - `CLOTHING_AND_ACCESSORIES`: Clothing and Accessories - `HEALTHCARE_AND_MEDICAL`: Healthcare and Medical - `MEDICAL_INSTITUTIONS`: Medical Institutions - `HOME_AND_BUILDING_MATERIALS`: Home and Building Materials - `LOCAL_SERVICES`: Local Services - `BUSINESS_SERVICES`: Business Services - `CULTURE_SPORTS_ENTERTAINMENT`: Leisure and Entertainment - `BEAUTY_SERVICES`: Beauty Services - `REAL_ESTATE`: Real Estate - `EDUCATION_AND_TRAINING`: Education and Training - `TRAVEL_AND_TOURISM`: Travel and Tourism - `PUBLIC_SERVICES`: Public Services - `GAMES`: Games - `RETAIL`: Internet E-commerce Services - `TRANSPORTATION_EQUIPMENT`: Transportation Equipment - `AUTOMOTIVE`: Automotive - `AGRICULTURE_FORESTRY_FISHERY`: Agriculture Forestry Fishery - `CHEMICAL_AND_ENERGY`: Chemical and Energy - `ELECTRONICS_AND_ELECTRICAL`: Electronics and Electrical - `MACHINERY_EQUIPMENT`: Machinery Equipment - `MEDIA_AND_INFORMATION`: Media and Information - `LOGISTICS`: Logistics - `TELECOMMUNICATIONS`: Telecommunications - `FINANCIAL_SERVICES`: Financial Services - `CATERING_SERVICES`: Catering Services - `SOFTWARE_TOOLS`: Software Tools - `FRANCHISING_AND_INVESTMENT`: Franchising and Investment - `BEAUTY_AND_COSMETICS`: Beauty and Cosmetics - `MOTHER_BABY_AND_PET`: Mother Baby and Pet - `DAILY_CHEMICALS`: Daily Chemicals - `PHYSICAL_BOOKS`: Physical Books - `SOCIAL_AND_COMMUNICATION`: Social and Communication - `CULTURAL_SUPPLIES`: Cultural Supplies - `SPORTS_OUTDOOR`: Sports and Outdoors
484
- is_superstar: Whether to filter celebrity creators.
485
- follower_range: Follower range (e.g., 10-100).
486
- kol_price_type: KOL price type. Available Values: - `VIDEO_1_20S`: Video 1-20s - `VIDEO_21_60S`: Video 21-60s - `VIDEO_OVER_60S`: Video > 60s - `CUSTOM_SHORT_DRAMA_EPISODE`: Mini-drama episode - `NATURAL_PLAY_CPM`: CPM naturally - `SHORT_LIVE_SEEDING_VIDEO`: Short-live seeding video - `SHORT_LIVE_WARMUP_VIDEO`: Short-live warm-up video - `CELEBRITY_SHORT_LIVE_SEEDING`: Celebrity short-live seeding - `CELEBRITY_SHORT_LIVE_WARMUP`: Celebrity short-live warm-up - `CELEBRITY_VIDEO`: Celebrity video - `COLLECTION_VIDEO`: Collection video - `DOUYIN_SHORT_VIDEO_CO_CREATION_MAIN_CREATOR`: Douyin short video co-creation - main creator - `DOUYIN_SHORT_VIDEO_CO_CREATION_PARTICIPANT`: Douyin short video co-creation - participant
487
- kol_price_range: KOL price range (e.g., 10000-50000).
488
- content_tag: Creator category filter. Pass Xingtu first-level or second-level category labels separated by commas. Available values: - 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次元: 二次元真人, 动画漫画, 配音声优, 宅物手办; - 旅行: 旅行记录, 旅行攻略, 旅行推荐, 户外生活; - 汽车: 汽车测评, 汽车知识, 汽车周边; - 生活: 生活记录, 生活小窍门, 好物推荐, 健康养生, 婚恋; - 音乐: 歌曲演唱, 乐器演奏, 音乐教学, 音乐其他, 音乐剪辑; - 舞蹈; - 美食: 美食教程, 美食探店, 美食产品测评, 乡村野食, 美食其他, 酒类; - 母婴亲子: 育儿科普, 萌娃日常, 亲子互动, 测评种草; - 运动健身: 健身, 极限运动, 体育资讯, 冰雪, 垂钓, 格斗, 球类项目, 综合体育; - 科技数码: 3C数码, 家居电器, 科技; - 教育培训: 考学培训, 语言教学, 个人管理, 职业教育; - 颜值达人: 美女, 帅哥; - 生活家居: 硬装, 软装, 生活技巧, 家居氛围; - 才艺技能: 创意才能, 手工, 摄影, 绘画, 其他才艺; - 影视娱乐: 影视解说, 影视混剪, 明星资讯, 综艺解说, 综艺混剪; - 艺术文化: 传统文化, 人文科普, 自然科学; - 财经投资: 传统金融, 互联网金融, 财经知识; - 三农; - 剧情搞笑: 剧情, 搞笑; - 情感; - 园艺; - 房产: 其他房产, 房产知识, 房产及投资, 楼盘评测, 楼市资讯, 租房; - 随拍; - 媒体号. Example: 美妆,穿搭,剧情搞笑
489
- content_theme: Content theme filter. Pass Xingtu second-level content theme labels separated by commas. Available values include: - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常菜谱, 美食探店, 零食测评, 酒水品鉴, 厨房用品, 海鲜烹饪, 减脂美食; - 精彩车生活: 汽车行业资讯, 用车知识, 车辆保养, 自驾旅行, 新能源汽车资讯, 汽车用品测评, SUV测评; - 手机/数码/家电分享: 科技科普, 电子产品测评, 家电推荐, 手机评测, 智能家居, AI应用, 数码开箱; - 剧情演绎: 搞笑剧情, 剧情反转, 情感演绎, 家庭幽默演绎, 职场趣闻, 古风剧情, 生存挑战; - 萌宠养护: 宠物狗故事, 动物萌态, 宠物养护, 猫咪萌态, 宠物健康, 宠物护理, 宠物救助; - 旅行攻略: 国内旅行, 海外旅行, 城市旅行攻略, 酒店体验, 露营体验, 亲子旅行, 网红景点种草; - 家居好物: 清洁技巧, 生活好物评测, 家居选购, 家居装修, 家居收纳, 家装避坑, 房间布置; - 运动户外: 户外运动, 健身塑形, 赛事回顾, 体重管理, 极限运动, 跑步健身, 户外露营. Example: 亲子活动,宝宝辅食
490
- persona_tag: Creator persona or background labels. Pass Xingtu labels or numeric tag IDs separated by commas. Available values: - 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白, 抗老, 祛皱, 抗炎, 修复, 控油, 眼部护理, 补水保湿, 祛斑, 祛痘祛闭口, 隔离防晒; - 母婴阶段: 孕期, 0-6月, 7-12月, 1-3岁, 3-6岁, 6-12岁, 12-15岁, 15-18岁; - 爱好: 摄影, 时尚穿搭, 美食制作, 科普, 星座, 绘画; - 职业: 法律从业者, 航空业从业者, 健身/舞蹈教练, 专业美食从业者, 室内设计师; - 学历: 大学生, 硕士生, 博士, 留学生; - 黄v认证: 美妆创作者, 体育创作者, 媒体人/主持人, 科技创作者, 运动员; - Other labels: 潮流运动, 球类, 非球类, 室内健身, 城市运动, 户外运动, 数码潮流玩家, 户外爱好者, 室内设计师, 品酒家/调酒师, 美食评论人, 母婴行业专家, 奶爸, 旧屋改造, 装修设计, 收纳, 新生儿妈妈, 孕妈, 时尚妈妈, 二三胎妈妈, 西餐, 火锅, 国风爱好者, 成分党. Example: 大学生,美妆创作者
491
- gender: Creator gender. Available values: MALE/1/男性, FEMALE/2/女性. Available Values: - `MALE`: Male - `FEMALE`: Female
492
- location: Creator location filter. Pass Chinese province or city names separated by commas. Available province values include: 北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别行政区, 澳门特别行政区. Example: 广东省,深圳市
493
- tonality_tag: Creator tonality labels. Pass Xingtu first-level or second-level tonality labels separated by commas. Available values: - 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球. Example: 精致达人,设计师
494
- connected_user_range: Connected user count range. Pass raw user counts in min-max format. Example: 1000000-3000000
495
- audience_image: Audience profile filter from Xingtu Audience Image. Pass one or more shortcut values separated by commas. Available values: - Gender: GENDER_MALE_50, GENDER_MALE_60, GENDER_MALE_70, GENDER_MALE_80, GENDER_FEMALE_50, GENDER_FEMALE_60, GENDER_FEMALE_70, GENDER_FEMALE_80; - Age: AGE_18_23, AGE_24_30, AGE_31_40, AGE_41_50, AGE_GT_50; - Device: DEVICE_IPHONE, DEVICE_HUAWEI, DEVICE_XIAOMI, DEVICE_VIVO, DEVICE_OPPO; - City tier: CITY_TIER_1, CITY_TIER_2, CITY_TIER_3, CITY_TIER_4, CITY_TIER_5; - Average order amount: SPEND_0_50, SPEND_50_100, SPEND_100_200, SPEND_200_500, SPEND_GT_500; - Crowd profile: CROWD_REFINED_MOTHER(53 精致妈妈), CROWD_URBAN_SILVER(54 都市银发), CROWD_NEW_WHITE_COLLAR(55 新锐白领), CROWD_SENIOR_MIDDLE_CLASS(56 资深中产), CROWD_URBAN_BLUE_COLLAR(57 都市蓝领), CROWD_GEN_Z(58 Z世代), CROWD_TOWN_MIDDLE_AGED(59 小镇中老年), CROWD_TOWN_YOUTH(60 小镇青年). Example: GENDER_FEMALE_50,CROWD_REFINED_MOTHER
496
- fans_image: Fan profile filter from Xingtu Fan Image. Pass one or more shortcut values separated by commas. Available values: - Gender: GENDER_MALE_50, GENDER_MALE_60, GENDER_MALE_70, GENDER_MALE_80, GENDER_FEMALE_50, GENDER_FEMALE_60, GENDER_FEMALE_70, GENDER_FEMALE_80; - Age: AGE_18_23, AGE_24_30, AGE_31_40, AGE_41_50, AGE_GT_50; - Device: DEVICE_IPHONE, DEVICE_HUAWEI, DEVICE_XIAOMI, DEVICE_VIVO, DEVICE_OPPO; - City tier: CITY_TIER_1, CITY_TIER_2, CITY_TIER_3, CITY_TIER_4, CITY_TIER_5; - Average order amount: SPEND_0_50, SPEND_50_100, SPEND_100_200, SPEND_200_500, SPEND_GT_500; - Crowd profile: CROWD_REFINED_MOTHER(53 精致妈妈), CROWD_URBAN_SILVER(54 都市银发), CROWD_NEW_WHITE_COLLAR(55 新锐白领), CROWD_SENIOR_MIDDLE_CLASS(56 资深中产), CROWD_URBAN_BLUE_COLLAR(57 都市蓝领), CROWD_GEN_Z(58 Z世代), CROWD_TOWN_MIDDLE_AGED(59 小镇中老年), CROWD_TOWN_YOUTH(60 小镇青年). Example: GENDER_FEMALE_50,CROWD_REFINED_MOTHER
497
- expected_play_range: Expected play count range. Use raw counts in min-max format. Page presets include 10000000 or above, 5000000-10000000, 3000000-5000000, 1000000-3000000, 100000-1000000, and 0-100000. For open-ended presets, pass a high upper bound such as 10000000-1000000000. Example: 1000000-3000000.
498
- expected_cpm_range: Expected CPM range in min-max format. Example values matching Xingtu packs: 0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000.
499
- expected_cpe_range: Expected CPE range in min-max format. Example values matching Xingtu packs: 0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000.
500
- interaction_rate_range: Interaction rate range in decimal min-max format. Example values: 0.01-1 for 1% or above, 0.02-1 for 2% or above.
501
- completion_rate_range: Completion rate range in decimal min-max format. Example values: 0.1-1 for 10% or above, 0.2-1 for 20% or above.
502
- viral_rate_range: Viral content rate range in decimal min-max format. Page presets include 0-0.1, 0.1-0.25, 0.25-0.5, 0.5-0.99, and 0.99 or above. For open-ended presets, pass a high upper bound such as 0.99-1. Example: 0.1-0.25.
503
- progress_task_range: In-progress task count range. Format is days:min-max. Use open-ended ranges as days:min- or days:-max. Example: 30:8-
504
- """
505
- return self._get(
506
- "/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1",
507
- {
508
- "keyword": keyword,
509
- "page": page,
510
- "sort": sort,
511
- "searchType": search_type,
512
- "marketingTarget": marketing_target,
513
- "industry": industry,
514
- "isSuperstar": is_superstar,
515
- "followerRange": follower_range,
516
- "kolPriceType": kol_price_type,
517
- "kolPriceRange": kol_price_range,
518
- "contentTag": content_tag,
519
- "contentTheme": content_theme,
520
- "personaTag": persona_tag,
521
- "gender": gender,
522
- "location": location,
523
- "tonalityTag": tonality_tag,
524
- "connectedUserRange": connected_user_range,
525
- "audienceImage": audience_image,
526
- "fansImage": fans_image,
527
- "expectedPlayRange": expected_play_range,
528
- "expectedCpmRange": expected_cpm_range,
529
- "expectedCpeRange": expected_cpe_range,
530
- "interactionRateRange": interaction_rate_range,
531
- "completionRateRange": completion_rate_range,
532
- "viralRateRange": viral_rate_range,
533
- "progressTaskRange": progress_task_range,
534
- },
535
- )
536
-
537
537
  def search_kol_simple_v1(
538
538
  self,
539
539
  *,
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: justoneapi
3
- Version: 3.0.28
3
+ Version: 3.0.30
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
@@ -186,6 +186,7 @@ except BusinessError as exc:
186
186
 
187
187
  ### 小红书蒲公英
188
188
 
189
+ - [创作者搜索 (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)
189
190
  - [创作者资料 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-profile-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
190
191
  - [数据摘要 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/data-summary-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
191
192
  - [粉丝增长历史 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/follower-growth-history-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -197,7 +198,6 @@ except BusinessError as exc:
197
198
  - [粉丝分布 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/follower-distribution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
198
199
  - [成本效益分析 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/cost-effectiveness-analysis-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
199
200
  - [笔记详情 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/note-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
200
- - [创作者搜索 (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)
201
201
  - [创作者核心指标 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-core-metrics-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
202
202
  - [内容广场笔记 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/content-square-notes-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
203
203
  - [创作者资料 (V1)(已弃用)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-profile-v1-deprecated?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list#deprecated)
@@ -235,6 +235,7 @@ except BusinessError as exc:
235
235
 
236
236
  ### 抖音巨量星图
237
237
 
238
+ - [创作者搜索 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
238
239
  - [创作者资料 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-profile-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
239
240
  - [创作者链接结构 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-link-structure-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
240
241
  - [创作者可见性状态 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-visibility-status-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -252,7 +253,6 @@ except BusinessError as exc:
252
253
  - [受众触点分布 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/audience-touchpoint-distribution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
253
254
  - [推荐视频 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/recommended-videos-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
254
255
  - [粉丝分布 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/follower-distribution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
255
- - [创作者搜索 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
256
256
  - [创作者搜索轻量版 (V1)(已弃用)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-search-light-v1-deprecated?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list#deprecated)
257
257
  - [商品报告趋势 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/item-report-trends-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
258
258
  - [视频详情 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/video-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -1 +0,0 @@
1
- __version__ = "3.0.28"
File without changes
@@ -170,6 +170,7 @@ except BusinessError as exc:
170
170
 
171
171
  ### 小红书蒲公英
172
172
 
173
+ - [创作者搜索 (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)
173
174
  - [创作者资料 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-profile-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
174
175
  - [数据摘要 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/data-summary-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
175
176
  - [粉丝增长历史 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/follower-growth-history-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -181,7 +182,6 @@ except BusinessError as exc:
181
182
  - [粉丝分布 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/follower-distribution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
182
183
  - [成本效益分析 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/cost-effectiveness-analysis-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
183
184
  - [笔记详情 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/note-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
184
- - [创作者搜索 (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)
185
185
  - [创作者核心指标 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-core-metrics-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
186
186
  - [内容广场笔记 (V1)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/content-square-notes-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
187
187
  - [创作者资料 (V1)(已弃用)](https://docs.justoneapi.com/zh/api/xiaohongshu-creator-marketplace-pugongying/creator-profile-v1-deprecated?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list#deprecated)
@@ -219,6 +219,7 @@ except BusinessError as exc:
219
219
 
220
220
  ### 抖音巨量星图
221
221
 
222
+ - [创作者搜索 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
222
223
  - [创作者资料 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-profile-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
223
224
  - [创作者链接结构 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-link-structure-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
224
225
  - [创作者可见性状态 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-visibility-status-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -236,7 +237,6 @@ except BusinessError as exc:
236
237
  - [受众触点分布 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/audience-touchpoint-distribution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
237
238
  - [推荐视频 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/recommended-videos-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
238
239
  - [粉丝分布 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/follower-distribution-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
239
- - [创作者搜索 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
240
240
  - [创作者搜索轻量版 (V1)(已弃用)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/creator-search-light-v1-deprecated?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list#deprecated)
241
241
  - [商品报告趋势 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/item-report-trends-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
242
242
  - [视频详情 (V1)](https://docs.justoneapi.com/zh/api/douyin-creator-marketplace-xingtu/video-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
@@ -9,6 +9,179 @@ from justoneapi._response import ApiResponse
9
9
  class XiaohongshuPgyResource(BaseResource):
10
10
  """Generated resource for Xiaohongshu Creator Marketplace (Pugongying)."""
11
11
 
12
+ def api_solar_cooperator_blogger_v2_v1(
13
+ self,
14
+ *,
15
+ search_type: str | None = "NICKNAME",
16
+ keyword: str | None = None,
17
+ page: int | None = 1,
18
+ sort: str | None = "FANS",
19
+ fans_number_lower: int | None = None,
20
+ fans_number_upper: int | None = None,
21
+ fans_age: str | None = "ALL",
22
+ fans_gender: str | None = "ALL",
23
+ fans_child_age_info: str | None = None,
24
+ gender: str | None = "ALL",
25
+ location: str | None = None,
26
+ content_tag: str | None = None,
27
+ content_scene_label: str | None = None,
28
+ personal_tags: str | None = None,
29
+ market_target: str | None = None,
30
+ audience_group: str | None = None,
31
+ top20_crowds_label: str | None = None,
32
+ industry_specific_crowds_motor_dom: str | None = None,
33
+ feature_tags: str | None = None,
34
+ content_theme_label: str | None = None,
35
+ exclude_low_active: bool | None = None,
36
+ fans_num_up: bool | None = None,
37
+ note_type: str | None = "ALL",
38
+ industry: str | None = None,
39
+ accum_common_imp_medin_num30d: str | None = None,
40
+ read_mid_nor30: str | None = None,
41
+ inter_mid_nor30: str | None = None,
42
+ thousand_like_percent30: str | None = None,
43
+ note_price: str | None = None,
44
+ video_price: str | None = None,
45
+ invite_reply48h_num_ratio: str | None = None,
46
+ progress_order_cnt: str | None = None,
47
+ trade_type: str | None = None,
48
+ trade_report_brand_ids: str | None = None,
49
+ exclude_trade_report_brand_ids: bool | None = None,
50
+ accum_coop_imp_medin_num30d: str | None = None,
51
+ read_mid_coop30: str | None = None,
52
+ inter_mid_coop30: str | None = None,
53
+ m_cpuv_num30d: str | None = None,
54
+ estimate_picture_cpm: str | None = None,
55
+ estimate_video_cpm: str | None = None,
56
+ estimate_pic_read_price: str | None = None,
57
+ estimate_video_read_price: str | None = None,
58
+ estimate_picture_engage_cost: str | None = None,
59
+ estimate_video_engage_cost: str | None = None,
60
+ estimate_cpuv30d: str | None = None,
61
+ klive_cnt30d: str | None = None,
62
+ avg_live_viewer_num: str | None = None,
63
+ avg_agmv90d: str | None = None,
64
+ similar_user_id: str | None = None,
65
+ similar_word: str | None = None,
66
+ fans_location: str | None = None,
67
+ ) -> ApiResponse[Any]:
68
+ """
69
+ Creator Search
70
+
71
+ Get Xiaohongshu Creator Marketplace (Pugongying) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building.
72
+
73
+ Args:
74
+ search_type: Search criteria type. Available Values: - `NICKNAME`: Search by nickname - `NOTE`: Search by note content
75
+ keyword: Search keyword.
76
+ page: Page number.
77
+ sort: Creator search sorting. Values: FANS sorts by follower count descending, DEFAULT uses Pugongying intelligent ranking. Available Values: - `DEFAULT`: Platform default intelligent ranking - `FANS`: Sort by follower count descending
78
+ fans_number_lower: Minimum number of fans.
79
+ fans_number_upper: Maximum number of fans.
80
+ fans_age: Target fans age group. Available Values: - `ALL`: All ages - `LT_18`: Under 18 - `AGE_18_24`: 18 to 24 - `AGE_25_34`: 25 to 34 - `AGE_35_44`: 35 to 44 - `GT_44`: Above 44
81
+ fans_gender: Target fans gender. Available Values: - `ALL`: All genders - `MALE_HIGH`: Mainly Male - `FE_MALE_HIGH`: Mainly Female
82
+ fans_child_age_info: Mother-and-baby audience stage filter. Pass Pugongying labels or numeric codes separated by English or Chinese commas. Available values: - 1: 备孕 - 2: 0-6月 - 3: 7-12月 - 4: 1-3岁 - 5: 4-6岁 - 6: 7-12岁 - 7: 孕早期 - 8: 孕晚期
83
+ gender: KOL's gender. Available Values: - `ALL`: All genders - `MALE`: Male - `FEMALE`: Female
84
+ location: Creator profile location filter. Pass Pugongying location labels separated by English or Chinese commas. Country, China province or region, city-level paths, and district/county-level paths are supported. China province or region short labels are normalized to the full Pugongying value. Only paths present in the Pugongying location tree are accepted. Paths such as `河北 秦皇岛`, `山西 长治 潞州区`, or `中国 山西 长治 潞州区` are normalized to values like `中国 山西 长治 潞州区`. Available country/province base values: - 中国 - 美国 - 日本 - 澳大利亚 - 英国 - 加拿大 - 韩国 - 法国 - 德国 - 新加坡 - 其他 - 中国 北京 - 中国 天津 - 中国 河北 - 中国 山西 - 中国 内蒙古 - 中国 辽宁 - 中国 吉林 - 中国 黑龙江 - 中国 上海 - 中国 江苏 - 中国 浙江 - 中国 安徽 - 中国 福建 - 中国 江西 - 中国 山东 - 中国 河南 - 中国 湖北 - 中国 湖南 - 中国 广东 - 中国 广西 - 中国 海南 - 中国 重庆 - 中国 四川 - 中国 贵州 - 中国 云南 - 中国 西藏 - 中国 陕西 - 中国 甘肃 - 中国 青海 - 中国 宁夏 - 中国 新疆 - 中国 澳门 - 中国 台湾 - 中国 香港 Example: - 广东,中国 上海,河北 秦皇岛,山西 长治 潞州区
85
+ content_tag: Content category filter. Pass first-level or second-level category labels from Pugongying, separated by commas. Available values: - 美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他 - 护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他 - 个人护理: 头发产品, 身体护理, 口腔护理, 护理其他 - 母婴: 母婴日常, 早教, 婴童用品, 婴童洗护, 婴童食品, 婴童时尚, 孕期穿搭, 孕产经验, 产后恢复, 育儿经验, 宝宝才艺, 宝宝写真, 母婴其他 - 时尚: 穿搭, 配饰, 发型, 箱包, 鞋靴, 时尚其他 - 美食: 美食教程, 美食探店, 美食展示, 美食测评, 吃播, 美食其他 - 家居家装: 装修, 家居用品, 家居装饰, 家具, 家电, 室内设计, 居家经验, 家居家装其他 - 影视综资讯: 动漫, 电影, 电视, 娱乐资讯, 影视, 民生资讯, 综艺, 影视综其他 - 运动健身: 健身减肥, 健身塑形, 滑雪, 滑板, 水上活动, 运动其他, 足球, 篮球, 跑步, 游泳 - 宠物: 猫, 狗, 动物其他 - 文化艺术: 社科, 文化, 艺术, 文化艺术其他 - 兴趣爱好: 绘画, 手工, 阅读, 文具手账, 舞蹈, 益智玩具, 潮流玩具, 兴趣爱好其他 - 生活记录: 接地气生活, 日常片段, 中外生活, 品质生活, 校园生活 - 教育: 大学教育, k12教育, 家庭教育, 学习日常, 职场教育, 教育其他 - 情感: 情感知识, 情感日常, 情感其他 - 摄影: 人文风光摄影, 摄影技巧, 胶片摄影, 人像摄影, 摄影其他 - 游戏: 手机游戏, 主机游戏, 游戏其他, 线下游戏 - 科技数码: 数码, 玩机攻略, 数码科技其他 - 出行: 城市出行, 户外, 旅行 - 音乐 - 搞笑 - 健康养生 - 汽车 - 婚嫁: 婚礼造型, 婚礼记录, 婚礼经验, 婚礼用品 - 商业财经 - 素材 - 其他
86
+ content_scene_label: Content scene label filter. Pass full Pugongying note category scene label paths separated by English or Chinese commas. Available values: - 汽车 理性决策 选车攻略 政策 - 汽车 理性决策 选车攻略 购车顾虑 - 汽车 理性决策 选车攻略 配置 - 汽车 理性决策 选车攻略 能源类型优势对比 - 汽车 理性决策 选车攻略 攻略 - 汽车 理性决策 新车测评 - 汽车 理性决策 探店试驾 - 汽车 理性决策 车主心得 - 汽车 用车场景 远行近游 近郊探索 - 汽车 用车场景 远行近游 长途自驾 - 汽车 用车场景 远行近游 硬核越野 - 汽车 用车场景 提车/交付场景 场地布置与礼遇 - 汽车 用车场景 提车/交付场景 仪式感记录 - 汽车 用车场景 商务用车 移动头等舱 - 汽车 用车场景 商务用车 商务接待 - 汽车 用车场景 亲子家庭 家庭采购日 - 汽车 用车场景 亲子家庭 接送孩子 - 汽车 用车场景 亲子家庭 三代同堂 - 汽车 用车场景 亲子家庭 周末溜娃 - 汽车 用车场景 亲子家庭 车内学习室 - 汽车 用车场景 亲子家庭 车内育婴室 - 汽车 用车场景 朋友社交 后备箱经济 - 汽车 用车场景 朋友社交 移动娱乐屋 - 汽车 用车场景 礼赠场景 毕业礼物 - 汽车 用车场景 礼赠场景 送给父母 - 汽车 用车场景 礼赠场景 适合送男友 - 汽车 用车场景 礼赠场景 适合送女友 - 汽车 用车场景 户外兴趣 钓鱼/野营 - 汽车 用车场景 户外兴趣 骑行 - 汽车 用车场景 户外兴趣 徒步 - 汽车 用车场景 户外兴趣 硬核竞速 - 汽车 用车场景 宠物出行 大型宠物 - 汽车 用车场景 宠物出行 短途出行 - 汽车 用车场景 宠物出行 小型宠物 - 汽车 用车场景 宠物出行 长途出行 - 汽车 用车场景 城市通勤 车内小憩 - 汽车 用车场景 城市通勤 健身储物 - 汽车 用车场景 城市通勤 日常通勤 - 汽车 用车场景 城市通勤 生活圈代步 - 汽车 用车场景 城市通勤 移动美容舱 - 汽车 个性化美化 个性改装 - 汽车 个性化美化 储物收纳 - 汽车 个性化美化 车内装饰 - 汽车 个性化美化 车外装饰 - 汽车 个性化美化 车衣保护 - 汽车 个性化美化 汽车用品 - 汽车 车型品类 轿车 - 汽车 车型品类 SUV - 汽车 车型品类 MPV - 汽车 车型品类 跑车 - 汽车 车型品类 微型车 - 汽车 车型品类 微面 - 汽车 车型品类 房车 - 汽车 车型品类 越野车 - 汽车 车型品类 旅行车 - 汽车 圈层属性 改装圈层 - 汽车 圈层属性 痛车圈层 - 汽车 圈层属性 跑山圈层 - 汽车 品牌倾向 自主 - 汽车 品牌倾向 豪华 - 汽车 品牌倾向 集团 - 汽车 品牌倾向 新势力 - 汽车 能源类型 纯电车 - 汽车 能源类型 新能源 - 汽车 能源类型 油车 - 汽车 人生阶段 单身 - 汽车 人生阶段 多娃&大家庭阶段 - 汽车 人生阶段 银发退休阶段 - 游戏 游戏品类 网页游戏 - 游戏 游戏品类 电脑游戏 - 游戏 游戏品类 手机游戏 - 游戏 游戏类型 动作格斗游戏 永劫无间 - 游戏 游戏类型 即时制二次元游戏 境界刀鸣 - 游戏 游戏类型 即时制二次元游戏 黑色信标 - 游戏 游戏类型 即时制二次元游戏 物华弥新 - 游戏 游戏类型 即时制二次元游戏 无期迷途 - 游戏 游戏类型 即时制二次元游戏 新月同行 - 游戏 游戏类型 即时制二次元游戏 绝区零 - 游戏 游戏类型 即时制角色扮演 诛仙2 - 游戏 游戏类型 即时制角色扮演 诛仙 - 游戏 游戏类型 即时制角色扮演 明日之后 - 游戏 游戏类型 即时制角色扮演 超自然行动组 - 游戏 游戏类型 即时制角色扮演 永恒之塔2 - 游戏 游戏类型 回合制二次元游戏 未定事件簿 - 游戏 游戏类型 回合制二次元游戏 雷索纳斯 - 游戏 游戏类型 回合制二次元游戏 浮生忆玲珑 - 游戏 游戏类型 回合制二次元游戏 重返未来1999 - 游戏 游戏类型 回合制角色扮演 梦幻西游手游 - 游戏 游戏类型 回合制角色扮演 龙魂旅人 - 游戏 游戏类型 回合制角色扮演 最终幻想14 - 游戏 游戏类型 塔防游戏 保卫向日葵 - 游戏 游戏类型 塔防游戏 全境守卫 - 游戏 游戏类型 塔防游戏 向僵尸开炮 - 游戏 游戏类型 开放世界角色扮演 燕云十六声 - 游戏 游戏类型 开放世界角色扮演 王者荣耀世界 - 游戏 游戏类型 恋爱游戏 如鸢 - 游戏 游戏类型 恋爱游戏 银与绯 - 游戏 游戏类型 恋爱游戏 时空中的绘旅人 - 游戏 游戏类型 恋爱游戏 光与夜之恋 - 游戏 游戏类型 恋爱游戏 恋与深空 - 游戏 游戏类型 恋爱游戏 恋与制作人 - 游戏 游戏类型 战略游戏 率土之滨 - 游戏 游戏类型 战略游戏 群星纪元 - 游戏 游戏类型 战略游戏 阿瓦隆之王 - 游戏 游戏类型 战略游戏 快来当领主 - 游戏 游戏类型 战略游戏 冒险之星 - 游戏 游戏类型 战略游戏 无尽的拉格朗日 - 游戏 游戏类型 放置类二次元游戏 花花与幕间剧 - 游戏 游戏类型 放置类角色扮演 发条总动员 - 游戏 游戏类型 放置类角色扮演 遮天凡尘一叶 - 游戏 游戏类型 模拟养成 美人传 - 游戏 游戏类型 模拟养成 盲盒派对 - 游戏 游戏类型 模拟养成 闪耀暖暖 - 游戏 游戏类型 模拟养成 以闪亮之名 - 游戏 游戏类型 模拟养成 无限暖暖 - 游戏 游戏类型 模拟家园建造 江南百景图 - 游戏 游戏类型 模拟家园建造 动物森友会 - 游戏 游戏类型 模拟家园建造 星露谷物语 - 游戏 游戏类型 模拟经营 暴吵萌厨 - 游戏 游戏类型 模拟经营 肥鹅健身房 - 游戏 游戏类型 模拟职业 杜拉拉升职记 - 游戏 游戏类型 消除游戏 四季合合 - 游戏 游戏类型 生存沙盒游戏 无尽冬日 - 游戏 游戏类型 聚会游戏 蛋仔派对 - 游戏 游戏类型 聚会游戏 代号砰砰 - 游戏 游戏类型 解谜游戏 晴空之下 - 游戏 游戏类型 抓宠类游戏 洛克王国手游 - 游戏 游戏类型 射击游戏 三角洲行动 - 游戏 游戏类型 射击游戏 codm(使命召唤) - 母婴 婴童洗护 安全防晒 - 母婴 婴童洗护 浴后护理 - 母婴 婴童洗护 敏感修护 - 母婴 婴童洗护 屏障树立 - 母婴 婴童洗护 泳后护理 - 母婴 婴童洗护 口周干裂 - 母婴 婴童洗护 分区清洁 - 母婴 婴童洗护 头皮问题 - 母婴 婴童洗护 驱虫驱蚊 - 母婴 婴童洗护 洁面清洁 - 母婴 婴童洗护 红屁股 - 母婴 婴童洗护 湿疹皮炎 - 母婴 婴童洗护 痱子热疹 - 母婴 婴童洗护 抚触链接 - 母婴 婴童洗护 趣味洗护 - 母婴 母婴纸品 精算育儿 - 母婴 母婴纸品 颜值派 - 母婴 母婴纸品 汗宝宝 - 母婴 母婴纸品 囤货党 - 母婴 母婴纸品 敏感肌 - 母婴 母婴纸品 肉腿娃 - 母婴 母婴纸品 功课党 - 母婴 母婴纸品 好动宝 - 母婴 母婴纸品 安睡整夜 - 母婴 母婴纸品 出行便携 - 母婴 母婴纸品 贵妇体验 - 母婴 母婴纸品 红屁屁 - 母婴 母婴小家电 空间收纳 - 母婴 母婴小家电 滋补养生 - 母婴 母婴小家电 温度把控 - 母婴 母婴小家电 夜奶操作 - 母婴 母婴小家电 新手喂养 - 母婴 母婴小家电 材质挑选 - 母婴 母婴小家电 三代同育 - 母婴 母婴小家电 户外喂养 - 母婴 母婴小家电 通乳攻略 - 母婴 母婴小家电 洁癖爸妈 - 母婴 母婴小家电 精准喂养 - 母婴 母婴小家电 职场妈妈 - 母婴 婴童辅食 吞咽能力 - 母婴 婴童辅食 多元辅食 - 母婴 婴童辅食 零食分享 - 母婴 婴童辅食 健康零食 - 母婴 婴童辅食 放学加餐 - 母婴 婴童辅食 出牙磨牙 - 母婴 婴童辅食 居家囤货 - 母婴 婴童辅食 节日礼包 - 母婴 婴童辅食 零食训练 - 母婴 婴童辅食 宝宝挑食 - 母婴 婴童辅食 户外零食 - 母婴 婴童辅食 低敏辅食 - 母婴 婴童辅食 入园社交 - 母婴 婴童辅食 居家辅食 - 母婴 婴童辅食 入园准备 - 母婴 婴童辅食 敏敏零食 - 母婴 婴童辅食 抓握训练 - 母婴 婴童辅食 外出口粮 - 母婴 婴童辅食 营养均衡 - 母婴 婴童辅食 自主进食 - 母婴 婴童辅食 第一口辅食 - 母婴 母婴营养品 开胃因子 - 母婴 母婴营养品 视力保护 - 母婴 母婴营养品 营养补充 - 母婴 母婴营养品 防护因子 - 母婴 母婴营养品 高钙因子 - 母婴 母婴营养品 自护构建 - 母婴 母婴营养品 发育表现 - 母婴 母婴营养品 助眠安睡 - 母婴 婴童奶粉 丝滑转奶 - 母婴 婴童奶粉 益生组合 - 母婴 婴童奶粉 眼脑体发育 - 母婴 婴童奶粉 选奶功课 - 母婴 婴童奶粉 防敏脱敏 - 母婴 婴童奶粉 助力聪明脑 - 母婴 婴童奶粉 乳铁自护 - 母婴 婴童奶粉 黄金长高 - 母婴 婴童奶粉 内修外护 - 母婴 婴童奶粉 肚肚吸收 - 母婴 婴童奶粉 断奶攻略 - 母婴 婴童奶粉 混合喂养 - 母婴 婴童奶粉 母源黄金HMO - 母婴 婴童奶粉 长肉多肉 - 母婴 哺乳喂养工具 萌娃穿搭 - 母婴 哺乳喂养工具 安全材质 - 母婴 哺乳喂养工具 奶瓶喂养 - 母婴 哺乳喂养工具 颜值发育 - 母婴 哺乳喂养工具 哄娃安抚 - 母婴 哺乳喂养工具 餐具选购 - 母婴 哺乳喂养工具 学饮指南 - 母婴 哺乳喂养工具 换季保温 - 母婴 母婴孕产 职场孕妇 - 母婴 母婴孕产 产后复工 - 母婴 母婴孕产 顺产 - 母婴 母婴孕产 孕期变化 - 母婴 母婴孕产 孕期学习 - 母婴 母婴孕产 剖腹产 - 母婴 母婴家居 护脊深睡 - 母婴 母婴家居 安全翻滚 - 母婴 母婴家居 进食习惯 - 母婴 母婴家居 早教启蒙 - 母婴 母婴家居 学习角落 - 母婴 母婴家居 自主入睡 - 母婴 母婴家居 爬行探索 - 母婴 母婴家居 防惊跳 - 母婴 母婴出行&用品 长线旅途 - 母婴 母婴出行&用品 户外探索 - 母婴 母婴出行&用品 二胎/双胎 - 母婴 母婴出行&用品 新贵消费 - 母婴 母婴出行&用品 备产研究 - 母婴 母婴出行&用品 短途旅行 - 母婴 母婴出行&用品 高频出行 - 母婴 母婴出行&用品 新生出行 - 母婴 母婴出行&用品 务实精算 - 母婴 母婴出行&用品 遛娃必备
87
+ personal_tags: Blogger persona tag filter. Pass one or more Pugongying persona labels separated by English or Chinese commas. Available values: - 妈妈 - 萌娃 - 爸爸 - 奶奶 - 情侣 - 夫妻 - 家庭 - 闺蜜 - 兄弟 - 备孕中 - 孕期中 - 12岁以上 - 传统行业 - 互联网 - 教育科研 - 金融法律 - 企业创业 - 时尚美妆 - 食品饮料 - 文化传媒 - 医疗健康 - 艺术设计 - 影视娱乐 - 运动健身 - 专业服务 - 工程师 - 销售 - HR - 教练 - 运动员 - 舞蹈老师 - 生活背景 - 备考经验 - 兴趣爱好 - 留学背景 - 海外华人 - 铲屎官 - 孕妈 - 独居人群 - 外国人 - 混血儿 Example: - 妈妈,教练,运动员,舞蹈老师,留学背景
88
+ market_target: Marketing target filter. Pass one Pugongying marketing target value. Available values: - estimateAllCpm: Exposure - exposure performance - cost - mAccumImpNum: Exposure - exposure performance - scale - readCost: Exposure - read performance - cost - mValidRawReadFeedNum: Exposure - read performance - scale - estimateEngageCost: Seeding - engagement performance - cost - mEngagementNum90d: Seeding - engagement performance - scale - estimateCpuv: Conversion - outer-store visit performance - cost - mCpuvNum: Conversion - outer-store visit performance - scale Example: - estimateAllCpm
89
+ audience_group: Audience target filter. Pass Pugongying audience group IDs (`dmpGroupId`) separated by English or Chinese commas. These IDs are dynamic and account-specific, so there is no fixed global value list. Use the audience group name shown in Pugongying Audience Management to identify what each ID means. Example: - 123456,789012
90
+ top20_crowds_label: Top-20 audience filter. Pass top-level or child audience labels separated by commas; child labels are converted to Pugongying request values.
91
+ industry_specific_crowds_motor_dom: Industry-specific portrait filter. Pass Pugongying portrait value IDs or label values separated by commas.
92
+ feature_tags: Good-at content tag filter. Pass label values separated by commas.
93
+ content_theme_label: Content theme filter. Pass Pugongying value IDs or label values separated by commas; labels are converted to value IDs.
94
+ exclude_low_active: Whether to exclude low-activity bloggers.
95
+ fans_num_up: Whether to exclude bloggers whose fan count is dropping.
96
+ note_type: Note type filter. Values: ALL=all note types, PHOTO_TEXT=mainly photo-text notes, VIDEO=mainly video notes. Available Values: - `ALL`: All note types - `PHOTO_TEXT`: Mainly photo-text notes - `VIDEO`: Mainly video notes
97
+ industry: Pugongying industry preset for industry assistant style creator recommendations. Available Values: - `BEAUTY_PERSONAL_CARE_BEAUTY`: Beauty and personal care - beauty - `BEAUTY_PERSONAL_CARE_SKINCARE`: Beauty and personal care - skincare - `BEAUTY_PERSONAL_CARE_PERSONAL_CARE`: Beauty and personal care - personal care - `BEAUTY_PERSONAL_CARE_FRAGRANCE`: Beauty and personal care - fragrance - `FOOD_BEVERAGE_SNACKS`: Food and beverage - snacks - `FOOD_BEVERAGE_DRINKS`: Food and beverage - drinks - `FOOD_BEVERAGE_HEALTH_FOOD`: Food and beverage - health food - `FOOD_BEVERAGE_DAIRY`: Food and beverage - dairy - `FOOD_BEVERAGE_ALCOHOL`: Food and beverage - alcohol - `FOOD_BEVERAGE_GRAINS_OIL`: Food and beverage - grains and oil - `FOOD_BEVERAGE_CROSS_BORDER_FOOD`: Food and beverage - cross-border food - `FOOD_BEVERAGE_FRESH_FOOD`: Food and beverage - fresh food - `FOOD_BEVERAGE_MEAL_REPLACEMENT`: Food and beverage - meal replacement - `FOOD_BEVERAGE_TRADITIONAL_NOURISHMENT`: Food and beverage - traditional nourishment - `MOTHER_BABY_SUPPLIES`: Mother and baby - baby supplies - `MOTHER_BABY_FORMULA_FOOD`: Mother and baby - formula and baby food - `DIGITAL_APPLIANCES_HOME_APPLIANCES`: Digital and appliances - home appliances - `DIGITAL_APPLIANCES_DIGITAL_PRODUCTS`: Digital and appliances - digital products - `DAILY_GOODS_HOUSEHOLD_DAILY_USE`: Daily goods - household daily use - `DAILY_GOODS_PET_SUPPLIES_FOOD`: Daily goods - pet supplies and food - `DAILY_GOODS_OFFICE_SUPPLIES`: Daily goods - office supplies - `APPAREL_ACCESSORIES_CLOTHING_SHOES_HATS`: Apparel and accessories - clothing, shoes, and hats - `APPAREL_ACCESSORIES_JEWELRY`: Apparel and accessories - jewelry - `APPAREL_ACCESSORIES_BAGS_GLASSES`: Apparel and accessories - bags and glasses - `APPAREL_ACCESSORIES_SPORTS_OUTDOOR`: Apparel and accessories - sports and outdoor - `APPAREL_ACCESSORIES_WATCHES`: Apparel and accessories - watches - `APPAREL_ACCESSORIES_SECOND_HAND_LUXURY`: Apparel and accessories - second-hand luxury - `HOME_BUILDING_MATERIALS_HOME_DECOR`: Home and building materials - home decor - `HOME_BUILDING_MATERIALS_FURNITURE`: Home and building materials - furniture - `HOME_BUILDING_MATERIALS_MAIN_MATERIALS`: Home and building materials - main building materials - `AUTOMOTIVE`: Automotive - `INTERNET_ECOMMERCE`: Internet - e-commerce - `INTERNET_SOFTWARE_TOOLS`: Internet - software tools - `HEALTHCARE_MEDICAL_DEVICES`: Healthcare - medical devices - `HEALTHCARE_MEDICAL_BEAUTY`: Healthcare - medical beauty - `CULTURE_SPORTS_ENTERTAINMENT_SPORTS_GOODS`: Culture, sports, and entertainment - sports goods - `CULTURE_SPORTS_ENTERTAINMENT_STATIONERY_TOYS_GIFTS`: Culture, sports, and entertainment - stationery, toys, and gifts - `CULTURE_SPORTS_ENTERTAINMENT_OUTDOOR_PRODUCTS`: Culture, sports, and entertainment - outdoor products - `CULTURE_SPORTS_ENTERTAINMENT_ART_COLLECTIBLES`: Culture, sports, and entertainment - art collectibles - `LIFE_SERVICES_OFFLINE_RETAIL`: Life services - offline retail - `LIFE_SERVICES_BEAUTY_HAIR`: Life services - beauty and hair - `CATERING_RESTAURANTS`: Catering - restaurants - `CATERING_DRINKS_DESSERTS`: Catering - drinks and desserts - `BUSINESS_SERVICES`: Business services - `EDUCATION_TRAINING_LANGUAGE_STUDY_ABROAD`: Education and training - language and study abroad - `EDUCATION_TRAINING_VOCATIONAL_EDUCATION`: Education and training - vocational education - `EDUCATION_TRAINING_INTEREST_TRAINING`: Education and training - interest training - `EDUCATION_TRAINING_K12_EDUCATION`: Education and training - K-12 education - `EDUCATION_TRAINING_DEGREE_EDUCATION`: Education and training - degree education - `EDUCATION_TRAINING_CORPORATE_DEVELOPMENT`: Education and training - corporate and team development - `EDUCATION_TRAINING_OTHER`: Education and training - other - `GAMES`: Games - `TRAVEL_TOURISM`: Travel and tourism
98
+ accum_common_imp_medin_num30d: Daily note exposure median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
99
+ read_mid_nor30: Daily note read median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
100
+ inter_mid_nor30: Daily note interaction median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
101
+ thousand_like_percent30: Thousand-like note ratio range. Pass fractional ratios such as 0.4,null or percentage values such as 40,null.
102
+ note_price: Photo-text cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
103
+ video_price: Video cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
104
+ invite_reply48h_num_ratio: 48-hour invite reply ratio range. Pass fractional ratios such as 0.9,0.95 or percentage values such as 90,95.
105
+ progress_order_cnt: Current cooperation order count range. Pass two comma-separated numeric bounds.
106
+ trade_type: Recent cooperation industry filter from Pugongying.
107
+ trade_report_brand_ids: Recent cooperation brand IDs, separated by English or Chinese commas.
108
+ exclude_trade_report_brand_ids: Whether to exclude creators who cooperated with the selected recent cooperation brands.
109
+ accum_coop_imp_medin_num30d: Cooperation note exposure median range. Pass two comma-separated numeric bounds.
110
+ read_mid_coop30: Cooperation note read median range. Pass two comma-separated numeric bounds.
111
+ inter_mid_coop30: Cooperation note interaction median range. Pass two comma-separated numeric bounds.
112
+ m_cpuv_num30d: Cooperation note outer-store median range. Pass two comma-separated numeric bounds.
113
+ estimate_picture_cpm: Estimated photo-text CPM range. Pass two comma-separated numeric bounds.
114
+ estimate_video_cpm: Estimated video CPM range. Pass two comma-separated numeric bounds.
115
+ estimate_pic_read_price: Estimated photo-text read unit price range. Pass two comma-separated numeric bounds.
116
+ estimate_video_read_price: Estimated video read unit price range. Pass two comma-separated numeric bounds.
117
+ estimate_picture_engage_cost: Estimated photo-text engagement unit price range. Pass two comma-separated numeric bounds.
118
+ estimate_video_engage_cost: Estimated video engagement unit price range. Pass two comma-separated numeric bounds.
119
+ estimate_cpuv30d: Estimated outer-store visit unit price range. Pass two comma-separated numeric bounds.
120
+ klive_cnt30d: Live count in the last 30 days range. Pass two comma-separated numeric bounds.
121
+ avg_live_viewer_num: Average live viewer count range. Pass two comma-separated numeric bounds.
122
+ avg_agmv90d: Average live sales amount range. Pass two comma-separated numeric bounds.
123
+ similar_user_id: Similar creator user ID. `similarUserId` and `similarWord` must be provided together.
124
+ similar_word: Similar creator keyword shown by Pugongying. `similarUserId` and `similarWord` must be provided together.
125
+ fans_location: Follower audience location filter. Pass Pugongying follower-region labels separated by English or Chinese commas. Country, China province, and city-level paths are supported; district/county-level paths are not accepted. Only paths present in the Pugongying follower-region tree are accepted. Use city paths such as `福建 南平`, `福建-南平`, or `中国 福建 南平`; they are normalized to values like `中国 福建 南平`. Examples: - 福建 南平 - 中国 福建 南平,广东
126
+ """
127
+ return self._get(
128
+ "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1",
129
+ {
130
+ "searchType": search_type,
131
+ "keyword": keyword,
132
+ "page": page,
133
+ "sort": sort,
134
+ "fansNumberLower": fans_number_lower,
135
+ "fansNumberUpper": fans_number_upper,
136
+ "fansAge": fans_age,
137
+ "fansGender": fans_gender,
138
+ "fansChildAgeInfo": fans_child_age_info,
139
+ "gender": gender,
140
+ "location": location,
141
+ "contentTag": content_tag,
142
+ "contentSceneLabel": content_scene_label,
143
+ "personalTags": personal_tags,
144
+ "marketTarget": market_target,
145
+ "audienceGroup": audience_group,
146
+ "top20CrowdsLabel": top20_crowds_label,
147
+ "industrySpecificCrowdsMotorDom": industry_specific_crowds_motor_dom,
148
+ "featureTags": feature_tags,
149
+ "contentThemeLabel": content_theme_label,
150
+ "excludeLowActive": exclude_low_active,
151
+ "fansNumUp": fans_num_up,
152
+ "noteType": note_type,
153
+ "industry": industry,
154
+ "accumCommonImpMedinNum30d": accum_common_imp_medin_num30d,
155
+ "readMidNor30": read_mid_nor30,
156
+ "interMidNor30": inter_mid_nor30,
157
+ "thousandLikePercent30": thousand_like_percent30,
158
+ "notePrice": note_price,
159
+ "videoPrice": video_price,
160
+ "inviteReply48hNumRatio": invite_reply48h_num_ratio,
161
+ "progressOrderCnt": progress_order_cnt,
162
+ "tradeType": trade_type,
163
+ "tradeReportBrandIds": trade_report_brand_ids,
164
+ "excludeTradeReportBrandIds": exclude_trade_report_brand_ids,
165
+ "accumCoopImpMedinNum30d": accum_coop_imp_medin_num30d,
166
+ "readMidCoop30": read_mid_coop30,
167
+ "interMidCoop30": inter_mid_coop30,
168
+ "mCpuvNum30d": m_cpuv_num30d,
169
+ "estimatePictureCpm": estimate_picture_cpm,
170
+ "estimateVideoCpm": estimate_video_cpm,
171
+ "estimatePicReadPrice": estimate_pic_read_price,
172
+ "estimateVideoReadPrice": estimate_video_read_price,
173
+ "estimatePictureEngageCost": estimate_picture_engage_cost,
174
+ "estimateVideoEngageCost": estimate_video_engage_cost,
175
+ "estimateCpuv30d": estimate_cpuv30d,
176
+ "kliveCnt30d": klive_cnt30d,
177
+ "avgLiveViewerNum": avg_live_viewer_num,
178
+ "avgAgmv90d": avg_agmv90d,
179
+ "similarUserId": similar_user_id,
180
+ "similarWord": similar_word,
181
+ "fansLocation": fans_location,
182
+ },
183
+ )
184
+
12
185
  def api_solar_cooperator_user_blogger_user_id_v1(
13
186
  self,
14
187
  *,
@@ -253,179 +426,6 @@ class XiaohongshuPgyResource(BaseResource):
253
426
  },
254
427
  )
255
428
 
256
- def api_solar_cooperator_blogger_v2_v1(
257
- self,
258
- *,
259
- search_type: str | None = "NICKNAME",
260
- keyword: str | None = None,
261
- page: int | None = 1,
262
- sort: str | None = "FANS",
263
- fans_number_lower: int | None = None,
264
- fans_number_upper: int | None = None,
265
- fans_age: str | None = "ALL",
266
- fans_gender: str | None = "ALL",
267
- fans_child_age_info: str | None = None,
268
- gender: str | None = "ALL",
269
- location: str | None = None,
270
- content_tag: str | None = None,
271
- content_scene_label: str | None = None,
272
- personal_tags: str | None = None,
273
- market_target: str | None = None,
274
- audience_group: str | None = None,
275
- top20_crowds_label: str | None = None,
276
- industry_specific_crowds_motor_dom: str | None = None,
277
- feature_tags: str | None = None,
278
- content_theme_label: str | None = None,
279
- exclude_low_active: bool | None = None,
280
- fans_num_up: bool | None = None,
281
- note_type: str | None = "ALL",
282
- industry: str | None = None,
283
- accum_common_imp_medin_num30d: str | None = None,
284
- read_mid_nor30: str | None = None,
285
- inter_mid_nor30: str | None = None,
286
- thousand_like_percent30: str | None = None,
287
- note_price: str | None = None,
288
- video_price: str | None = None,
289
- invite_reply48h_num_ratio: str | None = None,
290
- progress_order_cnt: str | None = None,
291
- trade_type: str | None = None,
292
- trade_report_brand_ids: str | None = None,
293
- exclude_trade_report_brand_ids: bool | None = None,
294
- accum_coop_imp_medin_num30d: str | None = None,
295
- read_mid_coop30: str | None = None,
296
- inter_mid_coop30: str | None = None,
297
- m_cpuv_num30d: str | None = None,
298
- estimate_picture_cpm: str | None = None,
299
- estimate_video_cpm: str | None = None,
300
- estimate_pic_read_price: str | None = None,
301
- estimate_video_read_price: str | None = None,
302
- estimate_picture_engage_cost: str | None = None,
303
- estimate_video_engage_cost: str | None = None,
304
- estimate_cpuv30d: str | None = None,
305
- klive_cnt30d: str | None = None,
306
- avg_live_viewer_num: str | None = None,
307
- avg_agmv90d: str | None = None,
308
- similar_user_id: str | None = None,
309
- similar_word: str | None = None,
310
- fans_location: str | None = None,
311
- ) -> ApiResponse[Any]:
312
- """
313
- Creator Search
314
-
315
- Get Xiaohongshu Creator Marketplace (Pugongying) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building.
316
-
317
- Args:
318
- search_type: Search criteria type. Available Values: - `NICKNAME`: Search by nickname - `NOTE`: Search by note content
319
- keyword: Search keyword.
320
- page: Page number.
321
- sort: Creator search sorting. Values: FANS sorts by follower count descending, DEFAULT uses Pugongying intelligent ranking. Available Values: - `DEFAULT`: Platform default intelligent ranking - `FANS`: Sort by follower count descending
322
- fans_number_lower: Minimum number of fans.
323
- fans_number_upper: Maximum number of fans.
324
- fans_age: Target fans age group. Available Values: - `ALL`: All ages - `LT_18`: Under 18 - `AGE_18_24`: 18 to 24 - `AGE_25_34`: 25 to 34 - `AGE_35_44`: 35 to 44 - `GT_44`: Above 44
325
- fans_gender: Target fans gender. Available Values: - `ALL`: All genders - `MALE_HIGH`: Mainly Male - `FE_MALE_HIGH`: Mainly Female
326
- fans_child_age_info: Mother-and-baby audience stage filter. Pass Pugongying labels or numeric codes separated by English or Chinese commas. Available values: - 1: 备孕 - 2: 0-6月 - 3: 7-12月 - 4: 1-3岁 - 5: 4-6岁 - 6: 7-12岁 - 7: 孕早期 - 8: 孕晚期
327
- gender: KOL's gender. Available Values: - `ALL`: All genders - `MALE`: Male - `FEMALE`: Female
328
- location: Creator profile location filter. Pass Pugongying location labels separated by English or Chinese commas. Country, China province or region, city-level paths, and district/county-level paths are supported. China province or region short labels are normalized to the full Pugongying value. Only paths present in the Pugongying location tree are accepted. Paths such as `河北 秦皇岛`, `山西 长治 潞州区`, or `中国 山西 长治 潞州区` are normalized to values like `中国 山西 长治 潞州区`. Available country/province base values: - 中国 - 美国 - 日本 - 澳大利亚 - 英国 - 加拿大 - 韩国 - 法国 - 德国 - 新加坡 - 其他 - 中国 北京 - 中国 天津 - 中国 河北 - 中国 山西 - 中国 内蒙古 - 中国 辽宁 - 中国 吉林 - 中国 黑龙江 - 中国 上海 - 中国 江苏 - 中国 浙江 - 中国 安徽 - 中国 福建 - 中国 江西 - 中国 山东 - 中国 河南 - 中国 湖北 - 中国 湖南 - 中国 广东 - 中国 广西 - 中国 海南 - 中国 重庆 - 中国 四川 - 中国 贵州 - 中国 云南 - 中国 西藏 - 中国 陕西 - 中国 甘肃 - 中国 青海 - 中国 宁夏 - 中国 新疆 - 中国 澳门 - 中国 台湾 - 中国 香港 Example: - 广东,中国 上海,河北 秦皇岛,山西 长治 潞州区
329
- content_tag: Content category filter. Pass first-level or second-level category labels from Pugongying, separated by commas. Available values: - 美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他 - 护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他 - 个人护理: 头发产品, 身体护理, 口腔护理, 护理其他 - 母婴: 母婴日常, 早教, 婴童用品, 婴童洗护, 婴童食品, 婴童时尚, 孕期穿搭, 孕产经验, 产后恢复, 育儿经验, 宝宝才艺, 宝宝写真, 母婴其他 - 时尚: 穿搭, 配饰, 发型, 箱包, 鞋靴, 时尚其他 - 美食: 美食教程, 美食探店, 美食展示, 美食测评, 吃播, 美食其他 - 家居家装: 装修, 家居用品, 家居装饰, 家具, 家电, 室内设计, 居家经验, 家居家装其他 - 影视综资讯: 动漫, 电影, 电视, 娱乐资讯, 影视, 民生资讯, 综艺, 影视综其他 - 运动健身: 健身减肥, 健身塑形, 滑雪, 滑板, 水上活动, 运动其他, 足球, 篮球, 跑步, 游泳 - 宠物: 猫, 狗, 动物其他 - 文化艺术: 社科, 文化, 艺术, 文化艺术其他 - 兴趣爱好: 绘画, 手工, 阅读, 文具手账, 舞蹈, 益智玩具, 潮流玩具, 兴趣爱好其他 - 生活记录: 接地气生活, 日常片段, 中外生活, 品质生活, 校园生活 - 教育: 大学教育, k12教育, 家庭教育, 学习日常, 职场教育, 教育其他 - 情感: 情感知识, 情感日常, 情感其他 - 摄影: 人文风光摄影, 摄影技巧, 胶片摄影, 人像摄影, 摄影其他 - 游戏: 手机游戏, 主机游戏, 游戏其他, 线下游戏 - 科技数码: 数码, 玩机攻略, 数码科技其他 - 出行: 城市出行, 户外, 旅行 - 音乐 - 搞笑 - 健康养生 - 汽车 - 婚嫁: 婚礼造型, 婚礼记录, 婚礼经验, 婚礼用品 - 商业财经 - 素材 - 其他
330
- content_scene_label: Content scene label filter. Pass full Pugongying note category scene label paths separated by English or Chinese commas. Available values: - 汽车 理性决策 选车攻略 政策 - 汽车 理性决策 选车攻略 购车顾虑 - 汽车 理性决策 选车攻略 配置 - 汽车 理性决策 选车攻略 能源类型优势对比 - 汽车 理性决策 选车攻略 攻略 - 汽车 理性决策 新车测评 - 汽车 理性决策 探店试驾 - 汽车 理性决策 车主心得 - 汽车 用车场景 远行近游 近郊探索 - 汽车 用车场景 远行近游 长途自驾 - 汽车 用车场景 远行近游 硬核越野 - 汽车 用车场景 提车/交付场景 场地布置与礼遇 - 汽车 用车场景 提车/交付场景 仪式感记录 - 汽车 用车场景 商务用车 移动头等舱 - 汽车 用车场景 商务用车 商务接待 - 汽车 用车场景 亲子家庭 家庭采购日 - 汽车 用车场景 亲子家庭 接送孩子 - 汽车 用车场景 亲子家庭 三代同堂 - 汽车 用车场景 亲子家庭 周末溜娃 - 汽车 用车场景 亲子家庭 车内学习室 - 汽车 用车场景 亲子家庭 车内育婴室 - 汽车 用车场景 朋友社交 后备箱经济 - 汽车 用车场景 朋友社交 移动娱乐屋 - 汽车 用车场景 礼赠场景 毕业礼物 - 汽车 用车场景 礼赠场景 送给父母 - 汽车 用车场景 礼赠场景 适合送男友 - 汽车 用车场景 礼赠场景 适合送女友 - 汽车 用车场景 户外兴趣 钓鱼/野营 - 汽车 用车场景 户外兴趣 骑行 - 汽车 用车场景 户外兴趣 徒步 - 汽车 用车场景 户外兴趣 硬核竞速 - 汽车 用车场景 宠物出行 大型宠物 - 汽车 用车场景 宠物出行 短途出行 - 汽车 用车场景 宠物出行 小型宠物 - 汽车 用车场景 宠物出行 长途出行 - 汽车 用车场景 城市通勤 车内小憩 - 汽车 用车场景 城市通勤 健身储物 - 汽车 用车场景 城市通勤 日常通勤 - 汽车 用车场景 城市通勤 生活圈代步 - 汽车 用车场景 城市通勤 移动美容舱 - 汽车 个性化美化 个性改装 - 汽车 个性化美化 储物收纳 - 汽车 个性化美化 车内装饰 - 汽车 个性化美化 车外装饰 - 汽车 个性化美化 车衣保护 - 汽车 个性化美化 汽车用品 - 汽车 车型品类 轿车 - 汽车 车型品类 SUV - 汽车 车型品类 MPV - 汽车 车型品类 跑车 - 汽车 车型品类 微型车 - 汽车 车型品类 微面 - 汽车 车型品类 房车 - 汽车 车型品类 越野车 - 汽车 车型品类 旅行车 - 汽车 圈层属性 改装圈层 - 汽车 圈层属性 痛车圈层 - 汽车 圈层属性 跑山圈层 - 汽车 品牌倾向 自主 - 汽车 品牌倾向 豪华 - 汽车 品牌倾向 集团 - 汽车 品牌倾向 新势力 - 汽车 能源类型 纯电车 - 汽车 能源类型 新能源 - 汽车 能源类型 油车 - 汽车 人生阶段 单身 - 汽车 人生阶段 多娃&大家庭阶段 - 汽车 人生阶段 银发退休阶段 - 游戏 游戏品类 网页游戏 - 游戏 游戏品类 电脑游戏 - 游戏 游戏品类 手机游戏 - 游戏 游戏类型 动作格斗游戏 永劫无间 - 游戏 游戏类型 即时制二次元游戏 境界刀鸣 - 游戏 游戏类型 即时制二次元游戏 黑色信标 - 游戏 游戏类型 即时制二次元游戏 物华弥新 - 游戏 游戏类型 即时制二次元游戏 无期迷途 - 游戏 游戏类型 即时制二次元游戏 新月同行 - 游戏 游戏类型 即时制二次元游戏 绝区零 - 游戏 游戏类型 即时制角色扮演 诛仙2 - 游戏 游戏类型 即时制角色扮演 诛仙 - 游戏 游戏类型 即时制角色扮演 明日之后 - 游戏 游戏类型 即时制角色扮演 超自然行动组 - 游戏 游戏类型 即时制角色扮演 永恒之塔2 - 游戏 游戏类型 回合制二次元游戏 未定事件簿 - 游戏 游戏类型 回合制二次元游戏 雷索纳斯 - 游戏 游戏类型 回合制二次元游戏 浮生忆玲珑 - 游戏 游戏类型 回合制二次元游戏 重返未来1999 - 游戏 游戏类型 回合制角色扮演 梦幻西游手游 - 游戏 游戏类型 回合制角色扮演 龙魂旅人 - 游戏 游戏类型 回合制角色扮演 最终幻想14 - 游戏 游戏类型 塔防游戏 保卫向日葵 - 游戏 游戏类型 塔防游戏 全境守卫 - 游戏 游戏类型 塔防游戏 向僵尸开炮 - 游戏 游戏类型 开放世界角色扮演 燕云十六声 - 游戏 游戏类型 开放世界角色扮演 王者荣耀世界 - 游戏 游戏类型 恋爱游戏 如鸢 - 游戏 游戏类型 恋爱游戏 银与绯 - 游戏 游戏类型 恋爱游戏 时空中的绘旅人 - 游戏 游戏类型 恋爱游戏 光与夜之恋 - 游戏 游戏类型 恋爱游戏 恋与深空 - 游戏 游戏类型 恋爱游戏 恋与制作人 - 游戏 游戏类型 战略游戏 率土之滨 - 游戏 游戏类型 战略游戏 群星纪元 - 游戏 游戏类型 战略游戏 阿瓦隆之王 - 游戏 游戏类型 战略游戏 快来当领主 - 游戏 游戏类型 战略游戏 冒险之星 - 游戏 游戏类型 战略游戏 无尽的拉格朗日 - 游戏 游戏类型 放置类二次元游戏 花花与幕间剧 - 游戏 游戏类型 放置类角色扮演 发条总动员 - 游戏 游戏类型 放置类角色扮演 遮天凡尘一叶 - 游戏 游戏类型 模拟养成 美人传 - 游戏 游戏类型 模拟养成 盲盒派对 - 游戏 游戏类型 模拟养成 闪耀暖暖 - 游戏 游戏类型 模拟养成 以闪亮之名 - 游戏 游戏类型 模拟养成 无限暖暖 - 游戏 游戏类型 模拟家园建造 江南百景图 - 游戏 游戏类型 模拟家园建造 动物森友会 - 游戏 游戏类型 模拟家园建造 星露谷物语 - 游戏 游戏类型 模拟经营 暴吵萌厨 - 游戏 游戏类型 模拟经营 肥鹅健身房 - 游戏 游戏类型 模拟职业 杜拉拉升职记 - 游戏 游戏类型 消除游戏 四季合合 - 游戏 游戏类型 生存沙盒游戏 无尽冬日 - 游戏 游戏类型 聚会游戏 蛋仔派对 - 游戏 游戏类型 聚会游戏 代号砰砰 - 游戏 游戏类型 解谜游戏 晴空之下 - 游戏 游戏类型 抓宠类游戏 洛克王国手游 - 游戏 游戏类型 射击游戏 三角洲行动 - 游戏 游戏类型 射击游戏 codm(使命召唤) - 母婴 婴童洗护 安全防晒 - 母婴 婴童洗护 浴后护理 - 母婴 婴童洗护 敏感修护 - 母婴 婴童洗护 屏障树立 - 母婴 婴童洗护 泳后护理 - 母婴 婴童洗护 口周干裂 - 母婴 婴童洗护 分区清洁 - 母婴 婴童洗护 头皮问题 - 母婴 婴童洗护 驱虫驱蚊 - 母婴 婴童洗护 洁面清洁 - 母婴 婴童洗护 红屁股 - 母婴 婴童洗护 湿疹皮炎 - 母婴 婴童洗护 痱子热疹 - 母婴 婴童洗护 抚触链接 - 母婴 婴童洗护 趣味洗护 - 母婴 母婴纸品 精算育儿 - 母婴 母婴纸品 颜值派 - 母婴 母婴纸品 汗宝宝 - 母婴 母婴纸品 囤货党 - 母婴 母婴纸品 敏感肌 - 母婴 母婴纸品 肉腿娃 - 母婴 母婴纸品 功课党 - 母婴 母婴纸品 好动宝 - 母婴 母婴纸品 安睡整夜 - 母婴 母婴纸品 出行便携 - 母婴 母婴纸品 贵妇体验 - 母婴 母婴纸品 红屁屁 - 母婴 母婴小家电 空间收纳 - 母婴 母婴小家电 滋补养生 - 母婴 母婴小家电 温度把控 - 母婴 母婴小家电 夜奶操作 - 母婴 母婴小家电 新手喂养 - 母婴 母婴小家电 材质挑选 - 母婴 母婴小家电 三代同育 - 母婴 母婴小家电 户外喂养 - 母婴 母婴小家电 通乳攻略 - 母婴 母婴小家电 洁癖爸妈 - 母婴 母婴小家电 精准喂养 - 母婴 母婴小家电 职场妈妈 - 母婴 婴童辅食 吞咽能力 - 母婴 婴童辅食 多元辅食 - 母婴 婴童辅食 零食分享 - 母婴 婴童辅食 健康零食 - 母婴 婴童辅食 放学加餐 - 母婴 婴童辅食 出牙磨牙 - 母婴 婴童辅食 居家囤货 - 母婴 婴童辅食 节日礼包 - 母婴 婴童辅食 零食训练 - 母婴 婴童辅食 宝宝挑食 - 母婴 婴童辅食 户外零食 - 母婴 婴童辅食 低敏辅食 - 母婴 婴童辅食 入园社交 - 母婴 婴童辅食 居家辅食 - 母婴 婴童辅食 入园准备 - 母婴 婴童辅食 敏敏零食 - 母婴 婴童辅食 抓握训练 - 母婴 婴童辅食 外出口粮 - 母婴 婴童辅食 营养均衡 - 母婴 婴童辅食 自主进食 - 母婴 婴童辅食 第一口辅食 - 母婴 母婴营养品 开胃因子 - 母婴 母婴营养品 视力保护 - 母婴 母婴营养品 营养补充 - 母婴 母婴营养品 防护因子 - 母婴 母婴营养品 高钙因子 - 母婴 母婴营养品 自护构建 - 母婴 母婴营养品 发育表现 - 母婴 母婴营养品 助眠安睡 - 母婴 婴童奶粉 丝滑转奶 - 母婴 婴童奶粉 益生组合 - 母婴 婴童奶粉 眼脑体发育 - 母婴 婴童奶粉 选奶功课 - 母婴 婴童奶粉 防敏脱敏 - 母婴 婴童奶粉 助力聪明脑 - 母婴 婴童奶粉 乳铁自护 - 母婴 婴童奶粉 黄金长高 - 母婴 婴童奶粉 内修外护 - 母婴 婴童奶粉 肚肚吸收 - 母婴 婴童奶粉 断奶攻略 - 母婴 婴童奶粉 混合喂养 - 母婴 婴童奶粉 母源黄金HMO - 母婴 婴童奶粉 长肉多肉 - 母婴 哺乳喂养工具 萌娃穿搭 - 母婴 哺乳喂养工具 安全材质 - 母婴 哺乳喂养工具 奶瓶喂养 - 母婴 哺乳喂养工具 颜值发育 - 母婴 哺乳喂养工具 哄娃安抚 - 母婴 哺乳喂养工具 餐具选购 - 母婴 哺乳喂养工具 学饮指南 - 母婴 哺乳喂养工具 换季保温 - 母婴 母婴孕产 职场孕妇 - 母婴 母婴孕产 产后复工 - 母婴 母婴孕产 顺产 - 母婴 母婴孕产 孕期变化 - 母婴 母婴孕产 孕期学习 - 母婴 母婴孕产 剖腹产 - 母婴 母婴家居 护脊深睡 - 母婴 母婴家居 安全翻滚 - 母婴 母婴家居 进食习惯 - 母婴 母婴家居 早教启蒙 - 母婴 母婴家居 学习角落 - 母婴 母婴家居 自主入睡 - 母婴 母婴家居 爬行探索 - 母婴 母婴家居 防惊跳 - 母婴 母婴出行&用品 长线旅途 - 母婴 母婴出行&用品 户外探索 - 母婴 母婴出行&用品 二胎/双胎 - 母婴 母婴出行&用品 新贵消费 - 母婴 母婴出行&用品 备产研究 - 母婴 母婴出行&用品 短途旅行 - 母婴 母婴出行&用品 高频出行 - 母婴 母婴出行&用品 新生出行 - 母婴 母婴出行&用品 务实精算 - 母婴 母婴出行&用品 遛娃必备
331
- personal_tags: Blogger persona tag filter. Pass one or more Pugongying persona labels separated by English or Chinese commas. Available values: - 妈妈 - 萌娃 - 爸爸 - 奶奶 - 情侣 - 夫妻 - 家庭 - 闺蜜 - 兄弟 - 备孕中 - 孕期中 - 12岁以上 - 传统行业 - 互联网 - 教育科研 - 金融法律 - 企业创业 - 时尚美妆 - 食品饮料 - 文化传媒 - 医疗健康 - 艺术设计 - 影视娱乐 - 运动健身 - 专业服务 - 工程师 - 销售 - HR - 教练 - 运动员 - 舞蹈老师 - 生活背景 - 备考经验 - 兴趣爱好 - 留学背景 - 海外华人 - 铲屎官 - 孕妈 - 独居人群 - 外国人 - 混血儿 Example: - 妈妈,教练,运动员,舞蹈老师,留学背景
332
- market_target: Marketing target filter. Pass one Pugongying marketing target value. Available values: - estimateAllCpm: Exposure - exposure performance - cost - mAccumImpNum: Exposure - exposure performance - scale - readCost: Exposure - read performance - cost - mValidRawReadFeedNum: Exposure - read performance - scale - estimateEngageCost: Seeding - engagement performance - cost - mEngagementNum90d: Seeding - engagement performance - scale - estimateCpuv: Conversion - outer-store visit performance - cost - mCpuvNum: Conversion - outer-store visit performance - scale Example: - estimateAllCpm
333
- audience_group: Audience target filter. Pass Pugongying audience group IDs (`dmpGroupId`) separated by English or Chinese commas. These IDs are dynamic and account-specific, so there is no fixed global value list. Use the audience group name shown in Pugongying Audience Management to identify what each ID means. Example: - 123456,789012
334
- top20_crowds_label: Top-20 audience filter. Pass top-level or child audience labels separated by commas; child labels are converted to Pugongying request values.
335
- industry_specific_crowds_motor_dom: Industry-specific portrait filter. Pass Pugongying portrait value IDs or label values separated by commas.
336
- feature_tags: Good-at content tag filter. Pass label values separated by commas.
337
- content_theme_label: Content theme filter. Pass Pugongying value IDs or label values separated by commas; labels are converted to value IDs.
338
- exclude_low_active: Whether to exclude low-activity bloggers.
339
- fans_num_up: Whether to exclude bloggers whose fan count is dropping.
340
- note_type: Note type filter. Values: ALL=all note types, PHOTO_TEXT=mainly photo-text notes, VIDEO=mainly video notes. Available Values: - `ALL`: All note types - `PHOTO_TEXT`: Mainly photo-text notes - `VIDEO`: Mainly video notes
341
- industry: Pugongying industry preset for industry assistant style creator recommendations. Available Values: - `BEAUTY_PERSONAL_CARE_BEAUTY`: Beauty and personal care - beauty - `BEAUTY_PERSONAL_CARE_SKINCARE`: Beauty and personal care - skincare - `BEAUTY_PERSONAL_CARE_PERSONAL_CARE`: Beauty and personal care - personal care - `BEAUTY_PERSONAL_CARE_FRAGRANCE`: Beauty and personal care - fragrance - `FOOD_BEVERAGE_SNACKS`: Food and beverage - snacks - `FOOD_BEVERAGE_DRINKS`: Food and beverage - drinks - `FOOD_BEVERAGE_HEALTH_FOOD`: Food and beverage - health food - `FOOD_BEVERAGE_DAIRY`: Food and beverage - dairy - `FOOD_BEVERAGE_ALCOHOL`: Food and beverage - alcohol - `FOOD_BEVERAGE_GRAINS_OIL`: Food and beverage - grains and oil - `FOOD_BEVERAGE_CROSS_BORDER_FOOD`: Food and beverage - cross-border food - `FOOD_BEVERAGE_FRESH_FOOD`: Food and beverage - fresh food - `FOOD_BEVERAGE_MEAL_REPLACEMENT`: Food and beverage - meal replacement - `FOOD_BEVERAGE_TRADITIONAL_NOURISHMENT`: Food and beverage - traditional nourishment - `MOTHER_BABY_SUPPLIES`: Mother and baby - baby supplies - `MOTHER_BABY_FORMULA_FOOD`: Mother and baby - formula and baby food - `DIGITAL_APPLIANCES_HOME_APPLIANCES`: Digital and appliances - home appliances - `DIGITAL_APPLIANCES_DIGITAL_PRODUCTS`: Digital and appliances - digital products - `DAILY_GOODS_HOUSEHOLD_DAILY_USE`: Daily goods - household daily use - `DAILY_GOODS_PET_SUPPLIES_FOOD`: Daily goods - pet supplies and food - `DAILY_GOODS_OFFICE_SUPPLIES`: Daily goods - office supplies - `APPAREL_ACCESSORIES_CLOTHING_SHOES_HATS`: Apparel and accessories - clothing, shoes, and hats - `APPAREL_ACCESSORIES_JEWELRY`: Apparel and accessories - jewelry - `APPAREL_ACCESSORIES_BAGS_GLASSES`: Apparel and accessories - bags and glasses - `APPAREL_ACCESSORIES_SPORTS_OUTDOOR`: Apparel and accessories - sports and outdoor - `APPAREL_ACCESSORIES_WATCHES`: Apparel and accessories - watches - `APPAREL_ACCESSORIES_SECOND_HAND_LUXURY`: Apparel and accessories - second-hand luxury - `HOME_BUILDING_MATERIALS_HOME_DECOR`: Home and building materials - home decor - `HOME_BUILDING_MATERIALS_FURNITURE`: Home and building materials - furniture - `HOME_BUILDING_MATERIALS_MAIN_MATERIALS`: Home and building materials - main building materials - `AUTOMOTIVE`: Automotive - `INTERNET_ECOMMERCE`: Internet - e-commerce - `INTERNET_SOFTWARE_TOOLS`: Internet - software tools - `HEALTHCARE_MEDICAL_DEVICES`: Healthcare - medical devices - `HEALTHCARE_MEDICAL_BEAUTY`: Healthcare - medical beauty - `CULTURE_SPORTS_ENTERTAINMENT_SPORTS_GOODS`: Culture, sports, and entertainment - sports goods - `CULTURE_SPORTS_ENTERTAINMENT_STATIONERY_TOYS_GIFTS`: Culture, sports, and entertainment - stationery, toys, and gifts - `CULTURE_SPORTS_ENTERTAINMENT_OUTDOOR_PRODUCTS`: Culture, sports, and entertainment - outdoor products - `CULTURE_SPORTS_ENTERTAINMENT_ART_COLLECTIBLES`: Culture, sports, and entertainment - art collectibles - `LIFE_SERVICES_OFFLINE_RETAIL`: Life services - offline retail - `LIFE_SERVICES_BEAUTY_HAIR`: Life services - beauty and hair - `CATERING_RESTAURANTS`: Catering - restaurants - `CATERING_DRINKS_DESSERTS`: Catering - drinks and desserts - `BUSINESS_SERVICES`: Business services - `EDUCATION_TRAINING_LANGUAGE_STUDY_ABROAD`: Education and training - language and study abroad - `EDUCATION_TRAINING_VOCATIONAL_EDUCATION`: Education and training - vocational education - `EDUCATION_TRAINING_INTEREST_TRAINING`: Education and training - interest training - `EDUCATION_TRAINING_K12_EDUCATION`: Education and training - K-12 education - `EDUCATION_TRAINING_DEGREE_EDUCATION`: Education and training - degree education - `EDUCATION_TRAINING_CORPORATE_DEVELOPMENT`: Education and training - corporate and team development - `EDUCATION_TRAINING_OTHER`: Education and training - other - `GAMES`: Games - `TRAVEL_TOURISM`: Travel and tourism
342
- accum_common_imp_medin_num30d: Daily note exposure median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
343
- read_mid_nor30: Daily note read median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
344
- inter_mid_nor30: Daily note interaction median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
345
- thousand_like_percent30: Thousand-like note ratio range. Pass fractional ratios such as 0.4,null or percentage values such as 40,null.
346
- note_price: Photo-text cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
347
- video_price: Video cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
348
- invite_reply48h_num_ratio: 48-hour invite reply ratio range. Pass fractional ratios such as 0.9,0.95 or percentage values such as 90,95.
349
- progress_order_cnt: Current cooperation order count range. Pass two comma-separated numeric bounds.
350
- trade_type: Recent cooperation industry filter from Pugongying.
351
- trade_report_brand_ids: Recent cooperation brand IDs, separated by English or Chinese commas.
352
- exclude_trade_report_brand_ids: Whether to exclude creators who cooperated with the selected recent cooperation brands.
353
- accum_coop_imp_medin_num30d: Cooperation note exposure median range. Pass two comma-separated numeric bounds.
354
- read_mid_coop30: Cooperation note read median range. Pass two comma-separated numeric bounds.
355
- inter_mid_coop30: Cooperation note interaction median range. Pass two comma-separated numeric bounds.
356
- m_cpuv_num30d: Cooperation note outer-store median range. Pass two comma-separated numeric bounds.
357
- estimate_picture_cpm: Estimated photo-text CPM range. Pass two comma-separated numeric bounds.
358
- estimate_video_cpm: Estimated video CPM range. Pass two comma-separated numeric bounds.
359
- estimate_pic_read_price: Estimated photo-text read unit price range. Pass two comma-separated numeric bounds.
360
- estimate_video_read_price: Estimated video read unit price range. Pass two comma-separated numeric bounds.
361
- estimate_picture_engage_cost: Estimated photo-text engagement unit price range. Pass two comma-separated numeric bounds.
362
- estimate_video_engage_cost: Estimated video engagement unit price range. Pass two comma-separated numeric bounds.
363
- estimate_cpuv30d: Estimated outer-store visit unit price range. Pass two comma-separated numeric bounds.
364
- klive_cnt30d: Live count in the last 30 days range. Pass two comma-separated numeric bounds.
365
- avg_live_viewer_num: Average live viewer count range. Pass two comma-separated numeric bounds.
366
- avg_agmv90d: Average live sales amount range. Pass two comma-separated numeric bounds.
367
- similar_user_id: Similar creator user ID. `similarUserId` and `similarWord` must be provided together.
368
- similar_word: Similar creator keyword shown by Pugongying. `similarUserId` and `similarWord` must be provided together.
369
- fans_location: Follower audience location filter. Pass Pugongying follower-region labels separated by English or Chinese commas. Country, China province, and city-level paths are supported; district/county-level paths are not accepted. Only paths present in the Pugongying follower-region tree are accepted. Use city paths such as `福建 南平`, `福建-南平`, or `中国 福建 南平`; they are normalized to values like `中国 福建 南平`. Examples: - 福建 南平 - 中国 福建 南平,广东
370
- """
371
- return self._get(
372
- "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1",
373
- {
374
- "searchType": search_type,
375
- "keyword": keyword,
376
- "page": page,
377
- "sort": sort,
378
- "fansNumberLower": fans_number_lower,
379
- "fansNumberUpper": fans_number_upper,
380
- "fansAge": fans_age,
381
- "fansGender": fans_gender,
382
- "fansChildAgeInfo": fans_child_age_info,
383
- "gender": gender,
384
- "location": location,
385
- "contentTag": content_tag,
386
- "contentSceneLabel": content_scene_label,
387
- "personalTags": personal_tags,
388
- "marketTarget": market_target,
389
- "audienceGroup": audience_group,
390
- "top20CrowdsLabel": top20_crowds_label,
391
- "industrySpecificCrowdsMotorDom": industry_specific_crowds_motor_dom,
392
- "featureTags": feature_tags,
393
- "contentThemeLabel": content_theme_label,
394
- "excludeLowActive": exclude_low_active,
395
- "fansNumUp": fans_num_up,
396
- "noteType": note_type,
397
- "industry": industry,
398
- "accumCommonImpMedinNum30d": accum_common_imp_medin_num30d,
399
- "readMidNor30": read_mid_nor30,
400
- "interMidNor30": inter_mid_nor30,
401
- "thousandLikePercent30": thousand_like_percent30,
402
- "notePrice": note_price,
403
- "videoPrice": video_price,
404
- "inviteReply48hNumRatio": invite_reply48h_num_ratio,
405
- "progressOrderCnt": progress_order_cnt,
406
- "tradeType": trade_type,
407
- "tradeReportBrandIds": trade_report_brand_ids,
408
- "excludeTradeReportBrandIds": exclude_trade_report_brand_ids,
409
- "accumCoopImpMedinNum30d": accum_coop_imp_medin_num30d,
410
- "readMidCoop30": read_mid_coop30,
411
- "interMidCoop30": inter_mid_coop30,
412
- "mCpuvNum30d": m_cpuv_num30d,
413
- "estimatePictureCpm": estimate_picture_cpm,
414
- "estimateVideoCpm": estimate_video_cpm,
415
- "estimatePicReadPrice": estimate_pic_read_price,
416
- "estimateVideoReadPrice": estimate_video_read_price,
417
- "estimatePictureEngageCost": estimate_picture_engage_cost,
418
- "estimateVideoEngageCost": estimate_video_engage_cost,
419
- "estimateCpuv30d": estimate_cpuv30d,
420
- "kliveCnt30d": klive_cnt30d,
421
- "avgLiveViewerNum": avg_live_viewer_num,
422
- "avgAgmv90d": avg_agmv90d,
423
- "similarUserId": similar_user_id,
424
- "similarWord": similar_word,
425
- "fansLocation": fans_location,
426
- },
427
- )
428
-
429
429
  def api_pgy_kol_data_core_data_v1(
430
430
  self,
431
431
  *,
File without changes
File without changes