跳到主要内容
小红书

xiaohongshu.pgy.bloggers.detail@v1

小红书蒲公英博主详情

蒲公英博主详情

读取博主资料、内容标签、粉丝规模和合作报价。

POST/v1/xiaohongshu/pgy/bloggers/detail

英文名称: Xiaohongshu PGY creator detail · PGY Blogger · Detail
Read a creator's profile, content tags, audience size, and collaboration prices.

适合什么任务

  • 用于投放前的博主尽调与报价核对。

不适合什么任务

  • 不用于读取笔记列表、趋势或粉丝画像。

请求参数

字段user_id类型string约束与默认值pattern: "^[a-f0-9]{24}$"必填性必填
完整请求 JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$"
    }
  },
  "required": [
    "user_id"
  ],
  "additionalProperties": false
}

静态响应样例

application/json
{
  "code": 200,
  "request_id": "req_example_pgy_blogger_detail",
  "message": "success",
  "data": {
    "item": {
      "id": "5c668b3e0000000012021605",
      "name": "Fixture creator",
      "red_id": "fixture_red_id",
      "avatar_url": "https://ci.xiaohongshu.com/avatar-fixture",
      "location": "上海",
      "gender": "女",
      "personal_tags": [
        "生活方式"
      ],
      "content_tags": [
        "美妆",
        "护肤"
      ],
      "feature_tags": [
        "测评"
      ],
      "followers_count": 123456,
      "likes_and_collects_count": 345678,
      "commercial_note_count": 42,
      "pricing_cny": {
        "image": 5200,
        "video": 8800,
        "starting": 5200
      }
    }
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "result_status": "complete",
    "balance_after": "49.61",
    "listing_id": "xiaohongshu.pgy.bloggers.detail",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-17.1",
    "price_book_version": "pricebook-production-2026-09-17.1",
    "charged_amount": "0.39",
    "currency": "CNY"
  }
}

实时运行

完整结果和空结果收费;部分结果和失败不收费。

安全验证

正在加载安全验证…

正在确认实时执行状态…

执行结果

// Result

响应 Contract

字段摘要用于快速浏览;完整 JSON Schema 是稳定输出 Contract。

字段code类型number约束与默认值const: 200必填性必填
字段request_id类型string约束与默认值无额外约束必填性必填
字段message类型string约束与默认值const: "success"必填性必填
字段data类型object约束与默认值无额外约束必填性必填
字段page类型object约束与默认值无额外约束必填性必填
字段warnings类型array约束与默认值无额外约束必填性必填
字段meta类型object约束与默认值无额外约束必填性必填
完整响应 JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "item": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "red_id": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "avatar_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "location": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "gender": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "personal_tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "content_tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "feature_tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "followers_count": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "likes_and_collects_count": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "commercial_note_count": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "pricing_cny": {
                  "type": "object",
                  "properties": {
                    "image": {
                      "anyOf": [
                        {
                          "type": "number",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "video": {
                      "anyOf": [
                        {
                          "type": "number",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "starting": {
                      "anyOf": [
                        {
                          "type": "number",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "image",
                    "video",
                    "starting"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "id",
                "name",
                "red_id",
                "avatar_url",
                "location",
                "gender",
                "personal_tags",
                "content_tags",
                "feature_tags",
                "followers_count",
                "likes_and_collects_count",
                "commercial_note_count",
                "pricing_cny"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "item"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "type": "null"
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "xiaohongshu.pgy.bloggers.detail"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

已知限制

  • 只返回调用时蒲公英数据源可解析的公开商业资料。
  • 报价与粉丝规模是调用时快照,不代表最终成交价。
  • 标签可能为空或随平台调整。

接入示例

REST(cURL)

curl -X POST https://api.dataxapi.com/v1/xiaohongshu/pgy/bloggers/detail \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: your-stable-intent-key" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"5c668b3e0000000012021605"}'

Exact MCP Preview(Codex 配置)

[mcp_servers.dataxapi]
url = "https://api.dataxapi.com/mcp"
bearer_token_env_var = "DATAXAPI_API_KEY"

同一个 API Key 只会暴露其 Scope 内的精确 Tool。请把 Key 放在环境变量中,不要写入配置文件。需要安全重试时,请显式复用 idempotency_key。

查看客户端兼容状态 →

目录发布物: catalog-production-2026-09-17.1 · PriceBook: pricebook-production-2026-09-17.1