# RedNote KOL Monitor 小红书 (`getascraper/rednote-kol-monitor`) Actor

Monitor public RedNote 小红书 notes and creator pages for new or changed content.

- **URL**: https://apify.com/getascraper/rednote-kol-monitor.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** Social media, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $9.00 / 1,000 kol changes

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 📕 RedNote KOL Monitor: 小红书

<table width="100%">
<tr>
<td style="padding:24px 28px;background:#F5F3FF;border:1px solid #DDD6FE;border-top:4px solid #4F46E5;border-radius:12px">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">Catch public RedNote creator and note changes from a focused watchlist.</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">Monitor current public RedNote 小红书 share links with low-bandwidth checks, then receive structured records when visible content is new or changed.</span>
</td>
</tr>
</table>

<table width="100%">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #DDD6FE;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#3730A3">🎯 Known pages</span><br>
<span style="font-size:12px;color:#57534E">Keep monitoring focused on the public URLs you select</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #DDD6FE;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#3730A3">🔄 Visible changes</span><br>
<span style="font-size:12px;color:#57534E">Receive newly seen or changed records by default</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #DDD6FE;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#3730A3">🧾 Source context</span><br>
<span style="font-size:12px;color:#57534E">Review titles, descriptions, images, and visible text when available</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #DDD6FE;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#3730A3">📏 Bounded runs</span><br>
<span style="font-size:12px;color:#57534E">Control URLs, records, and parallel page checks</span>
</td>
</tr>
</table>

RedNote KOL Monitor helps creator-marketing and research teams revisit known public pages without manually opening the same URLs each day. Run it normally through Apify, use it from the API, or schedule recurring checks; it does not expose a Standby web endpoint.

### 🔎 What does RedNote KOL Monitor do?

RedNote KOL Monitor checks public note and creator links that you provide with a low-bandwidth HTTP-first route. It records public page details when available and compares every page with its previous run.

For reliable access, copy a fresh public link through RedNote’s **Share → Copy link** action. The Actor accepts the resulting `xhslink.com` link or a full RedNote URL containing `xsec_token`.

Use it for creator watchlists, campaign checks, and content research. It is designed for known public URLs, not broad keyword discovery.

### 🎯 Why use it?

- **I am a creator-marketing lead** checking selected campaign participants for newly visible public content.
- **I am a brand researcher** keeping a dated watchlist of public note and creator-page changes.
- **I am an analyst** reviewing titles, descriptions, images, and visible text without filling missing fields with guesses.
- **I am an automation builder** sending change-only records into a recurring review workflow.

### 🧭 How it works

<table width="100%">
<tr>
<td style="padding:16px 14px;width:33%;background:#F5F3FF;border:1px solid #DDD6FE;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#4F46E5;letter-spacing:1px">STEP 1</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Copy a fresh public share link</span><br>
<span style="font-size:12px;color:#57534E">Use RedNote Share → Copy link for the notes or creator pages you want to watch.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#F5F3FF;border:1px solid #DDD6FE;border-left:none;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#4F46E5;letter-spacing:1px">STEP 2</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Create the baseline</span><br>
<span style="font-size:12px;color:#57534E">Run once to save each available public record.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#F5F3FF;border:1px solid #DDD6FE;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#4F46E5;letter-spacing:1px">STEP 3</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Schedule checks</span><br>
<span style="font-size:12px;color:#57534E">Receive new or changed public records on later runs.</span>
</td>
</tr>
</table>

### 🧾 Input

| Field                      | Type          | Required | Description                                                                             |
| -------------------------- | ------------- | -------- | --------------------------------------------------------------------------------------- |
| Public RedNote Share Links | array of URLs | Yes      | Current `xhslink.com` Share links or signed public RedNote URLs with `xsec_token`.      |
| Include Unchanged Records  | boolean       | No       | Return records that did not change since the prior run.                                 |
| Maximum Items              | integer       | No       | Caps the number of URLs checked in one run.                                             |
| Maximum Concurrency        | integer       | No       | Controls how many public pages are checked at once.                                     |
| Proxy Configuration        | object        | No       | Residential proxy is selected by default for reliable public-page checks.               |

### 📊 Data table

| Field         | Type   | Description                                      |
| ------------- | ------ | ------------------------------------------------ |
| source\_url    | string | Public page checked during the run.              |
| record\_type   | string | Whether the URL is treated as a note or profile. |
| change\_type   | string | New, changed, or unchanged.                      |
| title         | string | Public page title when available.                |
| description   | string | Public page description when available.          |
| image\_url     | string | Public page image when available.                |
| content\_text  | string | Public visible text when available.              |
| first\_seen\_at | string | First successful monitoring timestamp.           |
| last\_seen\_at  | string | Most recent monitoring timestamp.                |

The Output tab also includes a non-sensitive run summary with the number of URLs inspected, emitted, unavailable, and failed. Monitoring state is not exposed.

### 💰 Pricing

Pricing is pay per event. Empty change-only runs do not create result charges, and there are no subscriptions.

### ⭐ Enjoying RedNote KOL Monitor: 小红书?

<table width="100%">
<tr>
<td style="padding:20px 24px 14px;background:#F5F3FF;border:1px solid #DDD6FE;border-left:5px solid #4F46E5;border-radius:10px 10px 0 0">
<span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#1C1917">Found a useful creator-page change without reopening every watchlist URL?</span><br>
<span style="font-size:14px;color:#57534E">A 5-star rating takes 10 seconds and helps creator-marketing researchers find this Actor. Your feedback also guides what we build next.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#4F46E5;border:1px solid #DDD6FE;border-top:none;border-radius:0 0 10px 10px;text-align:center">
<a href="https://apify.com/getascraper/rednote-kol-monitor/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a>
</td>
</tr>
</table>

### ❓ FAQ

#### Can I monitor a public RedNote creator page?

Yes. Use a current public Share → Copy link for the creator page and review the returned fields available at run time.

#### Does it return every RedNote post?

No. This first version monitors known public URLs that you supply. It does not promise complete platform coverage.

#### 小红书 KOL 监控可以抓取私密内容吗？

No. The monitor is limited to public pages and fields available during the run.

#### Why did an unchanged URL return no row?

Change-only output is on by default. Enable Include Unchanged Records when you need a full status snapshot.

#### Why did my run fail instead of returning zero rows?

The supplied page was not publicly available from the selected network route, commonly because its share link expired. Copy a fresh public Share → Copy link from RedNote and run again. This prevents unavailable pages from looking like successful empty monitoring runs.

#### Can I call a Standby endpoint?

No. Start a normal Actor run through Apify, the API, or a schedule. This keeps monitoring costs tied to actual checks instead of keeping a server ready between requests.

### 🔗 Other actors

- [🧵 Threads Monitor: Public Post Changes](https://apify.com/getascraper/threads-mention-delta-monitor) ↗ - Track chosen public Threads profiles and posts.
- [🛰️ Telegram Channel Delta Monitor](https://apify.com/getascraper/telegram-channel-delta-monitor) ↗ - Track new and edited public Telegram channel posts.
- [📰 Newsletter Sponsor Intelligence](https://apify.com/getascraper/newsletter-sponsor-intelligence) ↗ - Find reviewable sponsor evidence in public newsletter issues.
- [❓ Quora Q\&A Change Monitor](https://apify.com/getascraper/quora-qna-change-monitor) ↗ - Watch known public Quora questions for visible changes.

# Actor input Schema

## `targetUrls` (type: `array`):

Add a current public Share → Copy link (xhslink.com) or a signed RedNote note or creator URL containing xsec\_token.

## `includeUnchanged` (type: `boolean`):

Return a record even when its public content has not changed since the prior run.

## `maxItems` (type: `integer`):

Maximum number of public URLs to inspect in this run.

## `maxConcurrency` (type: `integer`):

Number of pages to inspect at once. Lower values are more stable for this source.

## `proxyConfiguration` (type: `object`):

Residential proxy is selected by default for reliable checks of public RedNote pages; you can provide your own compatible configuration.

## Actor input object example

```json
{
  "targetUrls": [
    {
      "url": "http://xhslink.com/o/6Ayuq9p9ubU"
    }
  ],
  "includeUnchanged": false,
  "maxItems": 5,
  "maxConcurrency": 1,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `runSummary` (type: `string`):

No description

# 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 = {
    "targetUrls": [
        {
            "url": "http://xhslink.com/o/6Ayuq9p9ubU"
        }
    ],
    "includeUnchanged": false,
    "maxItems": 5,
    "maxConcurrency": 1,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/rednote-kol-monitor").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 = {
    "targetUrls": [{ "url": "http://xhslink.com/o/6Ayuq9p9ubU" }],
    "includeUnchanged": False,
    "maxItems": 5,
    "maxConcurrency": 1,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/rednote-kol-monitor").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "targetUrls": [
    {
      "url": "http://xhslink.com/o/6Ayuq9p9ubU"
    }
  ],
  "includeUnchanged": false,
  "maxItems": 5,
  "maxConcurrency": 1,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call getascraper/rednote-kol-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=getascraper/rednote-kol-monitor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/7XoniNs9qhQY8HL5b/builds/LYvydwdKqCpbPyzCX/openapi.json