{
  "spec_version": "0.2",
  "namespace": "SpiderKing999",
  "app_name": "tiktok-account-video-list",
  "app_id": "app_2b4cb39e2a83",
  "status": "published",
  "open_to": "public",
  "accepting_runs": true,
  "source_locale": "zh-CN",
  "identity": {
    "app_name": "tiktok-account-video-list",
    "name": "TikTok 用户视频列表",
    "summary": "给一个 TikTok 用户名，返回该用户按采集时间排序的公开视频记录",
    "type": "data",
    "version": "0.1.0"
  },
  "discovery": {
    "capability": "data-acquisition",
    "keywords": [
      "TikTok",
      "用户视频",
      "账号视频",
      "视频列表",
      "公开内容"
    ],
    "boundary": "单次任务处理 1 个 TikTok 用户名，最多采集 100 页、每页 35 条视频（最多 3500 条）；仅覆盖公开可见内容。"
  },
  "input": {
    "schema": {
      "type": "object",
      "properties": {
        "account": {
          "type": "string",
          "title": "TikTok 用户名",
          "description": "要采集的 TikTok 用户名，每次任务只处理一个；长度不得超过 512 个字符",
          "prefill": "snaikseven"
        },
        "crawl_num": {
          "type": "integer",
          "title": "期望采集数量",
          "description": "本次任务期望采集的视频数量，取值 1–3500；按每页 35 条、最多 100 页采集，实际返回数量可能受公开内容数量影响",
          "minimum": 1,
          "maximum": 3500,
          "prefill": 35
        }
      },
      "required": [
        "account",
        "crawl_num"
      ],
      "additionalProperties": false
    }
  },
  "output": {
    "id_field": "content_id",
    "schema": {
      "type": "object",
      "properties": {
        "content_id": {
          "type": "string",
          "title": "内容编号",
          "description": "TikTok 视频内容的唯一标识",
          "prefill": "7684177072012430612"
        },
        "crawl_time": {
          "type": "string",
          "title": "采集时间",
          "description": "本条视频被采集的时间",
          "prefill": "2026-09-21T12:03:12"
        },
        "keyword": {
          "type": "string",
          "title": "用户名",
          "description": "本条视频对应的 TikTok 用户名",
          "prefill": "Shokz"
        },
        "keyword_type": {
          "type": "string",
          "title": "用户名类型",
          "description": "采集来源的类型；账号采集时为 account",
          "prefill": "account"
        },
        "source_item": {
          "type": "string",
          "title": "任务项",
          "description": "本条记录对应的任务项用户名",
          "prefill": "snaikseven"
        },
        "no_data": {
          "type": "boolean",
          "title": "是否无数据",
          "description": "该任务项是否没有采集到公开视频",
          "prefill": false
        }
      },
      "required": [],
      "additionalProperties": false
    }
  },
  "execution": {
    "mode": "async",
    "timeout_seconds": 1860,
    "cancel_notify": false,
    "recovers_partial_on_cancel": false
  },
  "knowledge": {
    "when_to_use": [
      "需要按 TikTok 用户名获取该用户公开视频列表时",
      "需要按采集时间顺序整理 TikTok 用户视频内容编号和采集时间时"
    ],
    "when_not_to_use": [
      "只需要 TikTok 用户主页资料而不需要视频列表时——本 App 返回视频记录",
      "需要私密、已删除、受限或登录后可见内容时——本 App 仅覆盖公开可见内容"
    ],
    "failure_handling": [
      "返回无数据标记时可核对 TikTok 用户名，或确认该用户是否有公开可见视频",
      "任务仍在采集时不要把空页当作完成，应结合任务状态判断",
      "限流、服务暂不可用或请求超时可稍后使用相同输入重试",
      "任务提交结果不明时不要连续重复提交，避免产生重复任务",
      "鉴权失败需先检查执行环境中的 API Key 配置"
    ]
  },
  "pricing": {
    "events": [
      {
        "event": "record",
        "label": "每 35 条视频记录",
        "unit_price": 0.018,
        "qty_from": "",
        "unit_size": 35
      },
      {
        "event": "start",
        "label": "提交一次任务",
        "unit_price": 0.001,
        "qty_from": "",
        "unit_size": null
      }
    ]
  },
  "examples": [
    {
      "id": "basic",
      "goal": "采集 TikTok 用户 snaikseven 的公开视频列表",
      "input": {
        "account": "snaikseven",
        "crawl_num": 35
      },
      "use_as_test": true
    }
  ],
  "published_at": "2026-10-12T10:26:05.853614+00:00",
  "publisher": {
    "id": "SpiderKing999",
    "name": "SpiderKing999"
  },
  "maintainers": [
    {
      "id": "SpiderKing999",
      "name": "SpiderKing999"
    }
  ],
  "trust_tier": "community",
  "readme": "TikTok 用户的视频列表可以帮助你快速了解账号的内容主题、更新节奏和公开内容沉淀。这个 App 按用户名采集公开视频记录，并按采集时间顺序整理成适合分析和留存的内容清单。\r\n\r\n相比逐条浏览账号主页，这份列表更适合建立账号内容底表、保存采集快照，并在多次采集后对比内容变化。\r\n\r\n## 数据说明\r\n\r\n数据取自指定 TikTok 用户在采集时公开可见的视频内容。内容编号用于识别同一视频，用户名与用户名类型用于标识采集来源，采集时间记录本次采集到该内容的时间。结果按采集时间正序返回；公开内容数量不足、内容不可见或账号没有公开视频时，返回数量可能少于期望值，并保留无数据标记。私密、已删除、受限或登录后可见的视频不在结果中。\r\n\r\n## 结果长什么样\r\n\r\n每条正常记录代表指定 TikTok 用户的一条公开视频：\r\n\r\n| 内容编号 | 用户名 | 用户名类型 | 采集时间 | 任务项 | 是否无数据 |\r\n|---|---|---|---|---|---|\r\n| 7684177072012430612 | Shokz | account | 2026-09-21T12:03:12 | snaikseven | false |\r\n\r\n此外还会提供内容来源标识，便于将多次任务或多个账号的结果进行归并。\r\n\r\n## 应用场景\r\n\r\n- 做账号内容盘点时，按「用户名」或「任务项」汇总「内容编号」，建立账号的视频资产清单。\r\n- 研究更新节奏时，结合「采集时间」观察账号公开视频的持续产出情况。\r\n- 做公开内容监测时，对比不同时间采集的结果，发现内容新增或公开状态变化。\r\n",
  "favorite_count": 0,
  "labels": {
    "industry": [
      {
        "slug": "social_media",
        "label": "社交媒体"
      }
    ],
    "platform": [
      {
        "slug": "tiktok",
        "label": "TikTok"
      }
    ],
    "content": [
      {
        "slug": "video",
        "label": "视频"
      },
      {
        "slug": "account",
        "label": "账号主页"
      }
    ]
  },
  "display_locale": "zh-CN",
  "translation_origin": null,
  "version": "0.1.0"
}