user_idstringrequired
Blogger user ID, obtainable from blogger list results or PGY blogger page URL
https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-detailRetrieves detailed profile information for a specific Xiaohongshu blogger on the PGY platform using their user ID. Returns creator metrics and account details.
[
{
"data": {
"code": 0,
"data": {
"accumCommonImpMedinNum30d": 0,
"accumCoopImpMedinNum30d": 0,
"accumPicCommonImpMedinNum30d": 0,
"accumVideoCommonImpMedinNum30d": 0,
"activityList": null,
"algoRecommendReasons": null,
"authorityList": null,
"avgAgmv90d": 0,
"avgLiveViewerNum": 0,
"businessNoteCount": 0,
"buyerType": 1,
"classifyCode": null,
"clickMidNum": 0,
"clickMidNumMcn": 0,
"clothingIndustryPrice": null,
"contentTags": null,
"controlState": 0,
"coopNoteNum30d": 0,
"cooperType": 2,
"cooperateState": null,
"cpc": null,
"cps": null,
"currentLevel": null,
"efficiencyValidUser": null,
"estimateCpuv30d": 0,
"estimatePictureCpm": 0,
"estimatePictureCpmCompare": 0,
"estimatePictureEngageCost": 0,
"estimatePictureEngageCostCompare": 0,
"estimateVideoCpm": 0,
"estimateVideoCpmCompare": 0,
"estimateVideoEngageCost": 0,
"estimateVideoEngageCostCompare": 0,
"fans30GrowthNum": 0,
"fans30GrowthRate": null,
"fansActiveIn28dLv": null,
"fansCount": 37418,
"fansEngageNum": null,
"fansEngageNum30dLv": null,
"fansNum": 37418,
"fansRiseNum": null,
"fbState": 0,
"featureTags": null,
"forecastGroupCoverRateLower": 0,
"forecastGroupCoverRateUpper": 0,
"forecastReadUvLower": 0,
"forecastReadUvUpper": 0,
"gender": "女",
"goodRecommendPermission": null,
"hasBuyerAuth": false,
"headPhoto": "https://sns-avatar-qc.xhscdn.com/avatar/64354610ec2be016c1cf5f6a.jpg?imageView2/2/w/120/format/jpg",
"homePageDisplay": 1,
"hundredLikePercent30": null,
"industryTag": null,
"intentionInfo": null,
"interMidCoop30": null,
"interMidNum": 0,
"inviteReply48hNumRatio": 0,
"isCollect": null,
"isIndustryRecommend": null,
"isStar": null,
"kliveCnt30d": 0,
"kolHeadLabel": 0,
"kolType": 0,
"likeCollectCountInfo": 587253,
"live": null,
"liveCooperateLimit": null,
"liveGMV": null,
"liveId": null,
"liveImg": null,
"liveSign": {
"name": "",
"userId": ""
},
"location": "四川 成都 双流区",
"lowActive": false,
"lowerPrice": null,
"mCpuvNum30d": 0,
"mEngagementNum": 0,
"mEngagementNumMcn": 0,
"marketTarget": null,
"matchNoteNumber": 0,
"mcpuvNum30d": 0,
"mengagementNum": 0,
"mengagementNumMcn": 0,
"name": "快乐小欢",
"newHighQuality": 0,
"nextLevel": null,
"nextPicturePrice": null,
"nextVideoPrice": null,
"note": null,
"noteList": null,
"noteSign": null,
"overflowNum": null,
"personalTags": [],
"picPriceRemind": null,
"pictureClickMidNum": 0,
"pictureCpcBasePrice": null,
"pictureCpcEstimateNum": null,
"pictureCpcInCart": null,
"pictureCpcPerPrice": null,
"pictureHundredLikePercent30": null,
"pictureInCart": null,
"pictureInterMidNum": 0,
"picturePrice": null,
"picturePriceGtZero": false,
"pictureReadCost": null,
"pictureShowState": null,
"pictureState": null,
"pictureThousandLikePercent30": null,
"predictiveExposure": null,
"priceState": null,
"processingAuthorities": null,
"promiseImpNum": null,
"readMidCoop30": null,
"recommend": null,
"recommendReason": null,
"redId": "9549661040",
"resemblance": null,
"seedAndHarcest": null,
"sellerRealIncomeAmt90d": 0,
"showPrice": null,
"showPromiseTag": 0,
"specialIndustryLimit": null,
"thousandLikePercent30": null,
"top2CategoryList": null,
"totalNoteCount": null,
"tradeType": null,
"travelAreaList": null,
"type": [],
"userId": "60b137080000000001000301",
"userType": 1,
"valid": 1,
"videoClickMidNum": 0,
"videoCpcBasePrice": null,
"videoCpcEstimateNum": null,
"videoCpcInCart": null,
"videoCpcPerPrice": null,
"videoCpcState": null,
"videoFinishRate": null,
"videoHundredLikePercent30": null,
"videoInCart": null,
"videoInterMidNum": 0,
"videoPrice": null,
"videoPriceGtZero": false,
"videoPriceRemind": null,
"videoReadCost": null,
"videoShowState": null,
"videoState": null,
"videoThousandLikePercent30": null
},
"guid": null,
"msg": "成功",
"success": true
}
}
]Select an example to load its inputs and result into the playground.
Returns a PGY profile record for one Xiaohongshu (RED) blogger. It needs the blogger's user_id. The record holds follower counts, 30-day cooperation and impression figures, and estimated ad cost metrics.
user_id.curl -X POST "https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-detail" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"user_id": "60b137080000000001000301"}'
The result is returned in outputs[0].data.
| Name | Type | Required | Description |
|---|---|---|---|
user_id | string | Yes | Blogger user ID, obtainable from blogger list results or PGY blogger page URL |
Real response for the request above, trimmed: lists keep their first item and long strings are cut.
{
"code": 0,
"data": {
"accumCommonImpMedinNum30d": 0,
"accumCoopImpMedinNum30d": 0,
"accumPicCommonImpMedinNum30d": 0,
"accumVideoCommonImpMedinNum30d": 0,
"activityList": null,
"algoRecommendReasons": null,
"authorityList": null,
"avgAgmv90d": 0.0,
"avgLiveViewerNum": 0.0,
"businessNoteCount": 0,
"buyerType": 1,
"classifyCode": null
},
"guid": null,
"msg": "成功",
"success": true
}
| Field | Meaning |
|---|---|
data.fansCount / data.fansNum | Number of followers the blogger has. Both fields show the same value in this response. |
data.fans30GrowthNum / data.fans30GrowthRate | Follower growth over the last 30 days, as a count and as a rate. The rate can be null. |
data.coopNoteNum30d | Number of cooperation notes the blogger published in the last 30 days. |
data.accumCoopImpMedinNum30d / data.accumCommonImpMedinNum30d | Median impression figures over 30 days, for cooperation notes and for regular notes. |
data.accumPicCommonImpMedinNum30d / data.accumVideoCommonImpMedinNum30d | 30-day median impression figures for regular picture notes and regular video notes. |
data.estimatePictureCpm / data.estimateVideoCpm | Estimated cost per thousand impressions for picture notes and for video notes. |
data.estimatePictureEngageCost / data.estimateVideoEngageCost | Estimated cost per engagement for picture notes and for video notes. |
data.estimatePictureCpmCompare / data.estimateVideoCpmCompare | Comparison values for the CPM estimates above. |
data.businessNoteCount | Number of business notes counted for this blogger. |
data.avgLiveViewerNum / data.avgAgmv90d | Average live viewer count, and an average agmv figure over 90 days. |
user_id from the blogger list results in Xiaohongshu (RED) PGY Blogger Search, or from the PGY blogger page URL.null or 0 when the PGY platform has no value for that blogger.$0.02 per successful call. Failed calls are not charged.
Start building
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-detail" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"user_id": "60b137080000000001000301"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
user_idstringrequiredBlogger user ID, obtainable from blogger list results or PGY blogger page URL
Saved example response for this API; no live request is made when viewing it.
[
{
"data": {
"code": 0,
"data": {
"accumCommonImpMedinNum30d": 0,
"accumCoopImpMedinNum30d": 0,
"accumPicCommonImpMedinNum30d": 0,
"accumVideoCommonImpMedinNum30d": 0,
"activityList": null,
"algoRecommendReasons": null,
"authorityList": null,
"avgAgmv90d": 0,
"avgLiveViewerNum": 0,
"businessNoteCount": 0,
"buyerType": 1,
"classifyCode": null,
"clickMidNum": 0,
"clickMidNumMcn": 0,
"clothingIndustryPrice": null,
"contentTags": null,
"controlState": 0,
"coopNoteNum30d": 0,
"cooperType": 2,
"cooperateState": null,
"cpc": null,
"cps": null,
"currentLevel": null,
"efficiencyValidUser": null,
"estimateCpuv30d": 0,
"estimatePictureCpm": 0,
"estimatePictureCpmCompare": 0,
"estimatePictureEngageCost": 0,
"estimatePictureEngageCostCompare": 0,
"estimateVideoCpm": 0,
"estimateVideoCpmCompare": 0,
"estimateVideoEngageCost": 0,
"estimateVideoEngageCostCompare": 0,
"fans30GrowthNum": 0,
"fans30GrowthRate": null,
"fansActiveIn28dLv": null,
"fansCount": 37418,
"fansEngageNum": null,
"fansEngageNum30dLv": null,
"fansNum": 37418,
"fansRiseNum": null,
"fbState": 0,
"featureTags": null,
"forecastGroupCoverRateLower": 0,
"forecastGroupCoverRateUpper": 0,
"forecastReadUvLower": 0,
"forecastReadUvUpper": 0,
"gender": "女",
"goodRecommendPermission": null,
"hasBuyerAuth": false,
"headPhoto": "https://sns-avatar-qc.xhscdn.com/avatar/64354610ec2be016c1cf5f6a.jpg?imageView2/2/w/120/format/jpg",
"homePageDisplay": 1,
"hundredLikePercent30": null,
"industryTag": null,
"intentionInfo": null,
"interMidCoop30": null,
"interMidNum": 0,
"inviteReply48hNumRatio": 0,
"isCollect": null,
"isIndustryRecommend": null,
"isStar": null,
"kliveCnt30d": 0,
"kolHeadLabel": 0,
"kolType": 0,
"likeCollectCountInfo": 587253,
"live": null,
"liveCooperateLimit": null,
"liveGMV": null,
"liveId": null,
"liveImg": null,
"liveSign": {
"name": "",
"userId": ""
},
"location": "四川 成都 双流区",
"lowActive": false,
"lowerPrice": null,
"mCpuvNum30d": 0,
"mEngagementNum": 0,
"mEngagementNumMcn": 0,
"marketTarget": null,
"matchNoteNumber": 0,
"mcpuvNum30d": 0,
"mengagementNum": 0,
"mengagementNumMcn": 0,
"name": "快乐小欢",
"newHighQuality": 0,
"nextLevel": null,
"nextPicturePrice": null,
"nextVideoPrice": null,
"note": null,
"noteList": null,
"noteSign": null,
"overflowNum": null,
"personalTags": [],
"picPriceRemind": null,
"pictureClickMidNum": 0,
"pictureCpcBasePrice": null,
"pictureCpcEstimateNum": null,
"pictureCpcInCart": null,
"pictureCpcPerPrice": null,
"pictureHundredLikePercent30": null,
"pictureInCart": null,
"pictureInterMidNum": 0,
"picturePrice": null,
"picturePriceGtZero": false,
"pictureReadCost": null,
"pictureShowState": null,
"pictureState": null,
"pictureThousandLikePercent30": null,
"predictiveExposure": null,
"priceState": null,
"processingAuthorities": null,
"promiseImpNum": null,
"readMidCoop30": null,
"recommend": null,
"recommendReason": null,
"redId": "9549661040",
"resemblance": null,
"seedAndHarcest": null,
"sellerRealIncomeAmt90d": 0,
"showPrice": null,
"showPromiseTag": 0,
"specialIndustryLimit": null,
"thousandLikePercent30": null,
"top2CategoryList": null,
"totalNoteCount": null,
"tradeType": null,
"travelAreaList": null,
"type": [],
"userId": "60b137080000000001000301",
"userType": 1,
"valid": 1,
"videoClickMidNum": 0,
"videoCpcBasePrice": null,
"videoCpcEstimateNum": null,
"videoCpcInCart": null,
"videoCpcPerPrice": null,
"videoCpcState": null,
"videoFinishRate": null,
"videoHundredLikePercent30": null,
"videoInCart": null,
"videoInterMidNum": 0,
"videoPrice": null,
"videoPriceGtZero": false,
"videoPriceRemind": null,
"videoReadCost": null,
"videoShowState": null,
"videoState": null,
"videoThousandLikePercent30": null
},
"guid": null,
"msg": "成功",
"success": true
}
}
]Explore more
| API | Price | Response |
|---|---|---|
Xiaohongshu | $0.02 per call | JSON |
Xiaohongshu | $0.02 per call | JSON |
Xiaohongshu | $0.02 per call | JSON |
Xiaohongshu | $0.02 per call | JSON |
Xiaohongshu | $0.02 per call | JSON |
Xiaohongshu | $0.02 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-detail 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.
$0.02 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
Required: user_id (string). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
No. Xiaohongshu (RED) PGY Blogger Details 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.