# Xiaohongshu Influencer Finder - RedNote 蒲公英 Rates & Audience (`seemuapps/xiaohongshu-influencer-finder`) Actor

Find Xiaohongshu (RedNote) influencers on Pugongying with official post rates, median reads and engagement, CPM, follower growth and audience demographics.

- **URL**: https://apify.com/seemuapps/xiaohongshu-influencer-finder.md
- **Developed by:** [Seemu Scraping](https://apify.com/seemuapps) (community)
- **Stats:** 2 total users, 1 monthly users, 80.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.00 / 1,000 creators

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Xiaohongshu Influencer Finder - RedNote 蒲公英 Rates & Audience

Find Xiaohongshu (小红书, RedNote) influencers on Pugongying (蒲公英), RedNote's official creator marketplace. Each result includes the creator's official sponsored post rates, median reads and engagement, CPM and cost-per-engagement estimates, follower growth, live-stream sales and recent notes. Search by topic or nickname, find creators similar to a creator you already like, and filter by category, location, followers, price and audience. Optionally add follower demographics. No Pugongying account needed.

### What you get

One row per creator:

- **Profile**: nickname, RedNote ID, profile link, avatar, gender, location, categories and content tags
- **Official rates**: price for one sponsored picture note and one video note, in CNY
- **Performance (last 30 days)**: median impressions, reads and engagement (overall, picture and video), video completion rate, share of notes with 100+ and 1,000+ likes
- **Ad cost estimates**: estimated CPM, cost per read and cost per engagement for picture and video notes
- **Sponsored content**: median reads and engagement on sponsored notes, sponsored note count, recent brand industries, brand invite reply rate within 48h
- **Audience health**: follower growth, active and engaged follower share
- **Live commerce**: live streams in the last 30 days, average viewers and GMV per stream
- **Recent notes**: note links, covers and type
- **Audience demographics (optional)**: follower gender, age, interests, top provinces, top cities and phone brands

### Ways to search

| Input | What it does |
|---|---|
| Search keywords | Creators whose notes match a topic (护肤, 露营, 咖啡…), or creator nicknames |
| Find creators similar to | Paste a RedNote profile link and get similar creators, still filtered by everything below |
| Filters only | Leave keywords empty and browse by category, location and follower range |

Filters: creator category, location, follower range, creator gender, price range (picture or video rate), main content format, audience gender and age, exclude inactive creators, exclude creators losing followers. Sort by best match, followers, price, median engagement, median reads, 1,000-like note rate, follower growth, video completion or reply rate.

### Use cases

- **Influencer marketing in China**: build a shortlist of RedNote creators within budget for a campaign
- **Rate benchmarking**: compare official sponsored post prices across a category
- **Lookalike creator discovery**: start from a creator who performed well and find similar ones
- **Agency and MCN research**: map creators by category, city and audience
- **Live commerce sourcing**: find creators who sell through live streams, with GMV per stream

### How to use

1. Enter **Search keywords**, a creator to **Find creators similar to**, or just set some filters
2. Add filters like **Min followers**, **Max price (CNY)** or **Creator categories**
3. Turn on **Include audience demographics** if you need follower breakdowns
4. Run the actor and export the results from the **Dataset** tab as JSON, CSV or Excel

### Pricing

Each creator is one `creator` event. Each search (keyword, similar-creator search or filter browse) also adds one `search` event, charged with its first creator. With **Include audience demographics** on, each creator also adds one `audience-details` event. Searches with no matches are free.

### Output example

```json
{
  "userId": "6404b05d000000001001f1de",
  "nickname": "Tayler wu",
  "redId": "2266619769",
  "profileUrl": "https://www.xiaohongshu.com/user/profile/6404b05d000000001001f1de",
  "followers": 149428,
  "gender": "male",
  "location": "四川 成都 双流区",
  "categories": ["出行旅游/旅行", "出行旅游/户外", "运动健身/跑步"],
  "contentTags": ["露营徒步", "ootd"],
  "recentBrandIndustries": ["3c及电器", "汽车", "食品饮料", "服装配饰"],
  "pricePictureNoteCny": 14000,
  "priceVideoNoteCny": 26000,
  "medianImpressions30d": 179833,
  "medianReads30d": 12177,
  "medianEngagements30d": 1838,
  "thousandLikeNoteRatePercent": 80,
  "followerGrowth30dPercent": -0.4,
  "estimatedCpmPictureCny": 164.67,
  "estimatedCpmVideoCny": 145.63,
  "estimatedCostPerEngagementVideoCny": 14.75,
  "sponsoredMedianReads30d": 3796,
  "sponsoredNotesTotal": 243,
  "inviteReplyRate48hPercent": 96.6,
  "recentNotes": [
    { "noteId": "6ac8bc21000000001500ceff", "url": "https://www.xiaohongshu.com/explore/6ac8bc21000000001500ceff", "type": "video", "coverUrl": "https://ci.xiaohongshu.com/…" }
  ],
  "audienceGender": [{ "name": "female", "percent": 36.3 }, { "name": "male", "percent": 63.7 }],
  "audienceAge": [{ "name": "18-24", "percent": 25.3 }, { "name": "25-34", "percent": 48.1 }],
  "searchQuery": "露营",
  "rank": 1
}
```

### FAQ

**Which creators are included?** Creators listed on Pugongying, RedNote's official brand partnership marketplace. These creators accept paid collaborations and have official rates.

**Why did a filter return no creators?** Category and location names must match Pugongying's Chinese names exactly (e.g. `上海`, `美妆`, `面部保养`). A misspelled value matches nothing.

**Are the prices in US dollars?** No. All prices and cost estimates are in Chinese yuan (CNY).

# Actor input Schema

## `keywords` (type: `array`):

Topics to find creators for (e.g. 护肤 skincare, 露营 camping, 咖啡 coffee), or creator nicknames when Search by is set to Nickname. Each keyword is a separate search.

## `searchBy` (type: `string`):

Content finds creators whose notes match the keyword. Nickname looks the keyword up as a creator name.

## `similarToProfiles` (type: `array`):

RedNote profile links (xiaohongshu.com/user/profile/…) or user IDs. Returns creators similar to each one, combined with the filters below. Each profile is a separate search.

## `categories` (type: `array`):

Only creators in these Pugongying categories, in Chinese, e.g. 美妆, 护肤, 母婴, 时尚, 美食, 家居家装, 运动健身, 宠物, 出行旅游, 科技数码, 汽车, 教育, 职场. Subcategories like 面部保养 also work. Names must match exactly.

## `locations` (type: `array`):

Only creators based in these provinces or cities, in Chinese, e.g. 上海, 杭州, 广东.

## `minFollowers` (type: `integer`):

Only creators with at least this many followers.

## `maxFollowers` (type: `integer`):

Only creators with at most this many followers.

## `gender` (type: `string`):

Only creators of this gender.

## `priceFormat` (type: `string`):

Which official rate the min and max price filters check.

## `minPriceCny` (type: `integer`):

Only creators whose official rate for one sponsored note is at least this much, in Chinese yuan.

## `maxPriceCny` (type: `integer`):

Only creators whose official rate for one sponsored note is at most this much, in Chinese yuan.

## `noteType` (type: `string`):

Only creators who mostly post picture notes or mostly post videos.

## `audienceGender` (type: `string`):

Only creators whose followers are mostly this gender.

## `audienceAge` (type: `string`):

Only creators whose followers are mostly in this age group.

## `excludeInactive` (type: `boolean`):

Skip creators Pugongying flags as low-activity.

## `excludeLosingFollowers` (type: `boolean`):

Skip creators whose follower count is falling.

## `sortBy` (type: `string`):

How results are ordered (highest first).

## `maxCreatorsPerSearch` (type: `integer`):

How many creators to collect for each keyword or similar-creator search.

## `includeAudience` (type: `boolean`):

Also get each creator's follower breakdown by gender, age, interests, province, city and phone brand. Charged as an extra audience-details event per creator.

## Actor input object example

```json
{
  "keywords": [
    "护肤"
  ],
  "searchBy": "content",
  "gender": "any",
  "priceFormat": "video",
  "noteType": "any",
  "audienceGender": "any",
  "audienceAge": "any",
  "excludeInactive": false,
  "excludeLosingFollowers": false,
  "sortBy": "relevance",
  "maxCreatorsPerSearch": 50,
  "includeAudience": false
}
```

# Actor output Schema

## `results` (type: `string`):

One row per creator: profile link, followers, location, categories, official picture and video note rates, median impressions, reads and engagement, CPM and cost-per-engagement estimates, follower growth, live-stream stats and recent notes. Optional follower demographics.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "护肤"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("seemuapps/xiaohongshu-influencer-finder").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": ["护肤"] }

# Run the Actor and wait for it to finish
run = client.actor("seemuapps/xiaohongshu-influencer-finder").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "护肤"
  ]
}' |
apify call seemuapps/xiaohongshu-influencer-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,seemuapps/xiaohongshu-influencer-finder"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/eEpNuO8pvBJ84qFqX/builds/CYSwOaFxPqKN8TLpQ/openapi.json