Skip to content

小红书蒲公英创作者资料 API (V1) ​

GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…

获取已知用户ID的小红书蒲公英创作者资料和合作报价信息。用于在活动对接或报价对比之前审查创作者。

请求参数 ​

参数名位置类型必填默认值说明
tokenquerystring是-用户鉴权令牌。
userIdquerystring是-博主的用户ID。

代码示例 ​

bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE'
text
我想使用 JustOneAPI 提供的“创作者资料 (V1)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE
接口地址: BASE_URL + /api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/xiaohongshu-creator-marketplace-pugongying/creator-profile-v1-zh.json

请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- userId (query): 博主的用户ID。 (必填)

返回格式: 请根据实际 Content-Type 安全处理 JSON 或文本响应。

响应处理与错误码:
1. 需通过返回体中的 "code" 字段判断业务结果(code 为 0 表示成功)。
2. 超时建议:建议将请求超时时间设置为 120 秒;如果 120 秒偏长,请至少设置为 60 秒,但可能会有少量请求因超时而未接收到结果。
3. 业务码说明:
   - 0: 成功
   - 100: Token 无效或已失效
   - 301: 采集失败,请重试
   - 302: 超出速率限制
   - 303: 超出每日配额
   - 400: 参数错误
   - 500: 内部服务器错误
   - 600: 权限不足
   - 601: 账户余额不足
   - 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨,多个 TOKEN 仍共享同一个账户余额。

请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。
python
import requests

BASE_URL = "https://api.justoneapi.com"  # 由 OpenAPI servers 提供

url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
    content_type = response.headers.get("content-type", "").lower()
    if "json" in content_type:
        try:
            print(response.json())
        except ValueError:
            print(response.text)
    elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
        print(response.text)
    else:
        with open("response.bin", "wb") as output:
            output.write(response.content)
        print(f"Saved {len(response.content)} bytes to response.bin")
js
const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE";

const response = await fetch(url, {
  method: "GET",
  signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
  const contentType = (response.headers.get("content-type") || "").toLowerCase();
  const mediaType = contentType.split(";", 1)[0].trim();
  const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
  if (textual) {
    const responseText = new TextDecoder().decode(responseBytes);
    let data = responseText;
    if (contentType.includes("json")) {
      try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
    }
    console.log(data);
  } else {
    console.log(`Received ${responseBytes.byteLength} binary bytes`);
  }
}
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
        final String url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE";

        HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
        HttpRequest.Builder builder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .timeout(Duration.ofSeconds(120))
            .method("GET", HttpRequest.BodyPublishers.noBody());

        HttpRequest request = builder.build();

        HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
        System.out.println(response.statusCode());
        String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
        String mediaType = contentType.split(";", 2)[0].trim();
        if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
            System.out.println(new String(response.body(), StandardCharsets.UTF_8));
        } else {
            Files.write(Path.of("response.bin"), response.body());
            System.out.println("Saved " + response.body().length + " bytes to response.bin");
        }
    }
}
go
package main

import (
	"fmt"
	"io"
	"os"
	"strings"
	"net/http"
	"time"
)

const BASE_URL = "https://api.justoneapi.com" // 由 OpenAPI servers 提供

func main() {
	client := &http.Client{Timeout: 120 * time.Second}
	url := BASE_URL + "/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()
	fmt.Println(resp.StatusCode)
	bodyBytes, _ := io.ReadAll(resp.Body)
	contentType := strings.ToLower(resp.Header.Get("Content-Type"))
	mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
	if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
		fmt.Println(string(bodyBytes))
	} else {
		os.WriteFile("response.bin", bodyBytes, 0600)
		fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
	}
}
php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$url = $BASE_URL . '/api/xiaohongshu-pgy/api/solar/cooperator/user/blogger/userId/v1?token=YOUR_API_KEY&userId=VALUE';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
    echo $response;
} else {
    file_put_contents('response.bin', $response);
    echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}

返回字段 ​

业务成功时(code = 0)的主要返回字段。

达人资料6 个字段

data

蒲公英达人资料,包含账号标识、受众计数、内容标签和合作报价。可用信息随达人而异。

字段类型说明
userIdstring查询达人的用户 ID。
redIdstring达人资料中展示的小红书号。
namestring达人展示名称。
headPhotostring达人头像地址。
locationstring达人资料中展示的地区标签,字符串可能为空。
genderstring达人资料中返回的性别值。
受众与互动10 个字段

data

字段类型说明
fansNuminteger本次达人资料中由 fansNum 返回的粉丝数。
fansCountinteger本次达人资料中由 fansCount 返回的粉丝数。
likeCollectCountInfointeger达人资料中显示的点赞与收藏合计数。
fans30GrowthNuminteger接口返回的近 30 天粉丝增长数。
clickMidNuminteger达人资料中返回的点击量中位数。
interMidNuminteger达人资料中返回的互动量中位数。
pictureClickMidNuminteger接口返回的图文笔记点击量中位数。
pictureInterMidNuminteger接口返回的图文笔记互动量中位数。
videoClickMidNuminteger接口返回的视频笔记点击量中位数。
videoInterMidNuminteger接口返回的视频笔记互动量中位数。
标签与分类10 个字段

data

字段类型说明
personalTagsarray | null达人的个人标签,列表可能为空或返回 null。
personalTags[]string一项个人标签。
contentTagsarray | null内容分类及其子分类标签,列表可能为空或返回 null。
contentTags[]object一个内容分类及其子分类标签。
contentTags[].taxonomy1Tagstring一级分类标签。
contentTags[].taxonomy2Tagsarray该一级分类下的二级分类标签。
contentTags[].taxonomy2Tags[]string一项二级分类标签。
featureTagsarray | null达人的特色标签,列表可能为空或返回 null。
featureTags[]string一项特色标签。
tradeTypestring | null接口返回的达人合作行业标签。
合作与报价25 个字段

data

字段类型说明
businessNoteCountinteger达人资料中显示的合作笔记数量。
coopNoteNum30dinteger接口返回的近 30 天合作笔记数量。
picturePriceinteger | null图文合作报价,可返回 null,金额保留平台原始单位。
videoPriceinteger | null视频合作报价,可返回 null,金额保留平台原始单位。
lowerPriceinteger | null达人资料中返回的较低报价,金额保留平台原始单位。
picturePriceGtZeroboolean达人资料是否标记图文报价大于零。
videoPriceGtZeroboolean达人资料是否标记视频报价大于零。
pictureStateinteger | null图文合作的平台状态代码。
videoStateinteger | null视频合作的平台状态代码。
priceStateinteger | null接口返回的平台报价状态代码。
cooperateStateinteger | null接口返回的平台达人合作状态代码。
pictureShowStateboolean | null图文合作选项的展示状态。
videoShowStateboolean | null视频合作选项的展示状态。
pictureInCartboolean | null本次回包中的图文合作选项购物车状态。
videoInCartboolean | null本次回包中的视频合作选项购物车状态。
clothingIndustryPriceobject | null服装行业报价信息,可返回 null。
clothingIndustryPrice.industryIdinteger服装报价信息中的行业标识。
clothingIndustryPrice.picturePriceinteger服装报价信息中的图文金额。
clothingIndustryPrice.pictureStateinteger服装报价信息中的图文状态代码。
clothingIndustryPrice.videoPriceinteger服装报价信息中的视频金额。
clothingIndustryPrice.videoStateinteger服装报价信息中的视频状态代码。
noteSignobject | null笔记签约条目随附的信息,可返回 null。
noteSign.userIdstring笔记签约条目随附的账号 ID。
noteSign.namestring笔记签约条目随附的名称。
inviteReply48hNumRationumber48 小时内回复合作邀约的比例,保留平台原始数值尺度。
曝光与预估13 个字段

data

字段类型说明
accumCoopImpMedinNum30dinteger接口返回的近 30 天合作笔记曝光量中位数。
accumCommonImpMedinNum30dinteger接口返回的近 30 天普通笔记曝光量中位数。
accumPicCommonImpMedinNum30dinteger接口返回的近 30 天普通图文笔记曝光量中位数。
accumVideoCommonImpMedinNum30dinteger接口返回的近 30 天普通视频笔记曝光量中位数。
estimatePictureCpmnumber图文笔记预估 CPM,保留平台原始金额单位。
estimateVideoCpmnumber视频笔记预估 CPM,保留平台原始金额单位。
estimatePictureEngageCostnumber图文笔记预估互动成本,保留平台原始金额单位。
estimateVideoEngageCostnumber视频笔记预估互动成本,保留平台原始金额单位。
estimateCpuv30dnumber接口返回的近 30 天预估 CPUV,金额保留平台原始单位。
forecastReadUvLowerinteger达人资料中返回的预估独立阅读人数下限。
forecastReadUvUpperinteger达人资料中返回的预估独立阅读人数上限。
forecastGroupCoverRateLowernumber预估受众覆盖率下限,保留平台原始数值尺度。
forecastGroupCoverRateUppernumber预估受众覆盖率上限,保留平台原始数值尺度。
直播指标3 个字段

data

字段类型说明
kliveCnt30dinteger接口返回的近 30 天直播场次。
avgAgmv90dnumber接口返回的近 90 天平均直播销售金额指标,保留平台原始金额单位。
avgLiveViewerNumnumber达人资料中返回的平均直播观看人数。
资料状态8 个字段

data

字段类型说明
validinteger平台返回的达人资料有效状态代码。
userTypeinteger平台返回的达人账号类型代码。
homePageDisplayinteger达人资料中返回的主页展示代码。
isCollectboolean本次达人资料回包中的收藏状态。
lowActiveboolean达人是否被标记为低活跃。
currentLevelinteger | null接口返回的达人当前等级代码。
nextLevelinteger | null接口返回的达人下一等级代码。
activityListarray | null达人资料随附的活动列表,可为空或返回 null。

响应示例 ​

正在加载响应示例…