# Creator search API 2 endpoints on 2 platforms return the same Creator object. The creators of a platform's creator marketplace that match what you look for. A call costs from $0.0040 to $0.0400, each endpoint at its own price; a failed call is free. ## Creator search on each platform | Platform | Endpoint | Path | A page | Returns | Price | | --- | --- | --- | --- | --- | --- | | Douyin | [Douyin Xingtu creator search](https://dataxapi.com/apis/douyin/xingtu/creators/search.md) | `GET /v1/douyin/xingtu/creators/search` | 20 | Creator list | $0.0040 / call | | Xiaohongshu (RedNote) | [Xiaohongshu PGY creator search](https://dataxapi.com/apis/xiaohongshu/pgy/creators/search.md) | `GET /v1/xiaohongshu/pgy/creators/search` | 20 | Creator list | $0.0400 / call | Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing. ## The Creator object Every endpoint above returns these fields, with the same names and types. | Field | Type | Description | | --- | --- | --- | | `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 | Avatar | | `location` | text | 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 | Content categories, second level, in the platform's words | | `metrics.followers` | integer | Followers | [The object's own page →](https://dataxapi.com/docs/objects/creator/) ### 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 | `account_id` | `username` | | --- | --- | --- | | Douyin | not available | not available | | Xiaohongshu (RedNote) | available | 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/search" \ --data-urlencode "query=美食" \ -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/search" \ --data-urlencode "query=咖啡" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" ``` ### 200 · application/json Douyin Xingtu creator search: From a response recorded 2026-10-12 22:06 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": "868ddbde-b3c7-4d7f-b06d-9222e36252a7", "data": { "items": [ { "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 } }, // … 19 more ] }, "page": { "next_cursor": "c1.Xg3q38In7offq-5CuKi-UcARHThe6dxGEKhgaR5D", "cursor_expires_at": "2026-10-12T23:06:50.000Z", "has_more": true, "returned": 20 }, "warnings": [], "meta": { "capability": "douyin.xingtu.creators.search", "result_status": "complete", "fetched_at": "2026-10-12T22:06:50.000Z", "cached": false, "replayed": false, "unavailable": { "account_id": "capability", "username": "capability" }, "billing": { "amount": "0.004", "currency": "USD", "balance_after": "9.996" } } } ``` ## What comes back - [The Creator object](https://dataxapi.com/docs/objects/creator/): Fields 9, Endpoints that return it 4, Platforms 2 ## Questions about the Creator search 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. ### How do I get every page? Pass `page.next_cursor` back as `cursor` until `page.has_more` is false. Each page is one call at the same price. ### Does every platform fill every field? No. 2 of the 9 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 profile API](https://dataxapi.com/roles/creators-get/), [Creator audience API](https://dataxapi.com/roles/creators-audience-get/), [Creator metrics API](https://dataxapi.com/roles/creators-metrics/), [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-search/)