{
  "spec_version": "0.2",
  "namespace": "SpiderKing999",
  "app_name": "tiktok-account-info",
  "app_id": "app_e1d98a786fa8",
  "status": "published",
  "open_to": "public",
  "accepting_runs": true,
  "source_locale": "zh-CN",
  "identity": {
    "app_name": "tiktok-account-info",
    "name": "TikTok 账号信息采集",
    "summary": "提交 TikTok 用户名，返回昵称、粉丝数、简介与认证状态等公开账号资料",
    "type": "data",
    "version": "0.1.3"
  },
  "discovery": {
    "capability": "data-acquisition",
    "keywords": [
      "TikTok",
      "账号",
      "达人",
      "粉丝",
      "信息采集"
    ],
    "boundary": "单次最多 200 个用户名；每个用户名最多返回一条公开账号资料，不含私密或未公开信息。"
  },
  "input": {
    "schema": {
      "type": "object",
      "properties": {
        "accounts": {
          "type": "array",
          "title": "TikTok 用户名",
          "description": "要采集账号信息的 TikTok 用户名，每条填一个用户名，不含 @ 符号，一次最多 200 个",
          "items": {
            "type": "object",
            "properties": {
              "account": {
                "type": "string",
                "title": "用户名",
                "description": "TikTok 账号用户名，不含 @ 符号，最长 512 字符",
                "pattern": "^[a-zA-Z0-9._]{1,512}$"
              }
            },
            "additionalProperties": false,
            "required": [
              "account"
            ]
          },
          "minItems": 1,
          "maxItems": 200,
          "prefill": [
            {
              "account": "niogitsune"
            }
          ]
        }
      },
      "required": [
        "accounts"
      ],
      "additionalProperties": false
    }
  },
  "output": {
    "id_field": "account_id",
    "schema": {
      "type": "object",
      "properties": {
        "account_id": {
          "type": "string",
          "title": "账号编号",
          "description": "TikTok 平台内账号唯一编号"
        },
        "account_name": {
          "type": "string",
          "title": "昵称",
          "description": "账号展示昵称"
        },
        "biz_id": {
          "type": "string",
          "title": "用户名",
          "description": "账号 @ 后面的用户名标识"
        },
        "account_signature": {
          "type": "string",
          "title": "个性签名",
          "description": "账号主页个性签名"
        },
        "fans_count": {
          "type": "string",
          "title": "粉丝数",
          "description": "粉丝数量，取数当时的公开统计值"
        },
        "heart_count": {
          "type": "string",
          "title": "获赞总数",
          "description": "账号累计获赞数，取数当时的公开统计值"
        },
        "is_verified": {
          "type": "boolean",
          "title": "是否认证",
          "description": "账号是否带有平台认证标识"
        },
        "is_youtube": {
          "type": "boolean",
          "title": "关联 YouTube",
          "description": "账号是否关联 YouTube 渠道"
        },
        "bio_link": {
          "type": "string",
          "title": "主页链接",
          "description": "账号主页外链地址"
        },
        "region": {
          "type": "string",
          "title": "地区",
          "description": "账号公开显示的地区信息"
        },
        "language": {
          "type": "string",
          "title": "语言",
          "description": "账号公开显示的语言信息"
        },
        "location": {
          "type": "string",
          "title": "位置",
          "description": "账号公开显示的位置信息"
        },
        "publish_content_count": {
          "type": "string",
          "title": "作品数",
          "description": "公开发布的作品数量"
        },
        "crawl_time": {
          "type": "string",
          "title": "采集时间",
          "description": "本条资料采集完成的时间"
        },
        "keyword": {
          "type": "string",
          "title": "检索词",
          "description": "采集时使用的检索关键词"
        },
        "account_avatar_url": {
          "type": "string",
          "title": "头像链接",
          "description": "账号头像图片地址"
        },
        "intro": {
          "type": "string",
          "title": "简介",
          "description": "账号补充简介文本"
        },
        "commerce_user_info": {
          "type": "string",
          "title": "商业账号信息",
          "description": "商业账号相关的公开标识信息"
        },
        "is_mail": {
          "type": "boolean",
          "title": "可私信",
          "description": "账号是否允许私信联系"
        },
        "queried_username": {
          "type": "string",
          "title": "提交用户名",
          "description": "本次任务提交时填写的用户名"
        },
        "no_data": {
          "type": "boolean",
          "title": "无数据",
          "description": "该用户名是否未采集到有效账号资料"
        }
      },
      "required": [],
      "additionalProperties": false
    }
  },
  "execution": {
    "mode": "async",
    "timeout_seconds": 2100,
    "cancel_notify": false,
    "recovers_partial_on_cancel": false
  },
  "knowledge": {
    "when_to_use": [
      "需要批量获取 TikTok 账号的公开资料（昵称、粉丝数、简介等）时",
      "做达人筛选、竞品账号盘点或 KOL 名单 enrichment 时需要结构化账号字段时"
    ],
    "when_not_to_use": [
      "需要账号下的视频列表或评论内容时——用内容采集类 App",
      "需要秒级返回单个账号信息时——本 App 为后台任务模式"
    ],
    "failure_handling": [
      "任务失败或过期可原样重新提交；部分账号失败时仍可拉取已成功账号的结果",
      "用户名不存在或账号未公开时，对应记录可能标记为无数据，属正常结果而非系统错误",
      "鉴权失败属不可重试错误，需先配置有效 API 密钥"
    ]
  },
  "pricing": {
    "events": [
      {
        "event": "start",
        "label": "提交一次采集任务",
        "unit_price": 0.05,
        "qty_from": "",
        "unit_size": null
      },
      {
        "event": "record",
        "label": "返回一条账号资料",
        "unit_price": 0.006,
        "qty_from": "",
        "unit_size": 1
      }
    ]
  },
  "examples": [
    {
      "id": "basic",
      "goal": "采集单个 TikTok 账号的公开资料",
      "input": {
        "accounts": [
          {
            "account": "niogitsune"
          }
        ]
      },
      "use_as_test": true
    },
    {
      "id": "batch",
      "goal": "批量采集两个 TikTok 账号的公开资料",
      "input": {
        "accounts": [
          {
            "account": "niogitsune"
          },
          {
            "account": "theleakfreak"
          }
        ]
      },
      "use_as_test": false
    }
  ],
  "published_at": "2026-09-03T01:50:43.090199+00:00",
  "publisher": {
    "id": "SpiderKing999",
    "name": "SpiderKing999"
  },
  "maintainers": [
    {
      "id": "SpiderKing999",
      "name": "SpiderKing999"
    }
  ],
  "trust_tier": "community",
  "readme": "想知道一批 TikTok 账号的公开资料——昵称、粉丝数、个性签名、认证状态——但逐个打开主页核对太慢？提交用户名清单，任务在后台跑完后，你会拿到一份结构化的账号资料表，可以直接导入表格做筛选和对比。\n\n比起手工复制粘贴主页信息，它把多个账号的公开字段一次拉全并对齐成统一列名，粉丝数、获赞数、地区与认证状态都是取数当时的快照，适合当作达人初筛、竞品账号盘点和 KOL 名单补全的数据底表。\n\n## 数据说明\n\n资料取自 TikTok 公开可见的账号主页信息，按本次提交的用户名逐条对应，每个用户名最多一条记录。粉丝数、获赞数、作品数等统计字段是取数当时的公开数值，不含私密或未公开信息；认证状态、地区、语言等同样是主页公开展示的内容。用户名不存在、账号未公开或暂无资料时，对应记录会标记为无数据，这不代表任务失败。仅覆盖公开账号资料，不含视频内容、评论或粉丝明细。\n\n## 结果长什么样\n\n每条记录是一个 TikTok 账号：\n\n| 用户名 | 昵称 | 粉丝数 | 是否认证 | 个性签名 | 提交用户名 |\n|---|---|---|---|---|---|\n| niogitsune | Nio | 27700 | 否 | Cosplayer, pop culture enthusiast... | niogitsune |\n| theleakfreak | The Leak Freak | 3271 | 否 | Pool Leak Detection | theleakfreak |\n\n另有账号编号、获赞总数、地区、采集时间等字段。\n\n## 应用场景\n\n- 做达人初筛时，按「粉丝数」和「是否认证」快速缩小候选名单，再用「个性签名」判断内容方向是否匹配。\n- 做竞品账号盘点时，把「用户名」「昵称」「粉丝数」导出成表，横向对比同品类账号体量分布。\n- 补全 KOL 名单时，用「提交用户名」对齐原始清单，核对「无数据」标记找出无效或已注销账号。\n- 追踪账号变化时，隔段时间对同一批「提交用户名」再跑一次，对比「粉丝数」和「作品数」的增减。\n",
  "favorite_count": 1,
  "labels": {
    "industry": [
      {
        "slug": "social_media",
        "label": "社交媒体"
      }
    ],
    "platform": [
      {
        "slug": "tiktok",
        "label": "TikTok"
      }
    ],
    "content": [
      {
        "slug": "account",
        "label": "账号主页"
      }
    ]
  },
  "display_locale": "zh-CN",
  "translation_origin": null,
  "version": "0.1.3"
}