Creator object

4 endpoints on 2 platforms return the Creator object with the same 9 fields, so code written for one platform reads the others unchanged. A call costs $0.0040 to $0.0400. It is a preview structure and may still change.

Preview object · Updated 2026-10-17Open in ChatGPTOpen in Claude

A Creator is a creator as a platform's own marketplace for sponsored content lists one: Douyin's Xingtu (星图) or Xiaohongshu's PGY (蒲公英). It carries the marketplace's creator id, the name, location, content categories and follower count, and in the full view each marketplace's rates and figures under ext.

It is not an Account: account_id points to the creator's account on the platform, as the account endpoints take it. Its id is what the marketplace's other endpoints take, Creator rates, Audience and the Xingtu and PGY figures, videos and notes among them.

Fields

A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.

id text

The creator's ID in the marketplace

account_id text

ID of the creator's account on the platform, as the platform's account endpoints take it

username text

Handle

name text

Display name

avatar_url link standard

Avatar

location text standard

Where the creator is based, in the platform's words

categories list of text

Content categories, first level, in the platform's words

subcategories list of text standard

Content categories, second level, in the platform's words

metrics object

Creator counts

metrics.followers integer

Followers

Endpoints that return Creator

The number beside each platform is how many of its endpoints return it.

EndpointPathPrice
Douyin Xingtu creator searchGET/v1/douyin/xingtu/creators/search$0.0040
Douyin Xingtu creator profileGET/v1/douyin/xingtu/creators/get$0.0040
Xiaohongshu PGY creator searchGET/v1/xiaohongshu/pgy/creators/search$0.0400
Xiaohongshu PGY creator detailGET/v1/xiaohongshu/pgy/creators/get$0.0400

Example

One item from douyin.xingtu.creators.search, as recorded 2026-10-12 22:06 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Creator · douyin.xingtu.creators.search
{
  "id": "6811001738597474041",
  "name": "橘子汽水不加冰",
  "avatar_url": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_49724ca5b7a50c72cbe5.jpeg",
  "location": "北京",
  "categories": ["户外"],
  "subcategories": ["家居好物"],
  "metrics": { "followers": 48169 }
}

The whole response is on the endpoint's page →

Related

Other objects