Xiaohongshu (RED) PGY Blogger Search
https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-listReturns a paginated list of cooperable Xiaohongshu Pugongying bloggers matched under a specific brand. Filter candidate creators using keyword searches, audience profiles, performance metrics, and similar creator IDs.
- Price
- $0.03USD / call
- Method
- POST
- Response
- JSON
- Parameters
- 1 required · 15 optional
Production route
Try the model
Playground
Input
Brand/advertiser user ID, PGY matches under this brand (required)
11000
Page number, start from 1 Range: 1 to 1000.
1100
Page size (1-100) Range: 1 to 100.
搜索词；空=只筛选不搜索/Keyword
1=按笔记关键词找博主(默认) 0=按昵称搜/Search mode Allowed values: 0, 1.
排序字段，共 34 个，见接口说明的排序字段表/Sort column, 34 options, see endpoint docs Allowed values: comprehensiverank, fansCount, price, clickNum, mEngagementNum, accumCommonImpMedinNum30d, accumPicCommonImpMedinNum30d, accumVideoCommonImpMedinNum30d, pictureClickMidNum, videoClickMidNum, pictureInterMidNum, videoInterMidNum, thousandLikePercent30, pictureThousandLikePercent30, videoThousandLikePercent30, hundredLikePercent30, pictureHundredLikePercent30, videoHundredLikePercent30, videoFinishRate, accumCoopImpMedinNum30d, readMidCoop30, interMidCoop30, mCpuvNum30d, picturePrice, videoPrice, pictureReadCost, videoReadCost, inviteReply48hNumRatio, fans30GrowthRate, fansActiveIn28dLv, fansEngageNum30dLv, kliveCnt30d, avgLiveViewerNum, avgAgmv90d.
排序方向 desc/asc Allowed values: desc, asc.
找相似博主：填一个博主的 userId，返回与他相似的博主，**并且可以叠加下面所有筛选**（这是它与 /get_blogger_similar 的关键区别）/Find similar bloggers; unlike /get_blogger_similar it can be combined with all filters below
配合 similar_user_id 的博主昵称，仅用于回显、不影响结果/Nickname echo for similar_user_id; does not affect results
合作目标筛选/Cooperation goal filters
博主属性筛选/Blogger attribute filters
粉丝画像筛选/Fans profile filters
日常笔记数据筛选/Organic note metric filters
合作笔记数据筛选/Sponsored note metric filters
直播数据筛选/Live metric filters
开关类筛选/Boolean flag filters
OutputExample
[
{
"data": {
"code": 0,
"data": {
"highlightWords": [],
"kols": [
{
"accumCommonImpMedinNum30d": 0,
"accumCoopImpMedinNum30d": 230915,
"accumPicCommonImpMedinNum30d": 0,
"accumVideoCommonImpMedinNum30d": 0,
"activityList": [],
"algoRecommendReasons": null,
"authorityList": null,
"avgAgmv90d": 0,
"avgLiveViewerNum": 0,
"businessNoteCount": 132,
"buyerType": 2,
"classifyCode": 2,
"clickMidNum": 0,
"clickMidNumMcn": 0,
"clothingIndustryPrice": {
"bizType": null,
"industryId": 0,
"picturePrice": 0,
"pictureState": 0,
"videoPrice": 0,
"videoState": 0
},
"contentTags": [
{
"taxonomy1Tag": "美妆",
"taxonomy2Tags": [
"底妆",
"唇妆"
]
},
{
"taxonomy1Tag": "护肤",
"taxonomy2Tags": [
"面部保养"
]
}
],
"controlState": 0,
"coopNoteNum30d": 0,
"cooperType": 1,
"cooperateState": 1,
"cpc": null,
"cps": null,
"currentLevel": 2,
"efficiencyValidUser": 0,
"estimateCpuv30d": 11.14,
"estimatePictureCpm": 0,
"estimatePictureCpmCompare": 17.2,
"estimatePictureEngageCost": 0,
"estimatePictureEngageCostCompare": 16.7,
"estimateVideoCpm": 94.71,
"estimateVideoCpmCompare": 54.5,
"estimateVideoEngageCost": 11.79,
"estimateVideoEngageCostCompare": 66.1,
"fans30GrowthNum": 0,
"fans30GrowthRate": 0,
"fansActiveIn28dLv": 79,
"fansCount": 0,
"fansEngageNum": null,
"fansEngageNum30dLv": 0.6,
"fansNum": 116353,
"fansRiseNum": null,
"fbState": 0,
"featureTags": [
"黄皮",
"抗老",
"隔离防晒",
"测评",
"教程"
],
"forecastGroupCoverRateLower": 0,
"forecastGroupCoverRateUpper": 0,
"forecastReadUvLower": 0,
"forecastReadUvUpper": 0,
"gender": "女",
"goodRecommendPermission": null,
"hasBuyerAuth": true,
"headPhoto": "https://sns-avatar-qc.xhscdn.com/avatar/6264f48826897e7688a8df7f.jpg?imageView2/2/w/120/format/jpg",
"homePageDisplay": 1,
"hundredLikePercent30": 0,
"industryTag": null,
"intentionInfo": {
"intentionText": "",
"intentionType": 0
},
"interMidCoop30": 1666,
"interMidNum": 0,
"inviteReply48hNumRatio": 63.4,
"isCollect": false,
"isIndustryRecommend": false,
"isStar": null,
"kliveCnt30d": 0,
"kolHeadLabel": 1,
"kolType": 0,
"likeCollectCountInfo": null,
"live": null,
"liveCooperateLimit": false,
"liveGMV": null,
"liveId": null,
"liveImg": null,
"liveSign": null,
"location": "重庆",
"lowActive": false,
"lowerPrice": 14000,
"mCpuvNum30d": 152,
"mEngagementNum": 0,
"mEngagementNumMcn": 0,
"marketTarget": null,
"matchNoteNumber": 0,
"mcpuvNum30d": 152,
"mengagementNum": 0,
"mengagementNumMcn": 0,
"name": "Lildee",
"newHighQuality": 0,
"nextLevel": -1,
"nextPicturePrice": null,
"nextVideoPrice": null,
"note": null,
"noteList": [
{
"bind": true,
"contentTag": "美妆个护",
"featureTags": [],
"imageUrl": "http://ci.xiaohongshu.com/1040g008325no5td0460g40q02shf8ugjq74o0do?imageView2/2/w/540/format/jpg/q/75",
"industryTags": null,
"noteId": "6abc9a6a000000001203565d",
"noteType": 2
},
{
"bind": true,
"contentTag": "美妆个护",
"featureTags": [
"抗老",
"祛皱"
],
"imageUrl": "http://ci.xiaohongshu.com/1040g008325hlmivg447g40q02shf8ugj98f9v60?imageView2/2/w/540/format/jpg/q/75",
"industryTags": null,
"noteId": "6ab64b3c0000000012035b70",
"noteType": 2
}
],
"noteSign": null,
"overflowNum": null,
"personalTags": null,
"picPriceRemind": null,
"pictureClickMidNum": 0,
"pictureCpcBasePrice": "0",
"pictureCpcEstimateNum": null,
"pictureCpcInCart": null,
"pictureCpcPerPrice": "0",
"pictureHundredLikePercent30": 0,
"pictureInCart": null,
"pictureInterMidNum": 0,
"picturePrice": 14000,
"picturePriceGtZero": true,
"pictureReadCost": "0.00",
"pictureShowState": null,
"pictureState": 1,
"pictureThousandLikePercent30": 0,
"predictiveExposure": 0,
"priceState": 1,
"processingAuthorities": null,
"promiseImpNum": "0",
"readMidCoop30": 19387,
"recommend": null,
"recommendReason": null,
"redId": "427554538",
"resemblance": true,
"seedAndHarcest": null,
"sellerRealIncomeAmt90d": 0,
"showPrice": true,
"showPromiseTag": 0,
"specialIndustryLimit": false,
"thousandLikePercent30": 0,
"top2CategoryList": null,
"totalNoteCount": null,
"tradeType": "日用百货 美妆个护",
"travelAreaList": null,
"type": [],
"userId": "557862f4a75c953cb1717a13",
"userType": 2,
"valid": 1,
"videoClickMidNum": 0,
"videoCpcBasePrice": "0",
"videoCpcEstimateNum": null,
"videoCpcInCart": null,
"videoCpcPerPrice": "0",
"videoCpcState": null,
"videoFinishRate": 0,
"videoHundredLikePercent30": 0,
"videoInCart": null,
"videoInterMidNum": 0,
"videoPrice": 20000,
"videoPriceGtZero": true,
"videoPriceRemind": null,
"videoReadCost": "2.53",
"videoShowState": null,
"videoState": 1,
"videoThousandLikePercent30": 0
},
{
"accumCommonImpMedinNum30d": 90853,
"accumCoopImpMedinNum30d": 129645,
"accumPicCommonImpMedinNum30d": 90853,
"accumVideoCommonImpMedinNum30d": 0,
"activityList": [],
"algoRecommendReasons": null,
"authorityList": null,
"avgAgmv90d": 0,
"avgLiveViewerNum": 0,
"businessNoteCount": 299,
"buyerType": 2,
"classifyCode": 2,
"clickMidNum": 8346,
"clickMidNumMcn": 0,
"clothingIndustryPrice": {
"bizType": null,
"industryId": 0,
"picturePrice": 0,
"pictureState": 0,
"videoPrice": 0,
"videoState": 0
},
"contentTags": [
{
"taxonomy1Tag": "美妆",
"taxonomy2Tags": [
"美妆合集",
"底妆"
]
},
{
"taxonomy1Tag": "个人护理",
"taxonomy2Tags": [
"身体护理",
"头发产品"
]
},
{
"taxonomy1Tag": "护肤",
"taxonomy2Tags": [
"护肤合集",
"面部保养"
]
}
],
"controlState": 0,
"coopNoteNum30d": 0,
"cooperType": 1,
"cooperateState": 1,
"cpc": null,
"cps": null,
"currentLevel": 2,
"efficiencyValidUser": 0,
"estimateCpuv30d": 11.3,
"estimatePictureCpm": 63.33,
"estimatePictureCpmCompare": 67,
"estimatePictureEngageCost": 5.35,
"estimatePictureEngageCostCompare": 71.5,
"estimateVideoCpm": 0,
"estimateVideoCpmCompare": 25.5,
"estimateVideoEngageCost": 0,
"estimateVideoEngageCostCompare": 27.9,
"fans30GrowthNum": 0,
"fans30GrowthRate": 0.7,
"fansActiveIn28dLv": 41.5,
"fansCount": 0,
"fansEngageNum": null,
"fansEngageNum30dLv": 2,
"fansNum": 48769,
"fansRiseNum": null,
"fbState": 0,
"featureTags": [
"抗老",
"开箱",
"混合肌"
],
"forecastGroupCoverRateLower": 0,
"forecastGroupCoverRateUpper": 0,
"forecastReadUvLower": 0,
"forecastReadUvUpper": 0,
"gender": "女",
"goodRecommendPermission": null,
"hasBuyerAuth": true,
"headPhoto": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo3105uu8a6m6005namhoqg9ej70r485no?imageView2/2/w/120/format/jpg",
"homePageDisplay": 1,
"hundredLikePercent30": 100,
"industryTag": null,
"intentionInfo": {
"intentionText": "",
"intentionType": 0
},Examples
Select an example to load its inputs and result into the playground.
Model card
Specifications
Pricing
- Base price
- $0.03 / run
Request & response
- Method
- POST
- Request body
- application/json
- Response
- application/json
- Execution
- sync
Parameters
- brand_user_id
- string · required
- page_num
- integer · optional
- page_size
- integer · optional
- keyword
- string · optional
- search_type
- integer (0, 1) · optional
- column
- string (comprehensiverank, fansCount, price, clickNum, mEngagementNum, accumCommonImpMedinNum30d, accumPicCommonImpMedinNum30d, accumVideoCommonImpMedinNum30d, pictureClickMidNum, videoClickMidNum, pictureInterMidNum, videoInterMidNum, thousandLikePercent30, pictureThousandLikePercent30, videoThousandLikePercent30, hundredLikePercent30, pictureHundredLikePercent30, videoHundredLikePercent30, videoFinishRate, accumCoopImpMedinNum30d, readMidCoop30, interMidCoop30, mCpuvNum30d, picturePrice, videoPrice, pictureReadCost, videoReadCost, inviteReply48hNumRatio, fans30GrowthRate, fansActiveIn28dLv, fansEngageNum30dLv, kliveCnt30d, avgLiveViewerNum, avgAgmv90d) · optional
- sort
- string (desc, asc) · optional
- similar_user_id
- any · optional
- similar_word
- any · optional
- goal
- any · optional
- blogger
- any · optional
- fans
- any · optional
- More
- +4 optional parameters
Access
- Provider
- Xiaohongshu
- API
- Platform API
- Base URL
- https://api.sandbase.ai
- Endpoint
- /v1/api/xiaohongshu/pgy/blogger-list
- Authentication
- Bearer API key
API README
Xiaohongshu (RED) PGY Blogger Search API
Query cooperable Pugongying bloggers for a brand by passing brand_user_id. Refine candidate lists with optional filters such as keyword, column, search_type, and similar_user_id.
Use cases
- Search for potential brand collaboration partners using target note keywords or creator nicknames.
- Discover creators with audiences and performance metrics similar to a reference similar_user_id.
- Rank potential influencers by engagement metrics, follower count, or historical read performance.
Request
curl -X POST "https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-list" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"brand_user_id": "<brand_user_id>"}'
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brand_user_id | string | Yes | Brand/advertiser user ID, PGY matches under this brand (required) |
coop | string | No | 合作笔记数据筛选/Sponsored note metric filters |
fans | string | No | 粉丝画像筛选/Fans profile filters |
goal | string | No | 合作目标筛选/Cooperation goal filters |
live | string | No | 直播数据筛选/Live metric filters |
note | string | No | 日常笔记数据筛选/Organic note metric filters |
sort | string | No | 排序方向 desc/asc |
flags | string | No | 开关类筛选/Boolean flag filters |
column | string | No | 排序字段，共 34 个，见接口说明的排序字段表/Sort column, 34 options, see endpoint docs |
blogger | string | No | 博主属性筛选/Blogger attribute filters |
keyword | string | No | 搜索词；空=只筛选不搜索/Keyword |
page_num | integer | No | Page number, start from 1 |
page_size | integer | No | Page size (1-100) |
search_type | integer | No | 1=按笔记关键词找博主(默认) 0=按昵称搜/Search mode |
similar_word | string | No | 配合 similar_user_id 的博主昵称，仅用于回显、不影响结果/Nickname echo for similar_user_id; does not affect results |
similar_user_id | string | No | 找相似博主：填一个博主的 userId，返回与他相似的博主，并且可以叠加下面所有筛选（这是它与 /get_blogger_similar 的关键区别）/Find similar bloggers; unlike /get_blogger_similar it can be combined with all filt… |
Notes
- Set
search_typeto1to search by note keywords or0to search by creator nickname. - Pass
brand_user_idto scope blogger matching under the specified brand or advertiser account. - Supports pagination through
page_numstarting from 1 andpage_sizebetween 1 and 100.
Related APIs
- Xiaohongshu (RED) Blogger Core Data: Returns Pugongying core performance metrics and daily trend data for a specified Xiaohongshu blogger, filterable by date range, note type, and traffic source.
- Xiaohongshu (RED) PGY Blogger Data Summary: Returns an account-level data summary for a Xiaohongshu blogger on the Pugongying (PGY) platform based on the specified blogger user ID.
- Xiaohongshu (RED) PGY Blogger Details: Retrieves detailed profile information for a specific Xiaohongshu blogger on the PGY platform using their user ID.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-list" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"sort": "desc",
"column": "comprehensiverank",
"keyword": "咖啡",
"search_type": 1,
"similar_user_id": "5c668b3e0000000012021605",
"blogger": {
"content_tag": [
"美妆"
]
},
"brand_user_id": "59ae4dfc5e87e72475fb3bf3",
"fans": {
"count": {
"max": 500000,
"min": 10000
}
},
"page_num": 1,
"page_size": 5
}
SANDBASE_JSON
)
printf '%s\n' "$result"Explore more
Related APIs
| API | Price | Response | Released |
|---|---|---|---|
Xiaohongshu | $0.03 per call | JSON | Jul 31, 2026 |
Xiaohongshu | $0.03 per call | JSON | Jul 31, 2026 |
Xiaohongshu | $0.03 per call | JSON | Jul 31, 2026 |
Xiaohongshu | $0.03 per call | JSON | Jul 31, 2026 |
Xiaohongshu | $0.03 per call | JSON | Jul 31, 2026 |
Xiaohongshu | $0.03 per call | JSON | Jul 31, 2026 |
Questions
FAQ
How do I use the Xiaohongshu (RED) PGY Blogger Search API?
Send a POST request to https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-list with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
How much does the Xiaohongshu (RED) PGY Blogger Search API cost?
$0.03 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
What parameters does the Xiaohongshu (RED) PGY Blogger Search API accept?
Required: brand_user_id (string). Optional: page_num (integer), page_size (integer), keyword (string), search_type (one of 0, 1), column (one of comprehensiverank, fansCount, price, clickNum, mEngagementNum, accumCommonImpMedinNum30d, accumPicCommonImpMedinNum30d, accumVideoCommonImpMedinNum30d, pictureClickMidNum, videoClickMidNum, pictureInterMidNum, videoInterMidNum, thousandLikePercent30, pictureThousandLikePercent30, videoThousandLikePercent30, hundredLikePercent30, pictureHundredLikePercent30, videoHundredLikePercent30, videoFinishRate, accumCoopImpMedinNum30d, readMidCoop30, interMidCoop30, mCpuvNum30d, picturePrice, videoPrice, pictureReadCost, videoReadCost, inviteReply48hNumRatio, fans30GrowthRate, fansActiveIn28dLv, fansEngageNum30dLv, kliveCnt30d, avgLiveViewerNum, avgAgmv90d) and sort (one of desc, asc) and 9 more. The Parameters table and the Playground on this page list every field.
What does the Xiaohongshu (RED) PGY Blogger Search API return?
A JSON response returned in the same HTTP request (synchronous).
Do I need a Xiaohongshu developer account or API key?
No. Xiaohongshu (RED) PGY Blogger Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Xiaohongshu API access separately.