{
  "spec_version": "0.2",
  "namespace": "mona_kk",
  "app_name": "youtube-account-info",
  "app_id": "app_aaf69ae06ac3",
  "status": "published",
  "open_to": "public",
  "accepting_runs": true,
  "source_locale": "zh-CN",
  "identity": {
    "app_name": "youtube-account-info",
    "name": "YouTube 账号信息采集",
    "summary": "提交一个 YouTube 账号或频道，返回该账号的公开资料：名称、粉丝数、国家、关联链接等",
    "type": "data",
    "version": "0.1.2"
  },
  "discovery": {
    "capability": "data-acquisition",
    "keywords": [
      "YouTube",
      "账号",
      "粉丝",
      "频道",
      "社媒资料"
    ],
    "boundary": "每次提交一个 YouTube 账号，返回该账号的一条公开资料记录；仅含上游已开放的公开资料，不含私密数据。"
  },
  "input": {
    "schema": {
      "type": "object",
      "properties": {
        "account": {
          "type": "string",
          "title": "YouTube 账号",
          "description": "要采集的 YouTube 账号或频道名称（handle、@handle 或频道链接均可，长度不超过 512 字符），一次提交一个；多个账号请分次调用。",
          "prefill": "UlanziJapan"
        }
      },
      "required": [
        "account"
      ],
      "additionalProperties": false
    }
  },
  "output": {
    "id_field": "account_id",
    "schema": {
      "type": "object",
      "properties": {
        "account_id": {
          "type": "string",
          "title": "账号ID",
          "description": "YouTube 频道唯一标识，以 UC 开头"
        },
        "account_name": {
          "type": "string",
          "title": "账号名称",
          "description": "频道展示名称"
        },
        "biz_id": {
          "type": "string",
          "title": "业务ID",
          "description": "账号 @handle 标识"
        },
        "account_home_url": {
          "type": "string",
          "title": "主页链接",
          "description": "YouTube 频道主页地址"
        },
        "keyword": {
          "type": "string",
          "title": "采集关键词",
          "description": "提交时填写的账号或频道名称"
        },
        "country": {
          "type": "string",
          "title": "国家地区",
          "description": "账号所属国家/地区"
        },
        "location": {
          "type": "string",
          "title": "所在地",
          "description": "账号资料中填写的所在地"
        },
        "joined_date": {
          "type": "string",
          "title": "加入时间",
          "description": "频道创建时间"
        },
        "fans_count": {
          "type": "string",
          "title": "粉丝数",
          "description": "频道粉丝总数"
        },
        "fan_nums_origin": {
          "type": "string",
          "title": "原始粉丝数",
          "description": "上游原始口径统计的粉丝数"
        },
        "views_num": {
          "type": "string",
          "title": "观看数",
          "description": "频道视频总观看次数"
        },
        "publish_content_count": {
          "type": "string",
          "title": "内容数",
          "description": "已发布内容条数"
        },
        "email": {
          "type": "string",
          "title": "联系邮箱",
          "description": "账号公开的联系邮箱"
        },
        "links": {
          "type": "string",
          "title": "关联链接",
          "description": "关联的社媒与官网链接，以文本形式给出"
        },
        "clean_update_time": {
          "type": "string",
          "title": "数据更新时间",
          "description": "数据最近一次更新时间"
        },
        "crawl_time": {
          "type": "string",
          "title": "采集时间",
          "description": "本次采集发生的时间"
        }
      },
      "required": [],
      "additionalProperties": false
    }
  },
  "execution": {
    "mode": "async",
    "timeout_seconds": 2000,
    "cancel_notify": false,
    "recovers_partial_on_cancel": false
  },
  "knowledge": {
    "when_to_use": [
      "需要获取某个 YouTube 账号或频道的公开资料（名称、粉丝数、国家、关联社媒）时",
      "做红人/KOL 盘点、竞品频道摸底，需要拿到频道基础数据时"
    ],
    "when_not_to_use": [
      "需要视频级数据（分视频播放量、评论）时——本接口只返回账号级资料",
      "需要私信或互动类等非公开数据时——仅覆盖公开资料"
    ],
    "failure_handling": [
      "返回空记录通常是账号名拼写错误或上游未找到，核对 handle 后重试",
      "鉴权失败属不可重试错误，需先在执行环境配置上游 API Key",
      "任务状态长时间处于处理中可原样重新提交"
    ]
  },
  "pricing": {
    "events": [
      {
        "event": "start",
        "label": "提交一次采集",
        "unit_price": 0.05,
        "qty_from": "",
        "unit_size": null
      },
      {
        "event": "record",
        "label": "返回一条账号资料",
        "unit_price": 0.003,
        "qty_from": "",
        "unit_size": 1
      }
    ]
  },
  "examples": [
    {
      "id": "basic",
      "goal": "采集 UlanziJapan 账号的公开资料",
      "input": {
        "account": "UlanziJapan"
      },
      "use_as_test": true
    },
    {
      "id": "by-handle",
      "goal": "换一个频道名采集，验证不同账号取值",
      "input": {
        "account": "drivethrumedia_official"
      },
      "use_as_test": false
    }
  ],
  "published_at": "2026-09-03T02:33:56.645874+00:00",
  "publisher": {
    "id": "mona_kk",
    "name": "mona_kk"
  },
  "maintainers": [
    {
      "id": "mona_kk",
      "name": "mona_kk"
    }
  ],
  "trust_tier": "community",
  "readme": "想知道某个 YouTube 账号到底什么来头——它叫什么、在哪、有多少粉丝、还挂着哪些社媒？给它一个账号或频道名，它会在后台跑一次采集任务，把该账号的公开资料整理成一条结构化的记录返回，可以直接进表格做红人盘点、竞品摸底或渠道摸底。\n\n相比人工点开频道页一块块抄，它把名称、粉丝数、国家、关联链接这些散落在主页各处的信息一次收齐，是取数当时的快照，适合当作社媒资产盘点的底表。\n\n## 数据说明\n\n资料取自 YouTube 公开频道信息，按上游已开放的公开资料返回，同一个账号只出一条记录。粉丝数、观看数、内容数是取数当时的快照值，不含涨粉曲线与历史变化；关联链接是频道自行填写的社媒与官网，以文本形式给出。只覆盖公开可见的资料，私信、互动、收益等非公开数据不在其中。\n\n## 结果长什么样\n\n每条记录是一个 YouTube 账号的公开资料：\n\n| 账号名称 | 粉丝数 | 国家地区 | 主页链接 |\n|---|---|---|---|\n| Drive Thru Media | 1410 | 澳大利亚 | https://www.youtube.com/@drivethrumedia_official |\n| Ulanzi Japan | 188413 | 日本 | https://www.youtube.com/@UlanziJapan |\n\n另有所属账号ID、业务ID、所在地、加入时间、观看数、内容数、联系邮箱、关联链接、数据更新时间与采集时间等信息。\n\n## 应用场景\n\n- 做红人筛选时，按「粉丝数」排优先级、结合「国家地区」锁定目标市场，快速缩出一份候选清单。\n- 做渠道摸底时，把「关联链接」解析出 TikTok、Instagram、官网等外链，看一个账号在哪些平台有布局。\n- 做竞品监测时，隔段时间跑同一批账号，比对「粉丝数」「观看数」的变化判断增长势头。\n- 做账号归档时，用「账号ID」「业务ID」给每个频道打稳定标签，避免同一账号因改名而重复录入。\n",
  "favorite_count": 1,
  "labels": {
    "industry": [
      {
        "slug": "social_media",
        "label": "社交媒体"
      }
    ],
    "platform": [
      {
        "slug": "youtube",
        "label": "YouTube"
      }
    ],
    "content": [
      {
        "slug": "account",
        "label": "账号主页"
      }
    ]
  },
  "display_locale": "zh-CN",
  "translation_origin": null,
  "version": "0.1.2"
}