# Creator search, audiences, quotes and performance

Use the KOL pack for explicit creator research on Douyin and Xiaohongshu.

Canonical: https://socialtoai.com/docs/kol/

## Enable and connect

Enable KOL on your Key in the console. For MCP, add packs=kol to the connection URL. Core content tools remain available. Each explicit KOL call has its own price and uses the same wallet.

## Current availability

Douyin kol_search: temporarily unavailable due to upstream supply failure. Calls cost 0. Other KOL operations retain their listed availability.

Douyin kol_profile: temporarily unavailable due to upstream supply failure. Calls cost 0. Other KOL operations retain their listed availability.

## Select a creator and continue

Call kol_search with platform=douyin or xiaohongshu and query. Copy a result's id into user for kol_profile, kol_audience, kol_pricing or kol_performance. Use a returned profile URL to call core user_profile or user_posts; do not guess one from a nickname.

Search returns one native page. Pass page.cursor with identical parameters for the next page. Sparse or empty Xiaohongshu pages may still have a continuation. Dynamic filter values must come from verified platform options.

## Find filter values before searching

Call capabilities with platform and operation=kol_search to list available filter fields. Add field and an optional query to find options. Each entry gives a label and filters to merge deliberately into your next kol_search input. Discovery is free and performs no search or supplier request.

Use next_offset with the same catalog_version and query to continue. If the catalog changes, restart at offset 0. The response includes observed_at: this is a published snapshot, not a promise that every option still matches creators. Check search_available before a paid call. Some dictionaries remain unmapped; an empty activity list means no published choices.

HTTP requires capabilities and kol scopes. MCP also requires packs=kol and a platform that this connection has not excluded. Adding URL settings does not grant permissions.

```
{
  "platform": "xiaohongshu",
  "operation": "kol_search",
  "field": "blogger.content_tag",
  "query": "美妆"
}
```

## Read measurements with their limits

kol_audience defaults to population=followers. Douyin also supports population=audience; the source does not specify that population's statistical definition. Do not interpret it as video viewers or reach. Xiaohongshu supports followers only.

Douyin returns native bucket counts; Xiaohongshu returns ratios from 0 to 1. Denominators and coverage are unspecified. Source data dates retain native precision and may be absent; retrieval time is not the measurement window.

## Read listed collaboration quotes

kol_pricing returns a profile_card with platform_extra.quotes by format. Amounts are CNY per content. Missing, zero or hidden amounts are unavailable, not free. Douyin exposes the verified 21–60 second and over-60 second fields; the 1–20 second quote is unavailable. Xiaohongshu exposes image/text and video formats.

Listed amounts do not guarantee bookability or final taxes and platform fees. Effective quote dates are unavailable. Failed calls cost zero; confirmed empty results use the published call price. Reusing an idempotency key with the same HTTP parameters replays the original result and price.

## Read content performance

kol_performance reads one creator and one requested window: time_range_days=30 (default) or 90. Xiaohongshu also accepts scope=daily|sponsored, content_type=all|image|video and traffic=all|organic; defaults are daily, all and all. These filters are not accepted for Douyin. Each call performs one supplier request and has no pagination.

The profile_card uses a fixed performance card title, not a creator nickname. Read platform_extra.metrics together with statistic, unit and source_field. Means and medians are distinct. native_units_unspecified values are not verified counts, percentages or seconds; do not normalize or compare them across platforms. Missing metrics are unavailable, not zero.

sample_counts describes the source population; Xiaohongshu samples contains only the notes selected by the source. Returned dates use published_on with day precision, and links appear only when the source marks them accessible. Exact window boundaries and data update times are unavailable. The creator is bound through the request echo, without independent identity confirmation in the business payload. Confirmed empty results are billed; failures are free.

## Research keyword demand

keyword_index is part of the KOL pack. Use platform=xiaohongshu, query and mode=overview|daily|related (default overview). Each explicit mode is one separately billed call. Douyin keyword data is currently unavailable and returns not_supported at zero cost. Related words are never queried automatically.

Each mode returns one item with platform_extra.card_type=keyword_index. Overview provides metrics and source creator distributions; change_30d_percent is a signed period comparison. Search index is not a search count. Zero values do not establish zero demand or complete statistics. Creator buckets can overlap and need not total 100%; price-band units are unverified.

Daily points retain source calendar dates and omitted values, without filling gaps or inventing a timezone. The source selects the window; observed_start and observed_end are the returned bounds, not date filters. Related words preserve before/after search direction and available source ranks. Compare the metric units and limits before drawing conclusions. Confirmed empty results are billed; failures are free.

```
{
  "platform": "xiaohongshu",
  "query": "coffee",
  "mode": "daily"
}
```

## API prices

Price version: standard-2026-09-08-12ebeeeacfa39f97.

| Platform | Operation | Credits | Availability |
|---|---|---|---|
| Xiaohongshu | kol_search | 2.9 | Available |
| Xiaohongshu | kol_profile | 2.9 | Available |
| Xiaohongshu | kol_audience | 2.9 | Available |
| Xiaohongshu | kol_pricing | 2.9 | Available |
| Xiaohongshu | kol_performance | 2.9 | Available |
| Xiaohongshu | keyword_index | 2.9 | Available |
| Douyin | kol_search | 0.2 | Temporarily unavailable — calls cost 0 |
| Douyin | kol_profile | 0.2 | Temporarily unavailable — calls cost 0 |
| Douyin | kol_audience | 0.3 | Available |
| Douyin | kol_pricing | 0.3 | Available |
| Douyin | kol_performance | 0.2 | Available |

[Download the complete OpenAPI →](https://socialtoai.com/openapi.json)