Xiaohongshu (RedNote) PGY creator search API

curl -G "https://api.dataxapi.com/v1/xiaohongshu/pgy/creators/search" \
  --data-urlencode "query=咖啡" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

{
  "code": "ok",
  "request_id": "925f8cc7-d891-4f23-8d87-46f8515c35e9",
  "data": {
    "items": [
      {
        "id": "6acd5beb00000000c8b10386",
        "account_id": "6d5583880000000059f95d40",
        "username": "ajie_diy",
        "name": "阿杰爱折腾",
        "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/68d7218800000000a4989fa3.jpg",
        "location": "北京",
        "categories": ["生活"],
        "subcategories": ["咖啡", "家居好物"],
        "metrics": { "followers": 30634 }
      },
      // … 19 more
    ]
  },
  "page": {
    "next_cursor": "c1.tanuG8dT9ozo4D_Rnm44jKf3-2o-wxDT8ESWtMQB",
    "cursor_expires_at": "2026-10-12T22:55:09.000Z",
    "has_more": true,
    "returned": 20
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.pgy.creators.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T21:55:09.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {},
    "billing": {
      "amount": "0.04",
      "currency": "USD",
      "balance_after": "9.96"
    }
  }
}

From a response recorded 2026-10-12 21:55 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

Size as sent: 7.8 KB in the standard view (4.1 KB compact, 10.2 KB full).

{
  "code": "ok",
  "request_id": "088700a7-de0f-4ecd-89ad-ccdc650c2936",
  "data": { "items": [] },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 0
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.pgy.creators.search",
    "result_status": "empty",
    "fetched_at": "2026-10-12T21:55:09.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {},
    "billing": {
      "amount": "0.04",
      "currency": "USD",
      "balance_after": "9.96"
    }
  }
}

From a recording of 2026-10-12 21:55 UTC, edited by hand to show this case. The request ID and balance are made up.

Size as sent: 414 B in the standard view (414 B compact, 414 B full).

curl -G "https://api.dataxapi.com/v1/xiaohongshu/pgy/creators/search" \
  --data-urlencode "query=咖啡" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.xiaohongshu.pgy.creators.search(query="咖啡")
print(result["data"]["items"])

import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.xiaohongshu.pgy.creators.search({ query: "咖啡" });
console.log(result.data.items);

dataxapi call xiaohongshu.pgy.creators.search 'query=咖啡'

{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

Add this to your MCP client, then ask your agent to call xiaohongshu.pgy.creators.search.