小红书蒲公英 API - 用户博主 (V1)
获取博主个人资料信息。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 用户鉴权令牌。 |
userId | query | string | 是 | 博主的用户ID。 |
代码示例
💡 环境说明
默认示例使用 https://api.justoneapi.com (prod-global)。中国大陆地区建议替换为 http://47.117.133.51:30015 (prod-cn) 以获得更好的访问体验。详见 环境选择。
bash
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE"text
我想使用 Just One API 提供的“用户博主 (V1)”接口。
接口地址: https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/xiaohongshu-pgy-apis/user-blogger-v1-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- userId (query): 博主的用户ID。 (必填)
返回格式: JSON
响应处理与错误码:
1. 需通过返回体中的 "code" 字段判断业务结果(code 为 0 表示成功)。
2. 超时建议:建议将请求超时时间设置为至少 60 秒。
3. 业务码说明:
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败,请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 余额不足
请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。python
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import requests
url = "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE"
response = requests.get(url)
print(response.json())js
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果
json
{
"code": 0,
"data": {
"userId": "659902c1000000002200361b",
"valid": 1,
"headPhoto": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo318js80k03k005pcp0b0ogdgrnpa11ig?imageView2/2/w/120/format/jpg",
"name": "团子有点咸",
"redId": "4639645438",
"location": "河北 廊坊 固安县",
"homePageDisplay": 1,
"travelAreaList": null,
"type": [],
"personalTags": [
"1-3岁",
"爸爸",
"萌娃",
"妈妈",
"家庭",
"夫妻"
],
"fansCount": 103684,
"likeCollectCountInfo": 2757601,
"businessNoteCount": 31,
"totalNoteCount": null,
"recommend": null,
"picturePrice": 13000,
"videoPrice": 18000,
"lowerPrice": 13000,
"userType": 2,
"showPrice": null,
"pictureState": 1,
"videoState": 1,
"isCollect": false,
"cooperateState": 1,
"pictureInCart": false,
"videoInCart": false,
"note": null,
"live": null,
"cps": null,
"noteSign": null,
"liveSign": null,
"goodRecommendPermission": null,
"cpc": null,
"pictureCpcBasePrice": null,
"pictureCpcPerPrice": null,
"pictureCpcEstimateNum": null,
"videoCpcState": 0,
"videoCpcBasePrice": null,
"videoCpcPerPrice": null,
"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": null,
"tradeType": null,
"clickMidNum": 64478,
"clickMidNumMcn": 64478,
"interMidNum": 647,
"fansNum": 103684,
"matchNoteNumber": 0,
"authorityList": null,
"processingAuthorities": null,
"pictureShowState": true,
"videoShowState": true,
"classifyCode": null,
"predictiveExposure": null,
"efficiencyValidUser": 0,
"pictureReadCost": null,
"videoReadCost": null,
"pictureClickMidNum": 0,
"pictureInterMidNum": 0,
"videoClickMidNum": 0,
"videoFinishRate": null,
"videoInterMidNum": 0,
"fans30GrowthRate": null,
"fans30GrowthNum": 0,
"nextPicturePrice": null,
"nextVideoPrice": null,
"fansRiseNum": null,
"fansEngageNum": null,
"overflowNum": null,
"newHighQuality": 0,
"isIndustryRecommend": null,
"picturePriceGtZero": true,
"videoPriceGtZero": true,
"lowActive": false,
"fansActiveIn28dLv": null,
"fansEngageNum30dLv": null,
"hundredLikePercent30": null,
"thousandLikePercent30": null,
"pictureHundredLikePercent30": null,
"pictureThousandLikePercent30": null,
"videoHundredLikePercent30": null,
"videoThousandLikePercent30": null,
"cooperType": 1,
"buyerType": 1,
"promiseImpNum": null,
"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": null,
"seedAndHarcest": null,
"liveImg": null,
"liveId": null,
"liveGMV": null,
"isStar": null,
"top2CategoryList": null,
"hasBuyerAuth": false,
"sellerRealIncomeAmt90d": 0,
"estimatePictureCpm": 0,
"estimatePictureCpmCompare": 0,
"estimateVideoCpm": 0,
"estimateVideoCpmCompare": 0,
"estimatePictureEngageCost": 0,
"estimatePictureEngageCostCompare": 0,
"estimateVideoEngageCost": 0,
"estimateVideoEngageCostCompare": 0,
"inviteReply48hNumRatio": 0,
"recommendReason": null,
"kolHeadLabel": 0,
"accumCoopImpMedinNum30d": 0,
"estimateCpuv30d": 0,
"accumPicCommonImpMedinNum30d": 0,
"accumVideoCommonImpMedinNum30d": 0,
"accumCommonImpMedinNum30d": 0,
"marketTarget": null,
"readMidCoop30": null,
"interMidCoop30": null,
"coopNoteNum30d": 0,
"specialIndustryLimit": null,
"kliveCnt30d": 0,
"avgAgmv90d": 0,
"avgLiveViewerNum": 0,
"algoRecommendReasons": null,
"mengagementNumMcn": 746,
"mengagementNum": 746,
"mcpuvNum30d": 0,
"mEngagementNum": 746,
"mEngagementNumMcn": 746,
"mCpuvNum30d": 0
}
}💡 提示:为简化展示,列表类数据样例仅保留 1-2 条记录,实际返回条数以接口响应为准。
