Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!
蒲公英内容广场（热门内容榜单）/PGY content square leaderboards
POST
https://api.tikhub.io/api/v1/xiaohongshu/pgy/get_content_square
Xiaohongshu-PGY-API
Last modified:2026-08-23 08:20:15
OperationId:get_content_square_api_v1_xiaohongshu_pgy_get_content_square_post
[中文]
用途:
拿到榜单后可以顺着笔记里的博主 ID 再去调博主侧接口深挖
1. 全部参数一览
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
biz_type | ✅ | — | 榜单，见第 3 节 |
page_num | 1 | 页码，1-100 | |
page_size | 34 | 每页数量，1-34（网页固定 34） | |
search_word | "" | 关键词；留空=看整榜。支持英文逗号分隔批量搜 | |
order_by | 随榜单 | 排序字段，见第 5 节；留空=用该榜默认排序 | |
date_range | 7 | 统计窗口，取 3 / 7 / 14 / 30（近 N 日） | |
sub_biz_type | 3 | 仅榜 8，见第 6 节 | |
category | — | 仅榜 1 的类目，见第 4 节 | |
industry | — | 榜 2/3/4/5/6/7/8 的所属行业，见第 4 节 | |
note_type / content_type / theme | — | 见第 6 节 | |
author_type / placement / marketing_target | — | 见第 6 节 | |
price / fans | — | 仅榜 4，见第 6 节 |
2. 翻页
page_num，其余参数必须原样保持不变。total 恒为 100）—— 这是榜单不是全量搜索，上游只放出 Top 100。所以
page_size=34 时翻到第 3 页就到底了，第 4 页返回空数组。要更多内容请换榜单、换筛选或换
date_range，调大 page_size 没用（上限 34）。pageInfoDto.totalPage 实测恒为 0，不要拿它判断还有没有下一页。3. 榜单（biz_type）
| 值 | 榜单 | 内容 |
|---|---|---|
1 | 小红书热门 | 全平台热门内容榜单 |
2 | 产品种草 | 营销诉求为产品种草的内容榜单 |
3 | 电商推广 | 营销诉求为商品或直播推广的内容榜单 |
4 | 蒲公英合作 | 笔记博主合作的内容榜单 |
5 | 客资收集 | 营销诉求为客资收集的内容榜单 |
6 | 电商热门 | 电商热门商品内容榜单 |
7 | 种草直达 | 营销诉求为种草直达的内容榜单 |
8 | 应用推广 | 营销诉求为应用推广的内容榜单 |
4. 各榜支持的筛选不同
不会被静默忽略（否则你会拿到一份没按预期过滤的数据却发现不了）。
| 榜 | 可用筛选 |
|---|---|
1 小红书热门 | category、note_type、content_type |
2 产品种草 / 5 客资收集 / 7 种草直达 | industry、placement、note_type、content_type、theme |
3 电商推广 | industry、placement、note_type、content_type、marketing_target |
4 蒲公英合作 | industry、note_type、author_type、theme、price、fans |
6 电商热门 | industry、note_type、content_type |
8 应用推广 | industry、placement、note_type、content_type、theme、sub_biz_type |
| 榜 | 字段 | 取值 |
|---|---|---|
1 | category | 内容类目#X 或 所属行业#X。内容类目 X 取：美妆、护肤、个人护理、母婴、时尚、美食、家居家装、影视综资讯、运动健身、宠物、文化艺术、兴趣爱好、生活记录、教育、职场、情感、摄影、游戏、科技数码、出行旅游、音乐、搞笑、健康养生、汽车、婚嫁、商业财经、素材、其他 |
2/4/5/7/8 | industry | 母婴、家用电器、3C数码、食品饮料、美妆个护、汽车出行、本地生活、日化家清、医疗健康、宠物（新）、家居家装、出行旅游、教育培训、金融行业、医疗医美、免税平台、服饰鞋包、珠宝配饰、运动户外、文玩娱乐、到店综合、奢侈品、互联网、影像婚美、房地产 |
3/6 | industry | 电商商品类目，如 茶、彩妆/香水/美妆工具、厨房电器、床上用品……（数百项，与上面两套完全不同） |
5. 排序（order_by）
| 取值 | 含义 | 取值 | 含义 |
|---|---|---|---|
premium_imp_num | 曝光量 | premium_engage_rate | 互动率 |
premium_read_num | 阅读量 | premium_like_num | 点赞量 |
premium_ctr | 阅读率 | premium_fav_num | 收藏量 |
premium_engage_num | 互动量 | premium_cmt_num | 评论量 |
3 电商推广 / 6 电商热门 额外支持：premium_ecm_dgmv（笔记支付金额）、premium_ecm_order_pv（笔记支付订单数）、premium_ecm_order_rate（笔记支付转化率）。4 蒲公英合作 额外支持（小红星=淘宝、小红盟=京东、小红链=唯品会）：taobao_third_active_pgy_user_ratio / taobao_third_active_pgy_user_cost /jd_third_active_pgy_user_ratio / jd_third_active_pgy_user_cost /wph_third_active_pgy_user_ratio / wph_third_active_pgy_user_cost。6. 其它枚举一览
| 参数 | 网页名称 | 全部取值 |
|---|---|---|
note_type | 内容类型 | 1 图文、2 视频 |
content_type | 内容来源 | 1 博主合作笔记、2 明星合作笔记、3 员工笔记、5 买手笔记、6 专业号笔记、11 主理人笔记、-1 用户笔记 |
author_type | 创作者类型 | 1 蒲公英博主、2 明星 |
placement | 流量场域 | 1 发现、2 搜索、3 视频内流 |
marketing_target | 营销目标 | 3 商品推广、8 直播推广 |
sub_biz_type | 应用唤起 | 1 应用下载、2 小程序推广、3 应用唤起 |
date_range | 时间范围 | 3、7、14、30（近 N 日） |
theme | 题材 | 吃播、双品对比、活动分享、选购攻略、问答类、仿妆变装、采访类、单品推荐、经验教程、探店打卡、生活剧情、新品预告、创意内容、知识科普、测评类、好物合集、试色、情感话题、OOTD、手工制作、开箱 |
price（创作者报价，仅榜 4）要同时给口径和区间，因为图文和视频是两套独立报价：{"kind": 1, "range": {"min": 10000, "max": 50000}}，kind 取 1 图文笔记 / 2 视频笔记。fans（创作者粉丝，仅榜 4）只要区间：{"min": 100000, "max": 500000}。7. 返回
noteList[]: 命中的笔记。每条含 noteInfo（title 标题、noteType 类型、noteLink 笔记链接、noteImages 封面、readNum 阅读、likeNum 点赞、favNum 收藏、cmtNum 评论、videoDuration 视频时长、notePublishTime 发布时间）与博主信息total: 该榜的条数，恒为 100pageInfoDto: 上游分页回执，其中 totalPage 恒为 0，不可用8. 注意:
[English]
Purpose:
directly answers "what content is hot right now"
blogger IDs from the returned notes and drill down with the blogger endpoints
1. Full Parameter List
| Param | Required | Default | Description |
|---|---|---|---|
biz_type | ✅ | — | Leaderboard, see section 3 |
page_num | 1 | Page, 1-100 | |
page_size | 34 | 1-34 (fixed at 34 on the web page) | |
search_word | "" | Keyword; empty = whole board. Comma-separated for batch search | |
order_by | per board | Sort field, see section 5; empty = board default | |
date_range | 7 | Window in days: 3 / 7 / 14 / 30 | |
sub_biz_type | 3 | Board 8 only, see section 6 | |
category | — | Board 1 only, see section 4 | |
industry | — | Boards 2/3/4/5/6/7/8, see section 4 | |
note_type / content_type / theme | — | See section 6 | |
author_type / placement / marketing_target | — | See section 6 | |
price / fans | — | Board 4 only, see section 6 |
they would be treated as a real filter.
2. Paging
page_num only and keep every other parameter identical.total is always 100) — this is a leaderboard,not a full search; upstream only exposes the Top 100. With
page_size=34 you reach theend at page 3, and page 4 returns an empty array. For more content switch boards, filters
or
date_range — raising page_size does not help (capped at 34).pageInfoDto.totalPage is always 0 in practice — do not use it to detect more pages.3. Leaderboards (biz_type)
| Value | Board | Content |
|---|---|---|
1 | Xiaohongshu Hot | Platform-wide hot content |
2 | Product Seeding | Content aimed at product seeding |
3 | E-commerce Promotion | Content promoting goods or live streams |
4 | PGY Cooperation | Sponsored notes from PGY bloggers |
5 | Lead Collection | Content aimed at lead collection |
6 | E-commerce Hot | Hot e-commerce product content |
7 | Direct Seeding | Content aimed at direct seeding |
8 | App Promotion | Content promoting apps |
4. Filters Differ per Board
422 listing what the board does support, instead of being silently ignored (otherwise
you would receive unfiltered data without noticing).
| Board | Available filters |
|---|---|
1 | category, note_type, content_type |
2 / 5 / 7 | industry, placement, note_type, content_type, theme |
3 | industry, placement, note_type, content_type, marketing_target |
4 | industry, note_type, author_type, theme, price, fans |
6 | industry, note_type, content_type |
8 | industry, placement, note_type, content_type, theme, sub_biz_type |
| Board | Field | Values |
|---|---|---|
1 | category | 内容类目#X or 所属行业#X, e.g. 内容类目#美妆 |
2/4/5/7/8 | industry | Industry names (母婴, 美妆个护, 3C数码, ... 25 in total) |
3/6 | industry | E-commerce product categories (茶, 厨房电器, ... hundreds, a different taxonomy) |
5. Sorting (order_by)
| Value | Meaning | Value | Meaning |
|---|---|---|---|
premium_imp_num | Impressions | premium_engage_rate | Engagement rate |
premium_read_num | Reads | premium_like_num | Likes |
premium_ctr | Read rate | premium_fav_num | Favorites |
premium_engage_num | Engagements | premium_cmt_num | Comments |
3 / 6 additionally support premium_ecm_dgmv (paid GMV),premium_ecm_order_pv (paid orders), premium_ecm_order_rate (paid conversion rate).4 additionally supports off-site metrics (小红星=Taobao, 小红盟=JD, 小红链=VIP):taobao_third_active_pgy_user_ratio / _cost, jd_third_active_pgy_user_ratio / _cost,wph_third_active_pgy_user_ratio / _cost.6. Other Enums
| Param | Web name | All values |
|---|---|---|
note_type | Content type | 1 image-text, 2 video |
content_type | Content source | 1 blogger sponsored, 2 celebrity sponsored, 3 employee, 5 buyer, 6 pro account, 11 owner, -1 user (values are non-contiguous) |
author_type | Creator type | 1 PGY blogger, 2 celebrity |
placement | Traffic placement | 1 discovery, 2 search, 3 in-video feed |
marketing_target | Marketing target | 3 product promotion, 8 live promotion |
sub_biz_type | App action | 1 app download, 2 mini-program, 3 app open |
date_range | Time window | 3, 7, 14, 30 (last N days) |
theme | Theme | 21 Chinese theme names (开 箱, 测评类, 好物合集, ...) |
price (board 4) needs both the quote type and the range, because image-text and video aretwo independent quotes:
{"kind": 1, "range": {"min": 10000, "max": 50000}} where kindis
1 image-text / 2 video. fans (board 4) takes a plain range.7. Return
noteList[]: matched notes; each has noteInfo (title, noteType, noteLink, noteImages,readNum, likeNum, favNum, cmtNum, videoDuration, notePublishTime) plus blogger info
total: always 100 (board capacity)pageInfoDto: upstream paging echo; its totalPage is always 0 and unusable8. Notes:
[示例/Example]
// ① 近 7 日全平台最热的美妆视频
{"biz_type": 1, "category": "内容类目#美妆", "note_type": 2}
// ② 母婴行业近 30 日互动率最高的蒲公英合作笔记，博主图文报价 1~5 万
{"biz_type": 4, "industry": "母婴", "date_range": 30,
"order_by": "premium_engage_rate",
"price": {"kind": 1, "range": {"min": 10000, "max": 50000}}}
// ③ 电商推广榜按笔记支付金额排序，只看搜索场域
{"biz_type": 3, "order_by": "premium_ecm_dgmv", "placement": 2}
// ④ 带关键词看榜
{"biz_type": 1, "search_word": "面膜"}Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.tikhub.io/api/v1/xiaohongshu/pgy/get_content_square' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"biz_type": 1,
"page_num": 1,
"page_size": 34,
"search_word": "",
"order_by": "",
"date_range": 7,
"sub_biz_type": 1,
"category": "string",
"industry": "string",
"note_type": 1,
"content_type": 1,
"theme": "string",
"author_type": 1,
"placement": 1,
"marketing_target": 3,
"price": {
"kind": 1,
"range": {
"min": 0,
"max": 0
}
},
"fans": {
"min": 0,
"max": 0
}
}'Response Response Example
200 - Example 1
{
"code": 200,
"request_id": "string",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功，本次请求将被计费。",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "string",
"time_stamp": 0,
"time_zone": "America/Los_Angeles",
"docs": "string",
"cache_message": "string",
"cache_message_zh": "string",
"cache_url": "string",
"router": "",
"params": {},
"data": null
}Modified at 2026-08-23 08:20:15