Provided by TikHub
Douyin search creator
Search creator from Douyin via TikHub. One request per call; TikHub bills the request whether or not data comes back, and an empty data envelope is reported as no result.
How to run it
Step 1Set up
Once: paste this into your agent's chat. The Skill installs the CLI and logs in by itself. For an agent that cannot use a shell, connect it over MCP instead.
set up https://glasser.ai/SKILL.md
Show me how to use the TikHub endpoint /api/v1/douyin/xingtu_v2/search_creator on Glasser.glasser run -p tikhub -e '/api/v1/douyin/xingtu_v2/search_creator' -i '{}' --endpoint-version 2Uses endpoint version 2. Inspect the current price before running. Install and log in first on Get Started.
Once per Run:
IDEMPOTENCY_KEY=$(uuidgen)Run it, and copy this same block to send it again:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"tikhub","endpoint":"/api/v1/douyin/xingtu_v2/search_creator","input":{},"endpoint_version":2}'Reuse the same Idempotency-Key to send it again: the second send is a read of the first Run. A new key is a new Run and a new Charge. Uses endpoint version 2; inspect the current price before running.
Step 2Try a specific example task
When you need to build an outreach shortlist, you might review available people records for prospects who match your targeting criteria.
Copy this prompt into your agent to find prospects matching your outreach criteria.
Use tikhub:/api/v1/douyin/xingtu_v2/search_creator on Glasser.
Find people matching my outreach criteria within the records returned by this endpoint.Endpoint structure
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "达人类型ID,多个用逗号分隔,如`1,6`/Creator category IDs, comma-separated"
},
"page": {
"type": "integer",
"description": "页码/Page number"
},
"gender": {
"type": "integer",
"description": "达人性别,1=男,2=女/Creator gender, 1=male, 2=female"
},
"cpe_max": {
"type": "integer",
"description": "预期CPE上限/Maximum expected CPE"
},
"cpe_min": {
"anyOf": [
{
"type": "number"
},
{
"enum": [
"Infinity",
"-Infinity",
"NaN"
],
"type": "string"
}
]
},
"cpm_max": {
"type": "integer",
"description": "预期CPM上限/Maximum expected CPM"
},
"cpm_min": {
"type": "integer",
"description": "预期CPM下限/Minimum expected CPM"
},
"keyword": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "可选搜索词;留空时仅按筛选条件浏览。seach_type=2匹配昵称,=3匹配内容/Optional keyword; empty means filter-only browsing"
},
"fans_max": {
"type": "integer",
"description": "粉丝数上限/Maximum followers"
},
"fans_min": {
"type": "integer",
"description": "粉丝数下限/Minimum followers"
},
"price_max": {
"type": "integer",
"description": "达人报价上限,提供时必须同时提供price_type/Maximum creator price"
},
"price_min": {
"type": "integer",
"description": "达人报价下限,提供时必须同时提供price_type/Minimum creator price"
},
"sort_type": {
"type": "integer",
"description": "排序方式,1=升序,2=降序/Sort type, 1=asc, 2=desc"
},
"price_type": {
"type": "integer",
"description": "短视频报价时长档位:1=1-20秒、2=21-60秒、3=60秒以上;仅与price_min/price_max配合使用/Creator video price tier"
},
"seach_type": {
"enum": [
"2",
"3"
],
"type": "string",
"description": "搜索方式,2=按昵称找人,3=按内容找人/Search mode: 2=nickname, 3=content"
},
"sort_field": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "排序字段,默认score综合排序/Sort field, default score (comprehensive)"
},
"extra_filter": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "额外画像筛选的JSON数组字符串,每项必须包含非空字符串field_name和field_value;支持内容主题、观众/粉丝画像、八大人群和地域等维度/Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings"
},
"persona_tags": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "达人人设/学历/认证/调性ID。逗号分隔=满足任一;分号分组=每组都要满足,如`1129,110401;110213`/Persona IDs. Comma=match any, semicolon=group AND"
},
"task_category": {
"type": "integer",
"description": "合作对象/Cooperation target"
},
"author_list_id": {
"type": "string",
"maxLength": 2048,
"minLength": 1,
"description": "主题推荐达人清单ID/Featured creator list ID"
},
"time_range_days": {
"enum": [
"30",
"90",
"180"
],
"type": "string",
"description": "内容搜索时间范围,30/90/180天,仅seach_type=3时生效/Content time range; only for seach_type=3"
},
"marketing_target": {
"type": "integer",
"description": "营销目标/Marketing target"
},
"expected_play_max": {
"type": "integer",
"description": "预期播放量上限/Maximum expected plays"
},
"expected_play_min": {
"type": "integer",
"description": "预期播放量下限/Minimum expected plays"
},
"first_industry_id": {
"type": "integer",
"description": "适配行业ID,0=不限/Industry ID, 0=unlimited"
},
"interact_rate_max": {
"anyOf": [
{
"type": "number"
},
{
"enum": [
"Infinity",
"-Infinity",
"NaN"
],
"type": "string"
}
]
},
"interact_rate_min": {
"anyOf": [
{
"type": "number"
},
{
"enum": [
"Infinity",
"-Infinity",
"NaN"
],
"type": "string"
}
]
},
"play_over_rate_max": {
"anyOf": [
{
"type": "number"
},
{
"enum": [
"Infinity",
"-Infinity",
"NaN"
],
"type": "string"
}
]
},
"play_over_rate_min": {
"anyOf": [
{
"type": "number"
},
{
"enum": [
"Infinity",
"-Infinity",
"NaN"
],
"type": "string"
}
]
},
"burst_text_rate_max": {
"anyOf": [
{
"type": "number"
},
{
"enum": [
"Infinity",
"-Infinity",
"NaN"
],
"type": "string"
}
]
},
"burst_text_rate_min": {
"anyOf": [
{
"type": "number"
},
{
"enum": [
"Infinity",
"-Infinity",
"NaN"
],
"type": "string"
}
]
}
},
"additionalProperties": false
}{}This Endpoint publishes no output schema. You get the Provider's own response body, unchanged — we do not warrant a shape we cannot guarantee.
How pricing works
| Data returned or no match | The same price with or without matching data. | $0.001 |
|---|---|---|
| Provider error | The Provider failed to answer. | $0.00 |
| Timed out | The Run exceeded its time limit. | $0.00 |
| Internal failure | An internal error prevented completion. | $0.00 |