Xiaohongshu (RED) PGY Blogger Details

API docs
https://api.sandbase.ai/v1/api/xiaohongshu/pgy/blogger-detail

Retrieves detailed profile information for a specific Xiaohongshu blogger on the PGY platform using their user ID. Returns creator metrics and account details.

Price
$0.02USD / call
Method
POST
Response
JSON
Parameters
1 required · 0 optional

Playground

Input
Blogger user ID, obtainable from blogger list results or PGY blogger page URL
OutputExample
Responseoutputs · 4.8 KB · 162 lines
[
  {
    "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
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

API README

Xiaohongshu (RED) PGY Blogger Details API

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.

Use cases

  • Check a creator's current follower count before adding them to a campaign shortlist.
  • Compare estimated picture and video CPM across several bloggers to plan an ad budget.
  • Check 30-day follower growth and cooperation note counts to see how active a creator is in brand work.
  • Pull a creator's profile record into your own influencer database, keyed by user_id.

Request

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.

Parameters

NameTypeRequiredDescription
user_idstringYesBlogger user ID, obtainable from blogger list results or PGY blogger page URL

Example response

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
}

Response fields

FieldMeaning
data.fansCount / data.fansNumNumber of followers the blogger has. Both fields show the same value in this response.
data.fans30GrowthNum / data.fans30GrowthRateFollower growth over the last 30 days, as a count and as a rate. The rate can be null.
data.coopNoteNum30dNumber of cooperation notes the blogger published in the last 30 days.
data.accumCoopImpMedinNum30d / data.accumCommonImpMedinNum30dMedian impression figures over 30 days, for cooperation notes and for regular notes.
data.accumPicCommonImpMedinNum30d / data.accumVideoCommonImpMedinNum30d30-day median impression figures for regular picture notes and regular video notes.
data.estimatePictureCpm / data.estimateVideoCpmEstimated cost per thousand impressions for picture notes and for video notes.
data.estimatePictureEngageCost / data.estimateVideoEngageCostEstimated cost per engagement for picture notes and for video notes.
data.estimatePictureCpmCompare / data.estimateVideoCpmCompareComparison values for the CPM estimates above.
data.businessNoteCountNumber of business notes counted for this blogger.
data.avgLiveViewerNum / data.avgAgmv90dAverage live viewer count, and an average agmv figure over 90 days.

Notes

Pricing

$0.02 per successful call. Failed calls are not charged.

Explore more

Related APIs

All APIs
APIPriceResponse
Xiaohongshu$0.02 per callJSON
Xiaohongshu$0.02 per callJSON
Xiaohongshu$0.02 per callJSON
Xiaohongshu$0.02 per callJSON
Xiaohongshu$0.02 per callJSON
Xiaohongshu$0.02 per callJSON

Questions

FAQ

How do I use the Xiaohongshu (RED) PGY Blogger Details API?

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.

How much does the Xiaohongshu (RED) PGY Blogger Details API cost?

$0.02 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 Details API accept?

Required: user_id (string). The Parameters table and the Playground on this page list every field.

What does the Xiaohongshu (RED) PGY Blogger Details API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Xiaohongshu developer account or API key?

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.