Fornecido por TikHub
Busca de criadores no Douyin
Pesquise criadores do Douyin via TikHub. Uma solicitação por chamada; o TikHub cobra a solicitação independentemente de haver dados, e um envelope de dados vazio é informado como nenhum resultado.
Como executar
Etapa 1Configurar
Uma vez: cole isto no chat do seu agente. O Skill instala a CLI e faz login sozinho. Para um agente que não pode usar um shell, conecte-o pelo MCP.
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 2Usa a versão 2 do endpoint. Consulte o preço atual antes de executar. Instale e faça login primeiro em Get Started.
Uma vez por Run:
IDEMPOTENCY_KEY=$(uuidgen)Execute e copie este mesmo bloco para enviá-lo novamente:
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}'Reutilize a mesma Idempotency-Key para enviar novamente: o segundo envio é uma leitura do primeiro Run. Uma nova chave cria um novo Run e um novo Charge. Usa a versão 2 do endpoint; consulte o preço atual antes de executar.
Etapa 2Experimente uma tarefa de exemplo específica
Quando precisar criar uma lista de potenciais contatos, você pode analisar os registros de pessoas disponíveis em busca de potenciais clientes que correspondam aos seus critérios de segmentação.
Copie este prompt no seu agente para encontrar potenciais clientes que correspondam aos seus critérios de abordagem.
Use tikhub:/api/v1/douyin/xingtu_v2/search_creator on Glasser.
Find people matching my outreach criteria within the records returned by this endpoint.Estrutura do endpoint
{
"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
}{}Este endpoint não publica um esquema de saída. Você recebe o corpo da resposta do próprio provedor de dados, sem alterações — não garantimos um formato que não podemos assegurar.
Como funciona a cobrança
| Dados retornados ou nenhuma correspondência | O mesmo preço com ou sem dados correspondentes. | $0.001 |
|---|---|---|
| Erro do provedor de dados | O provedor de dados não conseguiu responder. | $0.00 |
| Tempo limite excedido | O Run excedeu seu limite de tempo. | $0.00 |
| Falha interna | Um erro interno impediu a conclusão. | $0.00 |