Douyin Creator Marketplace (Xingtu) Creator Search
Use this focused JustOneAPI skill for creator Search in Douyin Creator Marketplace (Xingtu). It targets GET /api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1. It has no required non-token parameters. OpenAPI describes it as: Get Douyin Creator Marketplace (Xingtu) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building.
Endpoint Scope
- Platform key:
douyin-xingtu - Endpoint key:
gw/api/gsearch/search_for_author_square - Platform family: Douyin Creator Marketplace (Xingtu)
- Skill slug:
justoneapi-douyin-xingtu-gw-api-gsearch-search-for-author-square
| Operation | Version | Method | Path | OpenAPI summary |
|---|---|---|---|---|
gwApiGsearchSearchForAuthorSquareV1 |
v1 |
GET |
/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1 |
Creator Search |
Inputs
| Parameter | In | Required by | Optional by | Type | Notes |
|---|---|---|---|---|---|
contentTag |
query |
n/a | all | string |
Content tag filter |
followerRange |
query |
n/a | all | string |
Follower range (e.g., 10-100) |
keyword |
query |
n/a | all | string |
Search keyword |
kolPriceRange |
query |
n/a | all | string |
KOL price range (e.g., 10000-50000) |
kolPriceType |
query |
n/a | all | string |
KOL price type. Available Values: - 视频1_20s: Video 1-20s - 视频21_60s: Video 21-60s - 视频60s以上: Video > 60s - 定制短剧单集: Mini-drama episode - 千次自然播放量: CPM naturally - 短直种草视频: Short-live seeding video - 短直预热视频: Short-live warm-up video - 短直明星种草: Celebrity short-live seeding - 短直明星预热: Celebrity short-live warm-up - 明星视频: Celebrity video - 合集视频: Collection video - 抖音短视频共创_主投稿达人: Douyin short video co-creation - main creator - 抖音短视频共创_参与达人: Douyin short video co-creation - participant |
kolPriceType enum |
values | n/a | n/a | n/a | 千次自然播放量, 合集视频, 定制短剧单集, 抖音短视频共创_主投稿达人, 抖音短视频共创_参与达人, 明星视频, 短直明星种草, 短直明星预热, 短直种草视频, 短直预热视频, 视频1_20s, 视频21_60s, 视频60s以上 |
page |
query |
n/a | all | integer |
Page number for pagination |
searchType |
query |
n/a | all | string |
Search criteria type. Available Values: - NICKNAME: By Nickname - CONTENT: By Content |
searchType enum |
values | n/a | n/a | n/a | CONTENT, NICKNAME |
Request body: none documented; send parameters through path or query arguments.
Version Choice
Use gwApiGsearchSearchForAuthorSquareV1 for the documented v1 endpoint. There are no alternate versions grouped in this skill.
Run This Endpoint
Supported operation IDs in this skill: gwApiGsearchSearchForAuthorSquareV1.
node {baseDir}/bin/run.mjs --operation "gwApiGsearchSearchForAuthorSquareV1" --token "$JUST_ONE_API_TOKEN" --params-json '{"key":"value"}'
Ask for any missing required parameter before calling the helper. Keep user-provided IDs, cursors, keywords, and filters unchanged.
Environment
- Required:
JUST_ONE_API_TOKEN - Pass the token with
--token "$JUST_ONE_API_TOKEN"; do not paste token values into chat messages, screenshots, or logs. - Get a token from Just One API Dashboard.
- Authentication details: Just One API Usage Guide.
Output Focus
- State the operation ID and endpoint path used, for example
gwApiGsearchSearchForAuthorSquareV1on/api/douyin-xingtu/gw/api/gsearch/search_for_author_square/v1. - Prioritize fields that support this endpoint purpose: Get Douyin Creator Marketplace (Xingtu) creator Search data, including filters, returning profile, and audience, for discovery, comparison, and shortlist building.
- Return raw JSON only after the short, endpoint-specific summary.
- If the backend errors, include the backend payload and the exact operation ID.