# Search Xingtu creators by keyword, audience, and pricing

Searches Douyin Creator Marketplace (Xingtu) creators by keyword and structured filters for audience, pricing, content, performance, and campaign fit.

|  |  |
| --- | --- |
| Tool id | `justoneapi.x-douyin-xingtu-gwgsearch-search-for-author-square-v1` |
| Platform | [Douyin Xingtu](https://www.orcarouter.ai/tools/xingtu.md) |
| Capability | [Places](https://www.orcarouter.ai/tools/xingtu/place-search.md) |
| Price | $0.08118 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | yes |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `audienceImage` | string | no | Audience profile filter from Xingtu Audience Image. Pass one or more shortcut values separated by commas. Available values: - Gender: GENDER_MALE_50, GENDER_MALE_60, GENDER_MALE_70, GENDER_MALE_80, GENDER_FEMALE_50, GENDER_FEMALE_60, GENDER_FEMALE_70, GENDER_FEMALE_80; - Age: AGE_18_23, AGE_24_30, A |
| `completionRateRange` | string | no | Completion rate range in decimal min-max format. Example values: 0.1-1 for 10% or above, 0.2-1 for 20% or above. |
| `connectedUserRange` | string | no | Connected user count range. Pass raw user counts in min-max format. Example: 1000000-3000000 |
| `contentTag` | string | no | Creator category filter. Pass Xingtu first-level or second-level category labels separated by commas. Available values: - 美妆: 美妆教程, 妆容展示, 护肤保养, 美妆测评种草; - 时尚: 穿搭, 街拍, 造型, 时尚媒体; - 萌宠: 日常宠物, 特别宠物, 宠物周边; - 测评: 美妆测评, 3C数码测评, 汽车测评, 美食产品测评, 母婴产品测评, 综合测评, 酒店测评; - 游戏: 游戏剧情, 游戏解说, 游戏资讯, 游戏其他, 游戏录屏, 游戏集锦; - 二次 |
| `contentTheme` | string | no | Content theme filter. Pass Xingtu second-level content theme labels separated by commas. Available values include: - 妆容妆造: 淡妆教程, 变装造型, 韩系妆容, 甜美妆容, 清透妆容, 复古妆容, 男性妆容; - 穿搭指南: 日常穿搭, 简约气质穿搭, 国风穿搭, 运动穿搭, 通勤穿搭, 旅行穿搭, 职业穿搭, 约会穿搭; - 亲子育儿: 亲子活动, 亲子沟通, 学前训练, 新手爸妈指导, 儿童护理, 宝宝辅食, 奶粉测评, 孕产饮食; - 美食教程与测评: 地方美食, 家常 |
| `expectedCpeRange` | string | no | Expected CPE range in min-max format. Example values matching Xingtu packs: 0-1, 0-2, 0-3, 0-5, 0-10, 10-1000000. |
| `expectedCpmRange` | string | no | Expected CPM range in min-max format. Example values matching Xingtu packs: 0-10, 0-20, 0-30, 0-50, 0-100, 100-1000000. |
| `expectedPlayRange` | string | no | Expected play count range. Use raw counts in min-max format. Page presets include 10000000 or above, 5000000-10000000, 3000000-5000000, 1000000-3000000, 100000-1000000, and 0-100000. For open-ended presets, pass a high upper bound such as 10000000-1000000000. Example: 1000000-3000000. |
| `fansImage` | string | no | Fan profile filter from Xingtu Fan Image. Pass one or more shortcut values separated by commas. Available values: - Gender: GENDER_MALE_50, GENDER_MALE_60, GENDER_MALE_70, GENDER_MALE_80, GENDER_FEMALE_50, GENDER_FEMALE_60, GENDER_FEMALE_70, GENDER_FEMALE_80; - Age: AGE_18_23, AGE_24_30, AGE_31_40, |
| `followerRange` | string | no | Raw follower count range in min-max format. Example: 1000-2000 means 1,000 to 2,000 followers; 5000000-10000000 means 5 million to 10 million followers. |
| `gender` | string | no | Creator gender. Available values: MALE/1/男性, FEMALE/2/女性. Available Values: - \`MALE\`: Male - \`FEMALE\`: Female One of: MALE, FEMALE. |
| `industry` | string | no | Recommended industry filter. Pass enum name, numeric industry ID, or Chinese industry label. Available values: - ALL/0/不限; - 1901: 3C及电器; - 1938: 购物; - 1903: 食品饮料; - 1904: 服装配饰; - 1905: 医药健康; - 1936: 医疗机构; - 1909: 家居建材; - 1907: 生活服务; - 1906: 商务服务; - 1921: 休闲娱乐; - 1937: 丽人; - 1908: 房地产; - 1910: 教育培训… |
| `interactionRateRange` | string | no | Interaction rate range in decimal min-max format. Example values: 0.01-1 for 1% or above, 0.02-1 for 2% or above. |
| `isSuperstar` | boolean | no | Whether to filter celebrity creators. |
| `keyword` | string | no | Search keyword. |
| `kolPriceRange` | string | no | KOL price range (e.g., 10000-50000). |
| `kolPriceType` | string | no | KOL price type. Available Values: - \`VIDEO_1_20S\`: Video 1-20s - \`VIDEO_21_60S\`: Video 21-60s - \`VIDEO_OVER_60S\`: Video > 60s - \`CUSTOM_SHORT_DRAMA_EPISODE\`: Mini-drama episode - \`NATURAL_PLAY_CPM\`: CPM naturally - \`SHORT_LIVE_SEEDING_VIDEO\`: Short-live seeding video - \`SHORT_LIVE_WARMUP_VIDEO\`: Sh… |
| `location` | string | no | Creator location filter. Pass Chinese province or city names separated by commas. Available province values include: 北京市, 天津市, 河北省, 山西省, 内蒙古自治区, 辽宁省, 吉林省, 黑龙江省, 上海市, 江苏省, 浙江省, 安徽省, 福建省, 江西省, 山东省, 河南省, 湖北省, 湖南省, 广东省, 广西壮族自治区, 海南省, 重庆市, 四川省, 贵州省, 云南省, 西藏自治区, 陕西省, 甘肃省, 青海省, 宁夏回族自治区, 新疆维吾尔自治区, 台湾省, 香港特别 |
| `marketingTarget` | string | no | Marketing goal. Available values: BRAND_EXPOSURE/1/品牌曝光, CIRCLE_SEEDING/2/破圈种草, ACTION_CONVERSION/3/行动转化. Available Values: - \`BRAND_EXPOSURE\`: Brand exposure - \`CIRCLE_SEEDING\`: Out-of-circle seeding - \`ACTION_CONVERSION\`: Action conversion One of: BRAND_EXPOSURE, CIRCLE_SEEDING, ACTION_CONVERSION. |
| `page` | integer | no | Page number for pagination. |
| `personaTag` | string | no | Creator persona or background labels. Pass Xingtu labels or numeric tag IDs separated by commas. Available values: - 人群属性: Z世代, 新锐白领, 精致妈妈, 都市蓝领, 资深中产, 小镇青年, 小镇中老年, 都市银发; - 社会身份: 音乐人, 非遗传人, 画家; - 主要出镜人物: 海外华人, 外国友人, 情侣, 夫妻, 家庭, 朋友, 同事, 亲子, 个人; - 肤质肤色: 混油皮, 干皮, 油皮, 敏感肌, 痘痘肌, 黄皮, 白皮, 瑕疵皮; - 皮肤养护: 美白, |
| `progressTaskRange` | string | no | In-progress task count range. Place a colon between the day count and the min-max range; omit either bound for an open range. Example: 30:8- |
| `searchType` | string | no | Search criteria type. Available Values: - \`NICKNAME\`: By Nickname - \`CONTENT\`: By Content One of: NICKNAME, CONTENT. |
| `sort` | string | no | Creator search sorting. Values: FANS sorts by follower count descending, DEFAULT uses Xingtu score ranking. Available Values: - \`DEFAULT\`: Platform default score ranking - \`FANS\`: Sort by follower count descending One of: DEFAULT, FANS. |
| `tonalityTag` | string | no | Creator tonality labels. Pass Xingtu first-level or second-level tonality labels separated by commas. Available values: - 身份/爱好: 马术, 高尔夫, 橄榄球, 时尚爱好者, 企业高管, 汽车爱好者, 学者专家, 古玩收藏; - 精致达人: 设计师, 高阶潮玩, 职业模特, 造型顾问, 独立设计师, 美术/画廊/展览, 歌剧舞台剧, 流行, 潮流买手, 电影; - 潮流酷: 冲浪, 浮潜, 说唱, 滑雪, 普拉提, 网球. Example: 精致达人,设计师 |
| `viralRateRange` | string | no | Viral content rate range in decimal min-max format. Page presets include 0-0.1, 0.1-0.25, 0.25-0.5, 0.5-0.99, and 0.99 or above. For open-ended presets, pass a high upper bound such as 0.99-1. Example: 0.1-0.25. |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/justoneapi.x-douyin-xingtu-gwgsearch-search-for-author-square-v1/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/justoneapi.x-douyin-xingtu-gwgsearch-search-for-author-square-v1/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Douyin Xingtu creator local info by creator id](https://www.orcarouter.ai/tools/xingtu/place-search/x-douyin-xingtu-v2-get-author-local-info.md) | — | $0.0011 per call | OK |
| [Xingtu creator business card by creator id](https://www.orcarouter.ai/tools/xingtu/place-search/x-douyin-xingtu-gwgauthor-author-get-business-card-info-v1.md) | — | $0.024354 per call | OK |

## FAQ

### How much does Search Xingtu creators by keyword, audience, and pricing cost?

Search Xingtu creators by keyword, audience, and pricing costs $0.08118 per call: 1,000 calls cost $81.18.

### What does a $10 budget buy with Search Xingtu creators by keyword, audience, and pricing?

About 123 calls at $0.08118 per call.

### What inputs does Search Xingtu creators by keyword, audience, and pricing need?

It has no required inputs.

### How do I call Search Xingtu creators by keyword, audience, and pricing?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/xingtu/place-search/x-douyin-xingtu-gwgsearch-search-for-author-square-v1