FeedMCP

Data APIs / Xiaohongshu (RedNote)

PGY blogger search API

Find Xiaohongshu bloggers on PGY by note content or name: followers, picture and video rates, read and engagement medians, cost per read, video completion and follower growth, 20 a page.

Item Value
Endpoint GET https://api.feedmcp.com/v1/xiaohongshu/pgy/creators/search
ID xiaohongshu.pgy.creators.search
Price $0.04 / call
Returns A page of Creator objects
Auth Authorization: Bearer $FEEDMCP_API_KEY

A PGY blogger ID is the Xiaohongshu user ID, so it works with the Xiaohongshu account and note endpoints. prices are the picture and video note rates in CNY.

Parameters

Name Type Required Description
keyword string yes Keyword
by content / name no content (match their notes) or name; default content
cursor string no Pagination cursor. Leave it out for the first page; pass page.next_cursor for the next. Each page is billed on its own

Every endpoint also takes view=full to include the platform's raw data as raw, at the same price.

Returned fields

data.items is a list of Creator objects, with the same fields on every platform:

Field Type Description
id string The creator's ID on the marketing platform: the Xingtu ID on Douyin, the user ID on Xiaohongshu; every creator endpoint of that platform takes it
platform string Platform: douyin or xiaohongshu
name string | null Name
avatar string | null Avatar
gender 'male' | 'female' | null Gender
location string | null Location
account_id string | null The linked account ID (Douyin sec_user_id or Xiaohongshu user ID) for the account endpoints
handle string | null Douyin handle or RED ID
url string | null Creator page on Xingtu or PGY
mcn string | null Agency (PGY profiles only)
uid string | null Numeric Douyin uid (Xingtu only; the Ocean Engine creator endpoints take it)
tags string[] Content tags
followers number | null Followers
prices {type, price}[] Rates in CNY: 21–60s and 60s+ videos on Xingtu (search results only; use the rates endpoint for all), picture and video notes on PGY
metrics.expected_views number | null Expected views per video
metrics.views_median_30d number | null Median views, last 30 days
metrics.interaction_rate_30d number | null Interaction rate, last 30 days, 0–1
metrics.completion_rate_30d number | null Completion rate, last 30 days, 0–1
metrics.cpm_21_60s number | null Expected CPM for 21–60s videos (CNY)
metrics.star_index number | null Xingtu star index
metrics.read_median number | null PGY: median reads
metrics.engagement_median number | null PGY: median engagements
metrics.picture_read_cost number | null PGY: cost per read, picture notes (CNY)

When you are charged

$0.04 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Each answer carries meta.billing: what this call cost and the balance left.

Request

cURL

curl "https://api.feedmcp.com/v1/xiaohongshu/pgy/creators/search?keyword=%E9%9C%B2%E8%90%A5" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/xiaohongshu/pgy/creators/search",
    params={"keyword": "露营"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/xiaohongshu/pgy/creators/search?keyword=%E9%9C%B2%E8%90%A5", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "xiaohongshu.pgy.creators.search",
  "params": {
    "keyword": "露营"
  },
  "max_price": "0.04"
}

Response

The data below is made up; the shape is the real one.

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "id": "612722f1000000000101d7ec",
        "platform": "xiaohongshu",
        "name": "山野博主1",
        "avatar": "https://sns-avatar-qc.xhscdn.com/a",
        "gender": "female",
        "location": "北京",
        "account_id": "612722f1000000000101d7ec",
        "handle": "aa1j11",
        "url": "https://pgy.xiaohongshu.com/solar/pre-trade/blogger-detail/612722f1000000000101d7ec",
        "tags": [
          "露营徒步",
          "户外爱好者"
        ],
        "followers": 14315,
        "prices": [
          {
            "type": "图文笔记",
            "price": 3500
          },
          {
            "type": "视频笔记",
            "price": 6000
          }
        ],
        "metrics": {
          "likes_and_saves": null,
          "sponsored_notes": null,
          "read_median": 2517,
          "engagement_median": 158,
          "picture_read_cost": 1.44,
          "video_read_cost": null,
          "video_completion_rate": 0.062,
          "followers_growth_rate_30d": 0.046,
          "active_followers_rate": null
        }
      },
      {
        "id": "612722f1000000000102d7ec",
        "platform": "xiaohongshu",
        "name": "山野博主2",
        "avatar": "https://sns-avatar-qc.xhscdn.com/a",
        "gender": "female",
        "location": "北京",
        "account_id": "612722f1000000000102d7ec",
        "handle": "aa1j12",
        "url": "https://pgy.xiaohongshu.com/solar/pre-trade/blogger-detail/612722f1000000000102d7ec",
        "tags": [
          "露营徒步",
          "户外爱好者"
        ],
        "followers": 14315,
        "prices": [
          {
            "type": "图文笔记",
            "price": 3500
          },
          {
            "type": "视频笔记",
            "price": 6000
          }
        ],
        "metrics": {
          "likes_and_saves": null,
          "sponsored_notes": null,
          "read_median": 2517,
          "engagement_median": 158,
          "picture_read_cost": 1.44,
          "video_read_cost": null,
          "video_completion_rate": 0.062,
          "followers_growth_rate_30d": 0.046,
          "active_followers_rate": null
        }
      }
    ]
  },
  "page": {
    "next_cursor": "eyJjdXJzb3IiOjIwfQ",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "endpoint": "xiaohongshu.pgy.creators.search",
    "platform": "xiaohongshu",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.04",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

Errors are described in Errors: each says whether you were charged (charged) and whether to retry (retry).

Other Xiaohongshu (RedNote) endpoints

Questions

How much does the PGY blogger search endpoint cost?

$0.04 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Do I need a platform account?

No. Only public data is read.

A note ID is the part after /explore/ in a note link; a share link (xhslink.com) works too.

How do I get more items?

When the answer has page.next_cursor, pass it back as cursor for the next page. Each page is billed on its own.

How do I use it from an AI?

Install the MCP server and ask; your AI calls xiaohongshu.pgy.creators.search.