# Xiaohongshu KOL Finder & Influencer Analytics (Pugongying) (`zen-studio/rednote-kol-finder`) Actor Find and vet Xiaohongshu (RedNote) creators on the Pugongying (蒲公英) marketplace: rate cards, follower counts, read and engagement medians, CPM and cost estimates, audience age, gender and cities, follower growth and sponsored posts. Search by keyword and filters, analyse a list or find lookalikes. - **URL**: https://apify.com/zen-studio/rednote-kol-finder.md - **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community) - **Categories:** Social media, Marketing - **Features:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 87.5% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.99 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 [![Find RedNote creators. See what they charge. Post prices, audience profiles and 30-day performance.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/rednote-kol-refresh-52d26c0808e1.png)](https://console.apify.com/actors/hIHbRRUR3UsigTH9D/input) From **Zen Studio**, creators of [RedNote Search](https://apify.com/zen-studio/rednote-search-scraper), [RedNote User Profiles](https://apify.com/zen-studio/rednote-user-profile-scraper) and [Douyin KOL Rankings](https://apify.com/zen-studio/douyin-xingtu-rankings-scraper). **100,000+ combined lifetime runs** across those two RedNote actors. ### Find creators that fit your campaign - **Compare their post prices.** Get listed image-post and video rates in CNY, with 30-day read and engagement medians and cost estimates where available. - **Check the audience.** Filter by topic, budget, followers and audience. Add audience profiles to compare age, gender, cities and interests. - **Build your shortlist.** Search for creators, analyse profile links you already have, or find creators similar to one you like. Add performance, trends or sponsored posts when you need more detail. Find RedNote creators #### Try a search within your budget Open the [input page](https://console.apify.com/actors/hIHbRRUR3UsigTH9D/input), switch to JSON and paste: ```json { "mode": "search", "keywords": [ "露营" ], "maxResults": 3, "maxImagePostRate": 5000, "includeAudience": true } ``` This searches for camping creators with listed image-post prices up to CNY 5,000 and requests audience profiles. Replace `露营` with your own topic. Chinese keywords usually work best, for example `咖啡` (coffee) or `护肤` (skincare). Creator results and audience profiles are billed separately. Performance, trends and posts also carry separate charges when enabled and delivered; see [Pricing](#pricing). **Apify Free plan:** 2 preview runs, each with up to 3 creators and extra sections for the first creator. Coverage is limited to creators listed on the Pugongying (蒲公英) marketplace. The image shows saved creator data: prices are listed CNY rates, post metrics are historical medians, and the audience profile is an optional section. Values change over time.
Zen Studio creator research
  KOL Finder
➤ You are here   RedNote Search
Posts & creators   RedNote Profiles
Profiles & posts   Douyin KOLs
Rankings & rates
#### Copy to your AI assistant ``` Help me use zen-studio/rednote-kol-finder on Apify. Read https://apify.com/zen-studio/rednote-kol-finder.md for the documentation, input schema, pricing and limits, then choose settings for the outcome I describe; if you cannot open that page, ask me to paste the relevant sections. Pick mode first: "search" uses keywords and filters, "creators" analyses a list of profile links or RedNote IDs and ignores the filters, "similar" uses similarTo plus the filters. includeAudience, includePerformance, includeTrends and postsToInclude each add a separate per-creator or per-post charge, so enable only the sections I need; Chinese keywords and Chinese category or location names match far more creators. To reach the maintainers, add feedback="" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note. ``` ### How to find Xiaohongshu KOLs The actor has three modes. All of them return the same row: one creator per row. #### Find creators by keyword and filters Keywords match what creators post about. Chinese keywords match far more creators than English ones. Leave `keywords` empty to browse by filters alone. ```json { "mode": "search", "keywords": ["咖啡", "手冲"], "maxResults": 100, "categories": ["美食"], "minFollowers": 20000, "maxFollowers": 300000, "maxImagePostRate": 5000, "minEngagementMedian": 300, "creatorLocations": ["上海"], "sortBy": "pictureReadCost", "sortOrder": "asc" } ``` Each keyword is a separate search with its own `maxResults`; a creator found by both keywords is returned and billed once. #### Analyse creators you already have Paste profile links, Pugongying links, user IDs, RedNote IDs (小红书号) or share links. Only creators listed on the Pugongying marketplace can be analysed; anyone else is reported as not found and billed as one lookup ($0.03). A share link that leads to no creator is not billed. ```json { "mode": "creators", "creators": [ "https://www.xiaohongshu.com/user/profile/62d6ce2e000000000200303f", "alessoyoko", "https://pgy.xiaohongshu.com/solar/pre-trade/blogger-detail/65c381340000000011014d37" ], "includePerformance": true, "postsToInclude": "sponsored", "maxNotesPerCreator": 8 } ``` Rows from this mode also carry the creator's total likes and saves (`likes_and_saves`). In the rare case the creator's 30-day figures cannot be matched, those columns are empty (null) rather than zero. #### Find creators similar to one you like ```json { "mode": "similar", "similarTo": "alessoyoko", "maxResults": 50, "minFollowers": 50000, "maxVideoRate": 20000 } ``` The filters narrow the lookalikes, so you can ask for "creators like this one, in my budget". ### Input parameters | Parameter | Type | Default | Meaning | |---|---|---|---| | `mode` | string | `search` | `search`, `creators` or `similar` | | `keywords` | array | | Search terms (search mode). Empty browses by filters | | `searchIn` | string | `posts` | Match keywords against post content or `nickname` | | `creators` | array | | Creators to analyse (creators mode) | | `similarTo` | string | | One benchmark creator (similar mode) | | `maxResults` | integer | `50` | Creators per keyword or similar search, up to 5,000. `0` means as many as available | | `sortBy`, `sortOrder` | string | best match, `desc` | 34 sort options: followers, rates, medians, cost per read, reply rate, follower growth, live sales and more | | `categories` | array | | Any of the 28 top-level creator categories | | `minFollowers`, `maxFollowers` | integer | | Follower range | | `minImagePostRate` … `maxVideoRate` | integer | | Rate ranges in CNY per image or video post | | `minReadMedian`, `maxReadMedian`, `minEngagementMedian`, `maxEngagementMedian` | integer | | 30-day medians of organic posts | | `contentFormat`, `creatorGender`, `creatorType`, `creatorLocations` | | any | Mostly image or video; creator gender; independent or agency-signed; location in Chinese (`上海`, `杭州`) | | `audienceGender`, `audienceAge`, `audienceLocations` | | any | The audience's main gender, main age band and locations | | `minReplyRate48h` | integer | | Minimum share of brand invitations answered within 48 hours | | `highQualityOnly`, `risingCreatorsOnly`, `excludeInactive`, `excludeLosingFollowers` | boolean | off | Marketplace quality flags | | `includeAudience`, `includePerformance`, `includeTrends` | boolean | off | Extra sections, billed per creator | | `postsToInclude`, `maxNotesPerCreator` | string, integer | `none`, `8` | `recent` or `sponsored` posts, billed per post | | `advancedFilters` | object | | Any other marketplace filter, merged over the ones above | Filters apply to the search and similar modes. The Input tab explains every field. #### Advanced filters `advancedFilters` reaches the rest of the marketplace's filter set: personas, top-20 audience crowds, industry, recent brands, live-commerce metrics, campaign codes, estimated CPM and more. Top-level keys are filter groups: `goal`, `blogger`, `fans`, `note`, `coop`, `live`, `flags`. Ranges are written as `{"min": 1000, "max": 5000}`; percentages as points (`20` means 20%). ```json { "mode": "search", "keywords": ["母婴"], "advancedFilters": { "blogger": {"personal_tags": ["妈妈"]}, "coop": {"pic_cpm": {"max": 80}}, "live": {"live_count": {"min": 1}}, "flags": {"exclude_cooperated": true} } } ``` An unknown field name fails the run before anything is billed. A misspelled value, such as a category name with an extra character, is accepted by the marketplace but matches nothing, so check the spelling when a search returns no creators. ### What data do you get for each creator? **Every row** (no extra charge): - **Identity:** user ID, RedNote ID, nickname, profile and Pugongying links, avatar, gender, location - **Reach:** followers, 30-day impression, read and engagement medians for organic and sponsored posts, share of posts over 100 and 1,000 likes, video completion rate, follower growth - **Rate card and costs:** image-post and video rates in CNY, lowest rate, estimated CPM, cost per read and cost per engagement for image and video, 48-hour reply rate, number of sponsored posts - **Content:** categories (Chinese plus English labels), content tags, industries of recent brand deals - **Live commerce:** live sessions in the last 30 days, average viewers and average sales per session - **`kol`:** the complete Pugongying creator record, 147 fields, for anything the flat columns do not cover - **`source`:** how the creator was found (mode, keyword, page, rank, number of matches) **Optional sections:** - **`audience`** (`includeAudience`): age bands, gender split, top provinces and cities, phone brands, interests, plus active, engaged, reading and paying follower shares with peer percentiles - **`performance`** (`includePerformance`): impression, read, like, save, comment and share medians with peer percentiles, engagement rate, traffic sources (feed, search, follow), organic versus sponsored long-term results, recent posts' metrics, CPM and cost estimates, active days in the last week and invitation counts - **`trends`** (`includeTrends`): 30 daily follower counts, 30 days of impressions, reads, engagements, CPM and CPE - **`posts`** (`postsToInclude`): post link, title, cover, date, reads, likes, saves, off-site readers, and for sponsored posts the brand A section the marketplace has no data for (posts included), or that your spending limit no longer covers, is listed in `unavailable_sections` and is not billed. #### Output example An excerpt of one row from a real run (keyword `露营`). The `kol`, `performance` and `trends` objects are left out for length; the audience lists and the posts are shortened to their first entries. ```json { "user_id": "5c4a9e4100000000100031b3", "red_id": "NGSS618127957", "nickname": "年糕和岁岁", "profile_url": "https://www.xiaohongshu.com/user/profile/5c4a9e4100000000100031b3", "pugongying_url": "https://pgy.xiaohongshu.com/solar/pre-trade/blogger-detail/5c4a9e4100000000100031b3", "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31g1152sm0i005n2ajp0k0cdj2kkd1q8?imageView2/2/w/120/format/jpg", "gender": "女", "location": "重庆", "followers": 13553, "likes_and_saves": null, "content_categories": ["母婴"], "content_categories_en": ["Parenting & baby"], "feature_tags": ["露营徒步"], "recent_brand_industries": ["3c及电器", "日用百货", "母婴", "汽车", "食品饮料", "家居建材", "服装配饰", "交通工具", "文体娱乐", "互联网"], "image_post_rate_cny": 2300.0, "video_rate_cny": 3600.0, "lowest_rate_cny": 2300.0, "read_median": 3742, "engagement_median": 496, "impression_median_30d": 45915, "sponsored_read_median_30d": 4725, "sponsored_engagement_median_30d": 484, "sponsored_impression_median_30d": 43055, "follower_growth_30d_pct": 0.2, "active_follower_pct": 27.7, "engaged_follower_pct": 3.8, "posts_over_100_likes_pct": 100.0, "posts_over_1000_likes_pct": 0.0, "video_completion_rate_pct": 0.0, "est_image_cpm_cny": 53.6, "est_video_cpm_cny": 0.0, "est_image_cost_per_read_cny": 0.88, "est_video_cost_per_read_cny": 0.0, "est_image_cost_per_engagement_cny": 4.37, "est_video_cost_per_engagement_cny": 0.0, "invite_reply_rate_48h_pct": 87.6, "sponsored_posts": 131, "live_sessions_30d": 0, "avg_live_viewers_90d": 0.0, "avg_live_sales_90d_cny": 0.0, "source": {"mode": "search", "query": "露营", "page": 1, "rank": 1, "matches": 2380}, "scraped_at": "2026-10-31T08:39:24.681713Z", "audience": { "summary": { "fansNum": 13553, "fansIncreaseNum": 25, "fansGrowthRate": "0.2", "fansGrowthBeyondRate": "74.6", "activeFansL28": 3754, "activeFansRate": "27.7", "activeFansBeyondRate": "29.9", "engageFansRate": "3.8", "engageFansL30": 516, "engageFansBeyondRate": "96.2", "readFansIn30": 796, "readFansRate": "5.9", "readFansBeyondRate": "85.9", "payFansUserRate30d": "5.1", "payFansUserNum30d": 690 }, "profile": { "ages": [{"group": "<18", "percent": 0.01557115507338864}], "gender": {"male": 0.12852584556477345, "female": 0.8714741544352266}, "interests": [{"name": "美食", "percent": 0.11057146103158373}], "provinces": [{"name": "浙江", "percent": 0.15472210614291684}], "cities": [{"name": "宁波", "percent": 0.11909736732135395}], "devices": [{"name": "apple inc.", "desc": "苹果", "percent": 0.4918410041841004}], "dateKey": "2026-10-30" } }, "posts": [ { "note_url": "https://www.xiaohongshu.com/explore/6ae436da000000000e02723c", "readNum": 9, "likeNum": 0, "collectNum": 0, "isAdvertise": false, "isVideo": false, "noteId": "6ae436da000000000e02723c", "imgUrl": "http://ci.xiaohongshu.com/1040g008326uhs8qml0005n2ajp0k0cdjkb8hbg8?imageView2/2/w/540/format/jpg/q/75", "title": "逛了趟超市，家里不爱吃饭的娃有救了！", "brandName": "轻上牛牛", "date": "2026-10-30", "thirdReadUserNum": 0 } ], "unavailable_sections": [] } ``` Percent fields ending in `_pct` are percentage points (`87.6` means 87.6%); the audience `percent` values are shares (`0.87` means 87%). Rates and cost estimates are in CNY as listed on the marketplace. `likes_and_saves` is filled in the creators mode. Export as JSON to keep the nested sections; CSV and Excel flatten them into columns. ### Pricing Pay per event: you pay for the creators and sections you receive, and for each creator you list that turns out not to be on the marketplace. Sections without data are not billed. | Event | When charged | Price | |---|---|---| | Creator | Each creator row in the search and similar modes | $7.99 per 1,000 | | Creator profile | Each creator row in the creators mode | $0.0799 | | Audience profile | Each creator that receives the `audience` section | $0.0799 | | Content performance | Each creator that receives the `performance` section | $0.0799 | | 30-day trend | Each creator that receives the `trends` section | $0.0799 | | Post | Each post in `posts` | $0.00499 | | Creator not found | Each creator you list in the creators mode that is not on the marketplace | $0.03 | Prices above are for the Apify Free plan. Creators cost $7.49 per 1,000 on Bronze, $6.99 on Silver and $5.99 on Gold and above; creator profiles cost $0.0749 on Bronze, $0.0699 on Silver and $0.0649 on Gold and above. Examples on the Free plan: 100 creators from a keyword search cost $0.80. The same 100 with audience profiles cost $8.79. Analysing 10 creators you already have, with their audience and 8 sponsored posts each, costs 10 × ($0.0799 + $0.0799 + 8 × $0.00499) = $2.00. Set a maximum cost per run in the run options. When the remaining budget no longer covers a section, later creators come without it (named in `unavailable_sections`); when it no longer covers a creator, the run stops. Nothing is billed that is not delivered. ### FAQ **Which creators can I find?** Creators listed on Pugongying (蒲公英), Xiaohongshu's official creator marketplace for brand deals. Everyday accounts that are not on the marketplace have no rate card or audience data and are reported as not found. **Are the rates real prices?** They are the rates creators list on the marketplace for one image-and-text post and one video post, in CNY. Final deals can differ. **Why does my search return no creators?** Usually a filter value matches nothing: a category or location spelled differently from the marketplace (use bare names such as `上海`, not `上海市`), or a combination of filters no creator meets. Remove filters one at a time to find the one that empties the list. **Can I search in English?** Yes, but most creators post in Chinese, so `露营` finds far more camping creators than `camping`. **How fresh is the data?** Each run reads the marketplace live. Medians and rates cover the last 30 days; trends cover the last 30 days, day by day. **What do I get on the free plan?** 2 preview runs, each returning up to 3 creators from the first keyword (or the first creator you list), with the extra sections for the first creator. **Can I schedule it?** Yes. Save the input as a task and schedule it, for example weekly, to track rates and follower growth of a shortlist. ### More Zen Studio scrapers for Chinese platforms **🎬 Short-video & social** - Douban 豆瓣 scraper icon **Douban 豆瓣** - [Douban Scraper](https://apify.com/zen-studio/douban-scraper) - [Douban Reviews Scraper](https://apify.com/zen-studio/douban-reviews-scraper) - [Douban Group Scraper](https://apify.com/zen-studio/douban-group-scraper) - Zhihu 知乎 scraper **Zhihu 知乎** - [Zhihu Scraper](https://apify.com/zen-studio/zhihu-scraper) - **Weibo 微博** - [Weibo Search Scraper](https://apify.com/zen-studio/weibo-search-scraper) - [Weibo Comments Scraper](https://apify.com/zen-studio/weibo-comments-scraper) - Sogou Baike 搜狗百科 scraper icon **Sogou Baike 搜狗百科** - [Sogou Baike Scraper](https://apify.com/zen-studio/sogou-baike-scraper) - **Kwai (Brazil)** - [Kwai Search Scraper](https://apify.com/zen-studio/kwai-search-scraper) - [Kwai Comments Scraper](https://apify.com/zen-studio/kwai-comments-scraper) - **RedNote 小红书** - [RedNote User Profile Scraper](https://apify.com/zen-studio/rednote-user-profile-scraper) - [RedNote Search Scraper](https://apify.com/zen-studio/rednote-search-scraper) - [RedNote Comments Scraper](https://apify.com/zen-studio/rednote-comments-scraper) - [RedNote Product Search Scraper](https://apify.com/zen-studio/rednote-product-search-scraper) - [RedNote Product Reviews Scraper](https://apify.com/zen-studio/rednote-product-reviews-scraper) - [RedNote Live Recorder](https://apify.com/zen-studio/rednote-live-recorder) - [RedNote Product Detail Scraper](https://apify.com/zen-studio/rednote-product-detail-scraper) - [RedNote Note Detail Scraper](https://apify.com/zen-studio/rednote-note-detail-scraper) - **Douyin 抖音** - [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper) - [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper) - [Douyin Video Scraper](https://apify.com/zen-studio/douyin-video-scraper) - [Douyin Comments Scraper](https://apify.com/zen-studio/douyin-comments-scraper) - [Douyin Transcripts Scraper](https://apify.com/zen-studio/douyin-transcripts-scraper) - [Douyin Creator Rankings Scraper](https://apify.com/zen-studio/douyin-xingtu-rankings-scraper) - [Douyin Live Recorder](https://apify.com/zen-studio/douyin-live-recorder) - [Douyin Hot Search Scraper](https://apify.com/zen-studio/douyin-hot-search-scraper) - [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper) - TikTok scraper icon **TikTok** - [TikTok Lookalike Search](https://apify.com/zen-studio/tiktok-lookalike-search) - **Xigua 西瓜视频** - [Xigua Video Search Scraper](https://apify.com/zen-studio/xigua-video-search-scraper) - [Xigua Video Detail Scraper](https://apify.com/zen-studio/xigua-video-detail-scraper) - **Bilibili 哔哩哔哩** - [Bilibili Video Scraper](https://apify.com/zen-studio/bilibili-video-scraper) - [Bilibili Danmaku Scraper](https://apify.com/zen-studio/bilibili-danmaku-scraper) **🛒 E-commerce** - TikTok Shop scraper icon **TikTok Shop** - [TikTok Shop Review Scraper](https://apify.com/zen-studio/tiktok-shop-review-scraper) - **Naver Search 네이버 검색** - [Naver Search Scraper](https://apify.com/zen-studio/naver-search-scraper) - **Shopee** - [Shopee Product Detail Scraper](https://apify.com/zen-studio/shopee-product-detail-scraper) - [Shopee Product Reviews Scraper](https://apify.com/zen-studio/shopee-product-reviews-scraper) - [Shopee Product Scraper](https://apify.com/zen-studio/shopee-product-scraper) - [Shopee Live Scraper](https://apify.com/zen-studio/shopee-live-scraper) - **Taobao 淘宝** - [Taobao Search Scraper](https://apify.com/zen-studio/taobao-search-scraper) - [Taobao Product Detail Scraper](https://apify.com/zen-studio/taobao-detail-scraper) - [Taobao Seller Products Scraper](https://apify.com/zen-studio/taobao-seller-products-scraper) - **JD.com 京东** - [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper) - **1688 阿里巴巴** - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper) - [Alibaba Scraper](https://apify.com/zen-studio/alibaba-scraper) - [1688 Reviews Scraper](https://apify.com/zen-studio/1688-reviews-scraper) - **Goofish 闲鱼** - [Goofish (Xianyu) Search Scraper](https://apify.com/zen-studio/goofish-xianyu-search-scraper) - [Goofish (Xianyu) Seller Scraper](https://apify.com/zen-studio/goofish-xianyu-seller-scraper) - [Goofish (Xianyu) Item Detail Scraper](https://apify.com/zen-studio/goofish-xianyu-item-detail-scraper) - [Goofish (Xianyu) Item Comments & Q\&A Scraper](https://apify.com/zen-studio/goofish-xianyu-item-comments-scraper) - [Goofish (Xianyu) Reverse Image Search Scraper](https://apify.com/zen-studio/goofish-xianyu-visual-search-scraper) - Dewu 得物 scraper icon **Dewu 得物** - [Dewu POIZON Scraper](https://apify.com/zen-studio/dewu-poizon-scraper) - **Coupang 쿠팡** - [Coupang Review Scraper](https://apify.com/zen-studio/coupang-review-scraper) - [Coupang Search Scraper](https://apify.com/zen-studio/coupang-search-scraper) - [Coupang Product Detail Scraper](https://apify.com/zen-studio/coupang-detail-scraper) **🏠 Real estate & autos** - **Anjuke 安居客** - [Anjuke For-Sale Listings Scraper](https://apify.com/zen-studio/anjuke-real-estate-scraper) - [Anjuke New-Home Scraper](https://apify.com/zen-studio/anjuke-new-home-scraper) - [Anjuke Rental Listings Scraper](https://apify.com/zen-studio/anjuke-rent-scraper) - [Anjuke Listing Detail Scraper](https://apify.com/zen-studio/anjuke-sale-detail-scraper) - **58.com 58同城** - [58.com Real Estate Scraper](https://apify.com/zen-studio/58-real-estate-scraper) - **Autohome 汽车之家** - [Autohome (Che168) Used-Car Scraper](https://apify.com/zen-studio/che168-car-scraper) ### Support Open an issue on the Issues tab with your run ID and what you expected. We read every one. ### Legal This actor reads creator data the Pugongying marketplace shows for brand research. You are responsible for using the data in line with applicable law and the platform's terms, including data-protection rules for any personal data in the results. # Actor input Schema ## `mode` (type: `string`): Find creators uses Keywords and the filters below.
Analyse creators uses Creators to analyse and ignores keywords and filters.
Similar creators uses Similar to plus the filters below. ## `keywords` (type: `array`): Topics the creators post about, e.g. 咖啡, 露营, 护肤. Each keyword is a separate search with its own Max creators; a creator found by two keywords is returned once. Chinese keywords match far more creators than English ones.

Leave empty to browse by filters alone. ## `searchIn` (type: `string`): Search the creators' post content (default) or their nickname. ## `creators` (type: `array`): Used when the mode is Analyse creators. Accepted forms:
• Profile link: https://www.xiaohongshu.com/user/profile/62d6ce2e000000000200303f
• Pugongying link: https://pgy.xiaohongshu.com/solar/pre-trade/blogger-detail/62d6ce2e000000000200303f
• User ID: 62d6ce2e000000000200303f
• RedNote ID (小红书号): Echo_hl0511
• Share link: https://xhslink.com/m/...

Only creators listed on the Pugongying marketplace can be analysed; others are reported as not found and billed as one lookup ($0.03). A share link that leads to no creator is not billed. ## `similarTo` (type: `string`): Used when the mode is Similar creators: one creator in any of the forms above. Returns creators the marketplace rates as similar, narrowed by the filters below. ## `maxResults` (type: `integer`): Creators to return per keyword (or for the similar-creator search). Up to 5,000; 0 means as many as available. Not used when analysing a list of creators. ## `sortBy` (type: `string`): Order of the results. Rates, medians and cost estimates use the marketplace's 30-day figures. ## `sortOrder` (type: `string`): Highest first (default) or lowest first, e.g. lowest cost per read first. ## `categories` (type: `array`): Creators whose main category is any of these. ## `minFollowers` (type: `integer`): e.g. 10000 ## `maxFollowers` (type: `integer`): e.g. 500000 ## `minImagePostRate` (type: `integer`): The creator's listed price for one image-and-text post. ## `maxImagePostRate` (type: `integer`): The creator's listed price for one image-and-text post. ## `minVideoRate` (type: `integer`): The creator's listed price for one video post. ## `maxVideoRate` (type: `integer`): The creator's listed price for one video post. ## `minReadMedian` (type: `integer`): Median reads per organic post over the last 30 days. ## `maxReadMedian` (type: `integer`): Median reads per organic post over the last 30 days. ## `minEngagementMedian` (type: `integer`): Median likes + saves + comments + shares per organic post over the last 30 days. ## `maxEngagementMedian` (type: `integer`): Median likes + saves + comments + shares per organic post over the last 30 days. ## `contentFormat` (type: `string`): Creators who post mostly image-and-text posts or mostly videos. ## `creatorGender` (type: `string`): The creator's gender as listed on the marketplace. ## `creatorType` (type: `string`): Independent creators or creators signed to an agency (MCN). ## `creatorLocations` (type: `array`): Province, city or district names in Chinese, e.g. 上海, 杭州. Use the bare name without 省/市. ## `minReplyRate48h` (type: `integer`): Share of brand invitations the creator answered within 48 hours, e.g. 80. ## `highQualityOnly` (type: `boolean`): Only creators the marketplace marks as high quality. ## `risingCreatorsOnly` (type: `boolean`): Only creators the marketplace marks as rising. ## `excludeInactive` (type: `boolean`): Leave out creators the marketplace marks as inactive. ## `excludeLosingFollowers` (type: `boolean`): Leave out creators whose follower count is falling. ## `audienceGender` (type: `string`): Creators whose followers are mostly female or mostly male. ## `audienceAge` (type: `string`): Creators whose largest follower group is in this age band. ## `audienceLocations` (type: `array`): Province or city names in Chinese, e.g. 广东, 深圳 (no districts). ## `includeAudience` (type: `boolean`): Follower age, gender, province, city, device and interest split, plus active, engaged and paying follower shares. ## `includePerformance` (type: `boolean`): Impression, read and engagement medians with peer percentiles, engagement rate, traffic sources, sponsored versus organic results, CPM and cost-per-read estimates, active days and invitation counts. ## `includeTrends` (type: `boolean`): Daily follower count and daily impressions, reads, engagements, CPM and CPE for the last 30 days. ## `postsToInclude` (type: `string`): Adds the creator's posts with reads, likes, saves and, for sponsored posts, the brand. Billed per post. ## `maxNotesPerCreator` (type: `integer`): How many posts to add per creator when Posts is on (1-100). Each post is billed. ## `advancedFilters` (type: `object`): Extra marketplace filters, merged over the ones above. Top-level keys are filter groups: goal, blogger, fans, note, coop, live, flags. Ranges are written as {"min": 1000, "max": 5000}.

Example: {"coop": {"video_cpm": {"max": 80}}, "live": {"live_count": {"min": 1}}, "blogger": {"personal_tags": \["妈妈"]}}

An unknown field fails the run before anything is billed. A misspelled value (such as a category name) is accepted but matches nothing. ## `feedback` (type: `string`): For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns. ## Actor input object example ```json { "mode": "search", "keywords": [ "咖啡" ], "searchIn": "posts", "maxResults": 20, "sortBy": "comprehensiverank", "sortOrder": "desc", "contentFormat": "any", "creatorGender": "any", "creatorType": "any", "audienceGender": "any", "audienceAge": "any", "includeAudience": false, "includePerformance": false, "includeTrends": false, "postsToInclude": "none", "maxNotesPerCreator": 8 } ``` # Actor output Schema ## `results` (type: `string`): One row per creator. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "keywords": [ "咖啡" ], "maxResults": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("zen-studio/rednote-kol-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "keywords": ["咖啡"], "maxResults": 20, } # Run the Actor and wait for it to finish run = client.actor("zen-studio/rednote-kol-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 '{ "mode": "search", "keywords": [ "咖啡" ], "maxResults": 20 }' | apify call zen-studio/rednote-kol-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,zen-studio/rednote-kol-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 ` 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/hIHbRRUR3UsigTH9D/builds/pQc5gA9DjPBnxebKa/openapi.json