# 🇨🇳 Xiaohongshu Trends Tracker · 小红书趋势追踪 (`nexgendata/xiaohongshu-trends-tracker`) Actor

Track Xiaohongshu (小红书 / RedNote) trending posts, hashtags & brand mentions across beauty, fashion, food, travel, wellness and tech. Premium China consumer-trend intel for brand marketers, e-commerce ops and market-entry consultants. Nielsen / Kantar / Hootsuite China alternative.

- **URL**: https://apify.com/nexgendata/xiaohongshu-trends-tracker.md
- **Developed by:** [NexGenData](https://apify.com/nexgendata) (community)
- **Categories:** Business, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $150.00 / 1,000 xiaohongshu trending post records

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use 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

## 🇨🇳📕 Xiaohongshu Trends Tracker — RedNote Beauty & Lifestyle

**Track what's actually breaking through to mainland Chinese consumers right now — in real time, with structured fields you can drop straight into a dashboard.**

This actor surfaces trending posts, hashtags and brand mentions from **Xiaohongshu (小红书 / Little Red Book / "RedNote")** — the dominant Chinese super-app for beauty, fashion, lifestyle, food, travel, wellness and consumer-product discovery. If Weibo is China's Twitter and Bilibili is its YouTube, Xiaohongshu is its Instagram + Pinterest + Yelp — and it is where almost every consumer purchase decision in the country starts.

For brand marketers, beauty/fashion e-commerce operators, consumer-trend researchers and China market-entry consultants, Xiaohongshu's trending surface is the single highest-signal source on the planet for "what Chinese consumers actually want this week." This actor extracts that signal as clean JSON, on demand, with no manual scrolling.

---

### Why Xiaohongshu matters for Western brand operators

Xiaohongshu has **300M+ monthly active users**, ~70% female, average age 25, with an unusually high concentration in tier-1/2 mainland cities (Shanghai, Beijing, Shenzhen, Guangzhou, Chengdu). Crucially, the platform's recommendation engine is product-centric: every viral note is, in effect, a product review or a buying guide. That means trending Xiaohongshu content is the closest publicly observable signal to consumer demand — earlier and cleaner than Tmall/JD sales rankings, and far more granular than Nielsen-style panel data.

When **a foreign beauty brand goes viral on Xiaohongshu, mainland import demand spikes within days.** Brand teams who monitor the platform daily — instead of weekly or quarterly — consistently get 2-4 weeks of lead time on competitors. This actor is the data layer that makes daily monitoring tractable without a Mandarin-speaking analyst in Shanghai.

---

### What you get per record

Every trending post returned by the actor includes:

| Field | Type | Description |
|---|---|---|
| `topic` | string | The query keyword or hashtag (Chinese or English) |
| `hashtag` | string | Normalised `#topic` form |
| `category` | string | `beauty` / `fashion` / `food` / `travel` / `wellness` / `tech` / `finance` / `lifestyle` |
| `top_post_title` | string | The leading viral post title for this topic |
| `top_post_url` | string | Canonical `xiaohongshu.com/explore/{id}` deep link |
| `engagement_count` | int | Combined likes + saves + comments (Xiaohongshu's primary virality signal) |
| `growth_24h_pct` | float \| null | 24h growth % when the platform exposes it |
| `top_brands_mentioned` | list | Recognised consumer-brand tokens parsed from the title — 完美日记, Estée Lauder, 瑞幸, Apple, Burberry, Helena, Charlotte Tilbury, Fenty etc. |
| `is_trending` | bool | True when `engagement_count` ≥ 1000 |
| `is_branded_partnership` | bool | True when Xiaohongshu's `品牌合作` / `合作笔记` disclosure tag is present |
| `data_source` | string | Provenance (`xiaohongshu.com/search_result (httpx)` etc.) |
| `as_of_timestamp` | string | UTC ISO-8601 capture time |

If — and only if — every probe strategy is fully blocked by Xiaohongshu's anti-bot wall, the actor emits a single `status: "maintenance"` record explaining the situation and listing the sister actors you can fall back on. Your downstream pipeline never crashes.

---

### How the actor handles Xiaohongshu's anti-bot wall

Xiaohongshu is one of the hardest mainland platforms to scrape reliably. The mobile API requires fully signed requests (x-s / x-t / x-mns tokens derived from a closed-source WASM blob); the web feed is gated behind Cloudflare-style fingerprinting and aggressively serves HTTP 461 or empty payloads to datacenter IPs. This actor uses a multi-strategy waterfall:

1. **httpx + realistic browser headers** against `xiaohongshu.com/search_result?keyword=...` — extracts `window.__INITIAL_STATE__` when the page hydrates server-side.
2. **Playwright headless Chromium with stealth countermeasures** (`navigator.webdriver` patch, zh-CN locale, Asia/Shanghai timezone, realistic viewport, plugin/languages spoofing) — handles JS-rendered hydration.
3. **DOM-level fallback parser** — pulls `/explore/{id}` anchors and inferred titles even when the hydrated state blob is absent or partial.
4. **Maintenance-stub fallback** — graceful single-row response so consumers' pipelines don't break.

All paths run behind Apify's RESIDENTIAL proxy pool by default, with optional CN-egress preference.

---

### Input parameters

- `keywords` — array of Chinese or English search terms (default: `["护肤", "口红", "穿搭"]`).
- `categories` — array of category filters: `beauty`, `fashion`, `food`, `travel`, `wellness`, `tech`, `finance`, `lifestyle`.
- `limit` — max records to return (1-500; default 30).
- `time_window` — `24h` / `7d` / `30d` / `all`.
- `include_branded_partnerships` — `true` to keep disclosed paid posts, `false` for organic UGC only.
- `proxyConfiguration` — Apify proxy (defaults to RESIDENTIAL — strongly recommended).

---

### Pricing

**$0.01 per actor start + $0.15 per trending record.**

This is a **premium tier** ($0.15 vs the $0.05-$0.10 we charge for Weibo / Bilibili). Xiaohongshu data is the most commercially valuable single feed in the Chinese consumer-trend stack, because every post is effectively a purchase intent signal. A typical brand-monitoring run of 30 records costs **$4.51** — a fraction of a single Nielsen China dashboard hour.

| Run profile | Records | Approx cost |
|---|---|---|
| Smoke / health-check | 10 | $1.51 |
| Daily brand monitor | 30 | $4.51 |
| Weekly category sweep | 100 | $15.01 |
| One-off market sizing | 500 | $75.01 |

---

### How buyers actually use this actor

- **Beauty/fashion e-commerce ops** — daily 5-keyword monitor against the brand portfolio + 3 closest competitors. Plug into Slack via webhook for "your brand just appeared on Xiaohongshu's trending feed" alerts.
- **China market-entry consultants** — weekly 200-record sweep across `beauty` + `wellness` + `lifestyle` to identify whitespace categories before a client launch.
- **Consumer-trend researchers** — monthly 500-record archive build, joined against Tmall sales rankings for a 60-day lead/lag analysis.
- **Hedge fund China desks** — track top brand-mention counts as a real-time alt-data feed into consumer-discretionary stock theses.
- **Brand-safety teams** — flag `is_branded_partnership=true` posts that mention your competitors for compliance review.

---

### How this compares to incumbent China consumer-trend tools

| Capability | Xiaohongshu Trends Tracker | Bloomberg China Consumer Pulse | Nielsen China | Kantar Worldpanel | Hootsuite China |
|---|---|---|---|---|---|
| Per-record API access | Yes (pay-per-event) | Terminal subscription only | Annual contract | Annual contract | Seat-based SaaS |
| Latency | Live (≤2 min) | Daily | Monthly panel | Weekly | Daily-ish |
| Cost to first record | $1.51 | $24k+/year/seat | $80k+/year minimum | $50k+/year minimum | $9k+/year |
| Brand-mention extraction | Yes (parsed in record) | No | Manual analyst | Aggregated | Keyword counts only |
| Disclosed-vs-organic split | Yes (`is_branded_partnership`) | No | No | No | No |
| Coverage of Xiaohongshu specifically | Yes (primary source) | Aggregated | Survey-based | Panel-based | Limited |
| Self-serve, no contract | Yes | No | No | No | No |
| Pipeline-friendly JSON | Yes | CSV / terminal | PDF / Tableau | Excel | CSV |

Xiaohongshu Trends Tracker is the only option in the list that gives self-serve API access to the underlying Xiaohongshu trend signal, structured at the post level, with brand-mention parsing built in. The incumbents are useful for board-level narratives; this actor is what you wire into your daily marketing-ops dashboard.

---

### Pair it with the NexGenData China-stack fleet

This actor is one slice of NexGenData's purpose-built Chinese-data fleet on Apify. The other six slices:

- **[Weibo Hot Search Tracker](https://apify.com/nexgendata/weibo-hot-search-tracker)** — China's #1 social-trending barometer (微博热搜榜). Top-50 ranked keywords, heat score, category, 新/热/沸 flags, pinyin + best-effort English translation.
- **[Bilibili Video Search](https://apify.com/nexgendata/bilibili-video-search)** — Chinese long-form video / gaming / education trends — the YouTube of mainland China.
- **[China Trends Tracker](https://apify.com/nexgendata/china-trends-tracker)** — Cross-platform Chinese trend aggregator (Weibo + Douyin + Toutiao).
- **[Chinese ADRs Stock Screener](https://apify.com/nexgendata/chinese-adrs-stock-screener)** — Chinese companies listed on NYSE/NASDAQ via ADR — daily pricing, market cap, sector.
- **[EastMoney China Stock Screener](https://apify.com/nexgendata/eastmoney-china-stock-screener)** — A-share market screener powered by 东方财富.
- **[Finance MCP Server](https://apify.com/nexgendata/finance-mcp-server)** — MCP-protocol bridge for plugging the entire NexGenData finance fleet directly into Claude / ChatGPT / Cursor.

Run the Xiaohongshu Trends Tracker daily for consumer-demand intelligence, then layer the China Trends Tracker for cross-platform validation, then close the loop with EastMoney for the equity read-through on which Chinese consumer-discretionary names are seeing the inflow.

---

### Output sample (truncated, schema-accurate)

```json
[
  {
    "topic": "护肤",
    "hashtag": "#护肤",
    "category": "beauty",
    "top_post_title": "干皮姐妹必囤！这5支精华我闭眼都买",
    "top_post_url": "https://www.xiaohongshu.com/explore/665a2e1c000000001e02b03f",
    "engagement_count": 28400,
    "growth_24h_pct": null,
    "top_brands_mentioned": ["兰蔻", "雅诗兰黛", "Helena"],
    "is_trending": true,
    "is_branded_partnership": false,
    "data_source": "xiaohongshu.com/search_result (httpx)",
    "as_of_timestamp": "2026-05-14T10:42:01Z"
  }
]
````

***

### Operational notes & limits

- **Residential proxy strongly recommended.** Datacenter IPs are blocked within minutes by Xiaohongshu's edge. The actor's default proxy group is `RESIDENTIAL`. If you supply your own proxy, prefer CN-egress.
- **Per-keyword fan-out is capped at 25 keywords per run** to avoid runaway anti-bot retaliation. Split larger sweeps across multiple runs (≤20 keywords each, 5-min gap).
- **Translation is intentionally absent from this actor** — Xiaohongshu titles use heavy slang/emoji and machine translation degrades signal quality. Pair with the Weibo Hot Search Tracker's translation module if you need automated EN summaries.
- **Maintenance fallback is by design.** A `status: "maintenance"` record is the correct response to a temporarily blocked feed; treat it as a "retry in 5-30 min" signal, not an actor failure.

***

### Get the NexGenData fleet (affiliate link)

If you find this actor useful, the entire 80+ actor NexGenData fleet on Apify is available here:

**<https://apify.com/nexgendata>**

# Actor input Schema

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

List of search terms to query against Xiaohongshu's discovery surfaces. Use Chinese characters for native-quality hits (e.g. \['口红', '护肤', '穿搭']) or English fall-backs (e.g. \['lipstick', 'skincare', 'outfit']). Leave empty to pull the default beauty/fashion/lifestyle discovery feed across all categories.

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

Restrict the results to one or more Xiaohongshu category surfaces. Xiaohongshu's discovery tabs cluster posts into: beauty (美妆), fashion (穿搭), food (美食), travel (旅行), wellness (健身/养生), tech (数码) and finance (理财). Choose any subset; empty = all.

## `limit` (type: `integer`):

Maximum number of trending posts/hashtag records to return per run. Each record costs $0.15 (premium tier — niche but high-value Chinese consumer intel). 10-30 is appropriate for daily brand-monitoring; 100+ for one-off market-sizing studies.

## `time_window` (type: `string`):

Recency filter — Xiaohongshu surfaces decay quickly, especially in beauty/fashion. '24h' = last day (default, freshest), '7d' = last week (longer-cycle wellness/travel trends), '30d' = monthly aggregate (best for brand-mention totals), 'all' = no recency filter.

## `include_branded_partnerships` (type: `boolean`):

Xiaohongshu requires creators to tag paid brand collaborations as 品牌合作 ('brand partnership'). Set true to keep them in the dataset (relevant for paid-media benchmarking); false to filter to organic UGC only (relevant for authentic consumer-sentiment work).

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

Apify proxy configuration. RESIDENTIAL is strongly recommended — Xiaohongshu is hosted in mainland China and applies aggressive anti-bot detection on datacenter IPs (returns 403/461 or empty feeds). Residential CN-egress IPs work best; the actor falls back to direct fetch and finally to a maintenance-stub record if all paths are blocked.

## Actor input object example

```json
{
  "keywords": [
    "护肤",
    "口红",
    "穿搭"
  ],
  "categories": [
    "beauty",
    "fashion",
    "lifestyle"
  ],
  "limit": 30,
  "time_window": "24h",
  "include_branded_partnerships": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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": [
        "护肤",
        "口红",
        "穿搭"
    ],
    "categories": [
        "beauty",
        "fashion",
        "lifestyle"
    ],
    "limit": 30,
    "time_window": "24h",
    "include_branded_partnerships": true,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/xiaohongshu-trends-tracker").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": [
        "护肤",
        "口红",
        "穿搭",
    ],
    "categories": [
        "beauty",
        "fashion",
        "lifestyle",
    ],
    "limit": 30,
    "time_window": "24h",
    "include_branded_partnerships": True,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/xiaohongshu-trends-tracker").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 '{
  "keywords": [
    "护肤",
    "口红",
    "穿搭"
  ],
  "categories": [
    "beauty",
    "fashion",
    "lifestyle"
  ],
  "limit": 30,
  "time_window": "24h",
  "include_branded_partnerships": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call nexgendata/xiaohongshu-trends-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nexgendata/xiaohongshu-trends-tracker",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "🇨🇳 Xiaohongshu Trends Tracker · 小红书趋势追踪",
        "description": "Track Xiaohongshu (小红书 / RedNote) trending posts, hashtags & brand mentions across beauty, fashion, food, travel, wellness and tech. Premium China consumer-trend intel for brand marketers, e-commerce ops and market-entry consultants. Nielsen / Kantar / Hootsuite China alternative.",
        "version": "0.0",
        "x-build-id": "zBeD1qFHYjLj0LFeV"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nexgendata~xiaohongshu-trends-tracker/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nexgendata-xiaohongshu-trends-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/nexgendata~xiaohongshu-trends-tracker/runs": {
            "post": {
                "operationId": "runs-sync-nexgendata-xiaohongshu-trends-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/nexgendata~xiaohongshu-trends-tracker/run-sync": {
            "post": {
                "operationId": "run-sync-nexgendata-xiaohongshu-trends-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "keywords": {
                        "title": "Keywords / hashtags to track (Chinese or English)",
                        "type": "array",
                        "description": "List of search terms to query against Xiaohongshu's discovery surfaces. Use Chinese characters for native-quality hits (e.g. ['口红', '护肤', '穿搭']) or English fall-backs (e.g. ['lipstick', 'skincare', 'outfit']). Leave empty to pull the default beauty/fashion/lifestyle discovery feed across all categories.",
                        "default": [
                            "护肤",
                            "口红",
                            "穿搭"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "categories": {
                        "title": "Category filter",
                        "type": "array",
                        "description": "Restrict the results to one or more Xiaohongshu category surfaces. Xiaohongshu's discovery tabs cluster posts into: beauty (美妆), fashion (穿搭), food (美食), travel (旅行), wellness (健身/养生), tech (数码) and finance (理财). Choose any subset; empty = all.",
                        "default": [
                            "beauty",
                            "fashion",
                            "lifestyle"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "limit": {
                        "title": "Limit (max trending records)",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum number of trending posts/hashtag records to return per run. Each record costs $0.15 (premium tier — niche but high-value Chinese consumer intel). 10-30 is appropriate for daily brand-monitoring; 100+ for one-off market-sizing studies.",
                        "default": 30
                    },
                    "time_window": {
                        "title": "Time window (recency filter)",
                        "enum": [
                            "24h",
                            "7d",
                            "30d",
                            "all"
                        ],
                        "type": "string",
                        "description": "Recency filter — Xiaohongshu surfaces decay quickly, especially in beauty/fashion. '24h' = last day (default, freshest), '7d' = last week (longer-cycle wellness/travel trends), '30d' = monthly aggregate (best for brand-mention totals), 'all' = no recency filter.",
                        "default": "24h"
                    },
                    "include_branded_partnerships": {
                        "title": "Include disclosed brand-partnership posts",
                        "type": "boolean",
                        "description": "Xiaohongshu requires creators to tag paid brand collaborations as 品牌合作 ('brand partnership'). Set true to keep them in the dataset (relevant for paid-media benchmarking); false to filter to organic UGC only (relevant for authentic consumer-sentiment work).",
                        "default": true
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify proxy configuration. RESIDENTIAL is strongly recommended — Xiaohongshu is hosted in mainland China and applies aggressive anti-bot detection on datacenter IPs (returns 403/461 or empty feeds). Residential CN-egress IPs work best; the actor falls back to direct fetch and finally to a maintenance-stub record if all paths are blocked.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
