openclaw-voc-skill/social-media/tiktok-user-search/api-config.json

{
  "name": "tiktok-user-search",
  "displayName": "TikTok 用户搜索",
  "description": "按关键词搜索 TikTok 用户/达人，返回用户列表及粉丝数、关注数等基础信息。用于红人发现、达人库建设。",
  "category": "social-media",
  "version": "1.0.0",
  "endpoint": {
    "method": "GET",
    "url": "https://server.fmode.cn/thapi/v1/tiktok/web/fetch_search_user",
    "headers": {
      "Authorization": "Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==",
      "Accept": "application/json"
    }
  },
  "parameters": {
    "type": "object",
    "required": [
      "keyword"
    ],
    "properties": {
      "keyword": {
        "type": "string",
        "description": "搜索关键词，如品牌名 'NEST New York' 或品类 'candle warmer'"
      },
      "count": {
        "type": "integer",
        "description": "返回用户数量",
        "default": 10,
        "maximum": 30
      },
      "cursor": {
        "type": "integer",
        "description": "分页游标",
        "default": 0
      }
    }
  },
  "requestTransform": {
    "queryParams": {
      "keyword": "{{keyword}}",
      "count": "{{count}}",
      "cursor": "{{cursor}}"
    }
  },
  "response": {
    "type": "object",
    "description": "用户搜索结果",
    "properties": {
      "user_list": {
        "type": "array",
        "description": "用户列表（可能在 data.user_list 中）",
        "items": {
          "type": "object",
          "properties": {
            "user_info": {
              "type": "object",
              "properties": {
                "unique_id": {
                  "type": "string",
                  "description": "用户名"
                },
                "nickname": {
                  "type": "string",
                  "description": "昵称"
                },
                "follower_count": {
                  "type": "integer",
                  "description": "粉丝数"
                },
                "following_count": {
                  "type": "integer",
                  "description": "关注数"
                },
                "total_favorited": {
                  "type": "integer",
                  "description": "获赞总数"
                },
                "video_count": {
                  "type": "integer",
                  "description": "作品数"
                },
                "avatar_larger": {
                  "type": "object",
                  "description": "头像（大图）"
                },
                "signature": {
                  "type": "string",
                  "description": "个人简介"
                }
              }
            }
          }
        }
      }
    }
  },
  "usageExamples": [
    {
      "name": "搜索香薰达人",
      "input": {
        "keyword": "candle warmer",
        "count": 15
      },
      "description": "搜索与 candle warmer 相关的 TikTok 达人"
    },
    {
      "name": "搜索品牌账号",
      "input": {
        "keyword": "NEST New York",
        "count": 5
      },
      "description": "搜索竞品品牌的 TikTok 官方账号"
    }
  ],
  "reportMapping": {
    "slides": [
      "红人达人库(Slide11)"
    ],
    "dataPoints": [
      "达人粉丝数",
      "互动率",
      "作品数",
      "品类契合度"
    ]
  },
  "timeout": 15000,
  "retry": {
    "maxAttempts": 3,
    "delay": 1500,
    "backoffMultiplier": 2
  }
}