{ "openapi": "3.0.0", "info": { "title": "Xiaohongshu Creator Marketplace (Pugongying) Creator Search API (V1)", "version": "1.0.0", "description": "Get Xiaohongshu Creator Marketplace (Pugongying) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building." }, "paths": { "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1": { "get": { "tags": [ "Xiaohongshu Creator Marketplace (Pugongying)" ], "summary": "Creator Search", "description": "Get Xiaohongshu Creator Marketplace (Pugongying) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building.", "operationId": "apiSolarCooperatorBloggerV2V1", "parameters": [ { "name": "token", "in": "query", "description": "User authentication token.", "required": true, "schema": { "type": "string" } }, { "name": "searchType", "in": "query", "description": "Search criteria type.\n\nAvailable Values:\n- `NICKNAME`: Search by nickname\n- `NOTE`: Search by note content", "required": false, "schema": { "type": "string", "default": "NICKNAME", "description": "Search Type", "enum": [ "NICKNAME", "NOTE" ] } }, { "name": "keyword", "in": "query", "description": "Search keyword.", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page number.", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "fansNumberLower", "in": "query", "description": "Minimum number of fans.", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "fansNumberUpper", "in": "query", "description": "Maximum number of fans.", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "fansAge", "in": "query", "description": "Target fans age group.\n\nAvailable Values:\n- `ALL`: All ages\n- `LT_18`: Under 18\n- `AGE_18_24`: 18 to 24\n- `AGE_25_34`: 25 to 34\n- `AGE_35_44`: 35 to 44\n- `GT_44`: Above 44", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Fans age distribution", "enum": [ "ALL", "LT_18", "AGE_18_24", "AGE_25_34", "AGE_35_44", "GT_44" ] } }, { "name": "fansGender", "in": "query", "description": "Target fans gender.\n\nAvailable Values:\n- `ALL`: All genders\n- `MALE_HIGH`: Mainly Male\n- `FE_MALE_HIGH`: Mainly Female", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Fans gender distribution", "enum": [ "ALL", "MALE_HIGH", "FE_MALE_HIGH" ] } }, { "name": "gender", "in": "query", "description": "KOL's gender.\n\nAvailable Values:\n- `ALL`: All genders\n- `MALE`: Male\n- `FEMALE`: Female", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Gender type", "enum": [ "ALL", "MALE", "FEMALE" ] } }, { "name": "contentTag", "in": "query", "description": "Content categories, separated by commas.", "required": false, "schema": { "type": "string" } } ], "responses": { "default": { "description": "default response", "content": { "application/json": { "example": { "code": 0, "data": { "kols": [ { "userId": "5fe83d6600000000010078c7", "valid": 1, "headPhoto": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31sdek3jr68kg5nv87lj08u676pictl8?imageView2/2/w/120/...", "name": "鹤竹zzzz", "redId": "1032482443", "location": "天津", "homePageDisplay": 1, "travelAreaList": null, "type": [], "personalTags": null, "fansCount": 0, "likeCollectCountInfo": null, "businessNoteCount": 0, "totalNoteCount": null, "recommend": null, "picturePrice": 158, "videoPrice": 9999999, "lowerPrice": 158, "userType": 2, "showPrice": true, "pictureState": 1, "videoState": 1, "isCollect": false, "cooperateState": 1, "pictureInCart": null, "videoInCart": null, "note": null, "live": null, "cps": null, "noteSign": null, "liveSign": null, "goodRecommendPermission": null, "cpc": null, "pictureCpcBasePrice": "0", "pictureCpcPerPrice": "0", "pictureCpcEstimateNum": null, "videoCpcState": null, "videoCpcBasePrice": "0", "videoCpcPerPrice": "0", "videoCpcEstimateNum": null, "pictureCpcInCart": null, "videoCpcInCart": null, "contentTags": [ { "taxonomy1Tag": "兴趣爱好", "taxonomy2Tags": [ "阅读" ] } ], "featureTags": null, "industryTag": null, "gender": "女", "picPriceRemind": null, "videoPriceRemind": null, "currentLevel": 2, "nextLevel": -1, "priceState": 1, "resemblance": true, "noteList": [ { "noteId": "69a976c3000000000e00e3ff", "noteType": 1, "imageUrl": "http://ci.xiaohongshu.com/1040g00831tb5h0ullmqg5nv87lj08u67r2ncvv8?imageView2/2/w/540/format/jpg/q/7...", "featureTags": [], "contentTag": "文化艺术", "industryTags": null, "bind": false } ], "tradeType": null, "clickMidNum": 7972, "clickMidNumMcn": 0, "interMidNum": 1138, "fansNum": 4544, "matchNoteNumber": 0, "authorityList": null, "processingAuthorities": null, "pictureShowState": null, "videoShowState": null, "classifyCode": 1, "predictiveExposure": 0, "efficiencyValidUser": 0, "pictureReadCost": "0.31", "videoReadCost": "0.00", "pictureClickMidNum": 14139, "pictureInterMidNum": 1957, "videoClickMidNum": 0, "videoFinishRate": 0, "videoInterMidNum": 0, "fans30GrowthRate": 130.9, "fans30GrowthNum": 0, "nextPicturePrice": null, "nextVideoPrice": null, "fansRiseNum": null, "fansEngageNum": null, "overflowNum": null, "newHighQuality": 0, "isIndustryRecommend": false, "picturePriceGtZero": true, "videoPriceGtZero": true, "lowActive": true, "fansActiveIn28dLv": 98.8, "fansEngageNum30dLv": 43, "hundredLikePercent30": 80, "thousandLikePercent30": 60, "pictureHundredLikePercent30": 80, "pictureThousandLikePercent30": 60, "videoHundredLikePercent30": 0, "videoThousandLikePercent30": 0, "cooperType": 1, "buyerType": 2, "promiseImpNum": "0", "kolType": 0, "showPromiseTag": 0, "activityList": [], "controlState": 0, "clothingIndustryPrice": { "bizType": null, "industryId": 0, "picturePrice": 0, "pictureState": 0, "videoPrice": 0, "videoState": 0 }, "fbState": 0, "forecastReadUvLower": 0, "forecastReadUvUpper": 0, "forecastGroupCoverRateLower": 0, "forecastGroupCoverRateUpper": 0, "intentionInfo": { "intentionText": "", "intentionType": 0 }, "seedAndHarcest": null, "liveImg": null, "liveId": null, "liveGMV": null, "isStar": null, "top2CategoryList": null, "hasBuyerAuth": true, "sellerRealIncomeAmt90d": 0, "estimatePictureCpm": 5.26, "estimatePictureCpmCompare": 97.8, "estimateVideoCpm": 0, "estimateVideoCpmCompare": 47, "estimatePictureEngageCost": 0.07, "estimatePictureEngageCostCompare": 97.8, "estimateVideoEngageCost": 0, "estimateVideoEngageCostCompare": 47, "inviteReply48hNumRatio": 31.3, "recommendReason": null, "kolHeadLabel": 0, "accumCoopImpMedinNum30d": 0, "estimateCpuv30d": 0, "accumPicCommonImpMedinNum30d": 30032, "accumVideoCommonImpMedinNum30d": 0, "accumCommonImpMedinNum30d": 22663, "marketTarget": null, "readMidCoop30": 0, "interMidCoop30": 0, "coopNoteNum30d": 0, "specialIndustryLimit": false, "kliveCnt30d": 0, "avgAgmv90d": 0, "avgLiveViewerNum": 0, "algoRecommendReasons": null, "mcpuvNum30d": 0, "mengagementNumMcn": 0, "mengagementNum": 1278, "mEngagementNum": 1278, "mEngagementNumMcn": 0, "mCpuvNum30d": 0 } ], "total": 5000, "trackId": "kolSearch_00fbc9950e0d451ba597c36cafd6b555", "highlightWords": [], "resultType": 1, "redirect2NickSearch": false } } } } } }, "x-order": "13002200" } } }, "components": {} }