# Creator metrics API

2 endpoints on 2 platforms answer in one response shape. How a creator's posts did over the last 30 or 90 days. A call costs from $0.0040 to $0.0400, each endpoint at its own price; a failed call is free.

## Creator metrics on each platform

| Platform | Endpoint | Path | A page | Returns | Price |
| --- | --- | --- | --- | --- | --- |
| Douyin | [Douyin Xingtu creator metrics](https://dataxapi.com/apis/douyin/xingtu/creators/metrics.md) | `GET /v1/douyin/xingtu/creators/metrics` | 1 | Xingtu creator metrics | $0.0040 / call |
| Xiaohongshu (RedNote) | [Xiaohongshu PGY creator metrics](https://dataxapi.com/apis/xiaohongshu/pgy/creators/metrics.md) | `GET /v1/xiaohongshu/pgy/creators/metrics` | 1 | PGY creator metrics | $0.0400 / call |

Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing.

## The Xingtu creator metrics object

Every endpoint above returns these fields, with the same names and types.

| Field | Type | Description |
| --- | --- | --- |
| `creator_id` | text | Xingtu creator ID |
| `videos` | integer | Videos in the period |
| `median_views` | integer | Median views of a video |
| `average_likes` | integer | Average likes of a video |
| `average_comments` | integer | Average comments of a video |
| `average_shares` | integer | Average shares of a video |
| `engagement_rate` | number | Engagement rate, 0 to 1 |
| `engagement_rate_percentile` | number | Share of comparable creators whose engagement rate it exceeds, 0 to 1 |
| `completion_rate` | number | Completion rate, 0 to 1 |
| `completion_rate_percentile` | number | Share of comparable creators whose completion rate it exceeds, 0 to 1 |
| `currency` | text | Currency of the amounts below |
| `cpm_21_60s` | amount | Expected cost per thousand views of a 21 to 60 second video |
| `cpm_over_60s` | amount | Expected cost per thousand views of a video over 60 seconds |
| `cpe_21_60s` | amount | Expected cost per interaction of a 21 to 60 second video |
| `cpe_over_60s` | amount | Expected cost per interaction of a video over 60 seconds |

[The object's own page →](https://dataxapi.com/docs/objects/xingtu_creator_metrics/)

### Which platform fills which field

A field an endpoint cannot give is listed in `meta.unavailable` on every answer, so a gap is never a surprise.

| Platform | `videos` | `median_views` | `average_likes` | `average_comments` | `average_shares` | `engagement_rate_percentile` | `completion_rate` | `completion_rate_percentile` | `currency` | `cpm_21_60s` | `cpm_over_60s` | `cpe_21_60s` | `cpe_over_60s` |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Douyin | available | available | available | available | available | available | available | available | available | available | available | available | available |
| Xiaohongshu (RedNote) | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available |

## The same call on two platforms

Same parameter names, same paging, same answer. Only the path changes.

```bash
# Douyin
curl -G "https://api.dataxapi.com/v1/douyin/xingtu/creators/metrics" \
  --data-urlencode "id=6763236383382306828" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

# Xiaohongshu (RedNote): the same call on its own path
curl -G "https://api.dataxapi.com/v1/xiaohongshu/pgy/creators/metrics" \
  --data-urlencode "id=5c0017ef6b58b740c92463fb" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

### 200 · application/json

Douyin Xingtu creator metrics: From a response recorded 2026-10-12 21:49 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

```jsonc
{
  "code": "ok",
  "request_id": "b00b80a0-88cc-4177-9e0a-3334acbccd1f",
  "data": {
    "item": {
      "creator_id": "6660491594420292860",
      "videos": 763,
      "median_views": 237059,
      "average_likes": 11712,
      "average_comments": 993,
      "average_shares": 938,
      "engagement_rate": 0.0148,
      "engagement_rate_percentile": 0.512,
      "completion_rate": 0.2377,
      "completion_rate_percentile": 0.7391,
      "currency": "CNY",
      "cpm_21_60s": "537.29",
      "cpm_over_60s": "2238.73",
      "cpe_21_60s": "36.92",
      "cpe_over_60s": "153.84"
    }
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.xingtu.creators.metrics",
    "result_status": "complete",
    "fetched_at": "2026-10-12T21:49:37.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {},
    "billing": {
      "amount": "0.004",
      "currency": "USD",
      "balance_after": "9.996"
    }
  }
}
```

## What comes back

- [The Xingtu creator metrics object](https://dataxapi.com/docs/objects/xingtu_creator_metrics/): Fields 15, Endpoints that return it 1, Platforms 1
- [The PGY creator metrics object](https://dataxapi.com/docs/objects/pgy_creator_metrics/): Fields 17, Endpoints that return it 1, Platforms 1

## Questions about the Creator metrics API

### How much does it cost?

$0.0040 a call on Douyin; $0.0400 a call on Xiaohongshu (RedNote). You are charged when data comes back; a failed call costs nothing. No subscription, no monthly minimum.

### Does every platform fill every field?

No. 13 of the 15 fields are missing on at least one platform; the table on this page says which. A field an endpoint cannot give is named in `meta.unavailable` on every answer, never filled with a guess.

### Do I need an account on the platform?

No. One DataXAPI key reads all 2 platforms. No platform account and no cookie.

## Other data types

[Comment replies API](https://dataxapi.com/roles/comments-replies-list/), [Hashtag posts API](https://dataxapi.com/roles/topics-posts-list/), [Trending topics API](https://dataxapi.com/roles/trends-list/), [Account profile API](https://dataxapi.com/roles/accounts-get/), [Account posts API](https://dataxapi.com/roles/accounts-posts-list/), [Comments API](https://dataxapi.com/roles/posts-comments-list/), [Post detail API](https://dataxapi.com/roles/posts-get/), [Post search API](https://dataxapi.com/roles/posts-search/), [Trending posts API](https://dataxapi.com/roles/posts-trending/), [Account search API](https://dataxapi.com/roles/accounts-search/), [Post metrics API](https://dataxapi.com/roles/posts-metrics/), [Community posts API](https://dataxapi.com/roles/communities-posts-list/), [Ad detail API](https://dataxapi.com/roles/ads-get/), [Advertiser ads API](https://dataxapi.com/roles/advertisers-ads-list/), [Advertiser search API](https://dataxapi.com/roles/advertisers-search/), [Ad library search API](https://dataxapi.com/roles/ads-search/), [Video transcript API](https://dataxapi.com/roles/transcripts-get/), [Followers API](https://dataxapi.com/roles/accounts-followers-list/), [Community profile API](https://dataxapi.com/roles/communities-get/), [Product detail API](https://dataxapi.com/roles/products-get/), [Product reviews API](https://dataxapi.com/roles/products-reviews-list/), [Product search API](https://dataxapi.com/roles/products-search/), [Creator search API](https://dataxapi.com/roles/creators-search/), [Creator profile API](https://dataxapi.com/roles/creators-get/), [Creator audience API](https://dataxapi.com/roles/creators-audience-get/), [Creator posts API](https://dataxapi.com/roles/creators-posts-list/), [All 21 platforms →](https://dataxapi.com/apis/)

---

Last checked 2026-10-21 11:10 UTC. Catalog revision c48ce454ae6c4c65. [HTML version](https://dataxapi.com/roles/creators-metrics/)
