搜索与获取 TikTok 公开数据

{
  "type": "object",
  "required": [],
  "properties": {
    "body": {
      "type": "object",
      "title": "Full TikTok API Scraper",
      "properties": {
        "music_id": {
          "type": "string",
          "title": "music_id",
          "editor": "textfield",
          "default": "",
          "description": "可选音乐曲目 ID 字符串，默认空。请求该曲目的可用标题、创作者、时长或使用计数等资料。原样保留 ID；它与获取使用该音乐的帖子分开，不交付已获许可的音频文件。",
          "sectionCaption": "Get Music",
          "sectionDescription": "Retrieve detailed information about a specific TikTok music track including title, artist, duration, and usage statistics. You'll need the music_id which can be found in video post data or music search results."
        },
        "post_region": {
          "type": "string",
          "title": "region",
          "editor": "textfield",
          "default": "GB",
          "description": "可选，单帖请求的两字母地区提示，默认 GB。可能影响来源结果，不验证创作者居住地，不代表覆盖该国全部帖子，也不绕过访问限制。"
        },
        "post_awemeId": {
          "type": "string",
          "title": "aweme_id",
          "editor": "textfield",
          "default": "",
          "description": "可选帖子或视频 ID 字符串，默认空。请求已选公开帖子的可用描述、创作者或音乐背景、来源互动数及引用地址。填写 ID 而非链接；评论数量不等于评论正文。",
          "sectionCaption": "Get Post",
          "sectionDescription": "Retrieve detailed information about a specific TikTok video post including video URL, description, likes, comments, shares, and creator details. You'll need the aweme_id (video ID) which can be found in TikTok video URLs."
        },
        "profile_region": {
          "type": "string",
          "title": "region",
          "editor": "textfield",
          "default": "GB",
          "description": "可选，账号资料查询的两字母地区提示，默认 GB。可能影响来源结果，不证明账号居住地或身份，也不代表完整国家覆盖。"
        },
        "profile_userId": {
          "type": "string",
          "title": "user_id",
          "editor": "textfield",
          "default": "",
          "description": "可选，已选账号的准确用户 ID 字符串，默认空。看似大整数的 ID 仍按字符串原样保留。这用于账号资料查询，不自动请求帖子或粉丝列表；不应假设它优先于另一个已填账号标识符。"
        },
        "followers_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 10,
          "description": "可选整数，默认 10，请求本页粉丝账号数量。实际条数可能不同；它不是账号粉丝总数，不保证完整列表，也不是费用上限。"
        },
        "following_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 10,
          "description": "可选整数，默认 10，请求该用户关注的账号单页数量。实际条数可能不同；这与粉丝列表分开，不保证完整名单。"
        },
        "userLikes_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 10,
          "description": "可选整数，默认 10，请求一页可访问的点赞帖子。它不代表完整点赞记录、观看活动或私密行为，实际条数可能不同。"
        },
        "userPosts_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 10,
          "description": "可选整数，默认 10，请求该用户可用帖子的一页。它不保证固定条数、最新排序或完整发布历史。"
        },
        "followers_userId": {
          "type": "string",
          "title": "user_id",
          "editor": "textfield",
          "default": "",
          "description": "可选准确用户 ID 字符串，默认空，选择要获取谁的粉丝。填写 ID 而非用户名或链接；它不请求该用户关注的账号，也不保证粉丝资料可获取。",
          "sectionCaption": "List Followers",
          "sectionDescription": "Get a list of users who follow a specific TikTok account. You'll need the user ID (obtained from the Username to ID section) to fetch followers. Use pagination to get more than the default 10 followers."
        },
        "following_userId": {
          "type": "string",
          "title": "user_id",
          "editor": "textfield",
          "default": "",
          "description": "可选准确用户 ID 字符串，默认空，选择要获取谁关注的账号。这是关注方向，与粉丝列表不同；保持 ID 为字符串。",
          "sectionCaption": "List Following",
          "sectionDescription": "Get a list of users that a specific TikTok account follows. You'll need the user ID (obtained from the Username to ID section) to fetch the following list. Use pagination to get more than the default 10 accounts."
        },
        "musicPosts_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 18,
          "description": "可选整数，默认 18，请求使用所选音乐的一页帖子。不保证该曲目的全部使用记录、固定条数或完整趋势历史。"
        },
        "profile_username": {
          "type": "string",
          "title": "username",
          "editor": "textfield",
          "default": "",
          "description": "可选，不带 @ 的用户名字符串，默认空。选择要查询的公开账号，例如 katyperry；不自动获取帖子、账号列表或为后续调用转换 ID。同时提供其他账号标识符时，不应假设优先顺序。",
          "sectionCaption": "Get User/Profile",
          "sectionDescription": "Retrieve detailed information about a TikTok user profile including follower count, bio, verified status, and account details. This is the most common starting point - you only need the username (without @) to get comprehensive profile data."
        },
        "userLikes_userId": {
          "type": "string",
          "title": "user_id",
          "editor": "textfield",
          "default": "",
          "description": "可选准确用户 ID 字符串，默认空，请求该账号可访问的点赞帖子。它与已发布帖子分开，不授予隐藏点赞或私密账号活动的访问权限。",
          "sectionCaption": "User Likes",
          "sectionDescription": "Get all videos that a specific user has liked. You'll need the user ID (obtained from the Username to ID section) to fetch their liked posts. Use pagination to get more than the default 10 liked posts."
        },
        "userPosts_region": {
          "type": "string",
          "title": "region",
          "editor": "textfield",
          "default": "GB",
          "description": "可选，账号帖子查询的两字母地区提示，默认 GB。可能影响来源结果，不验证用户居住地，也不保证获取该国全部帖子。"
        },
        "userPosts_userId": {
          "type": "string",
          "title": "user_id",
          "editor": "textfield",
          "default": "",
          "description": "可选准确用户 ID 字符串，默认空，选择要获取谁的可用已发布帖子。它与点赞帖子及账号资料分开，不保证取得全部历史帖子。",
          "sectionCaption": "User Posts",
          "sectionDescription": "Get all video posts from a specific TikTok user. You'll need the user ID (obtained from the Username to ID section) to fetch their posts. Use pagination to get more than the default 10 posts."
        },
        "followers_maxTime": {
          "type": "integer",
          "title": "max_time",
          "editor": "number",
          "default": 0,
          "description": "可选整数游标，默认 0。请求另一页粉丝时，使用同一列表上一响应实际返回的 min_time 值。它不是日期筛选，也不能通过加一自行编造，不保证还有下一页。"
        },
        "following_maxTime": {
          "type": "integer",
          "title": "max_time",
          "editor": "number",
          "default": 0,
          "description": "可选整数游标，默认 0。请求另一页关注账号时，使用同一列表上一响应实际返回的 min_time 值。它不是日期范围或粉丝列表游标，也不自动采集完整名单。"
        },
        "musicPosts_cursor": {
          "type": "integer",
          "title": "cursor",
          "editor": "number",
          "default": 0,
          "description": "可选整数游标，默认 0，用于所选音乐的帖子列表。再次请求时使用该列表实际提供的游标；不把它当日期，也不假设加一便得到下一页。"
        },
        "profile_secUserId": {
          "type": "string",
          "title": "sec_user_id",
          "editor": "textfield",
          "default": "",
          "description": "可选次级用户 ID 字符串，默认空，用于账号资料分区的 TikTok 账号标识。原样保留，不把它当用户名、数值 ID，或其他已填标识符失败后的自动替代。"
        },
        "searchLives_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 20,
          "description": "可选整数，默认 20，请求直播搜索一页的列表数量。实际条数可能不同，不保证持续访问直播、稳定直播状态或取得所有匹配直播。"
        },
        "searchPosts_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 10,
          "description": "可选整数，默认 10，请求帖子搜索一页的匹配数量。这是单页请求数量，不是精确总数、全站排名或完整关键词覆盖。"
        },
        "searchUsers_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 20,
          "description": "可选整数，默认 20，请求一页匹配用户记录。结果可能不完整或更少，不保证取得全部匹配用户或验证真实身份。"
        },
        "challengePosts_cid": {
          "type": "string",
          "title": "cid",
          "editor": "textfield",
          "default": "",
          "description": "可选标签或挑战 ID 字符串，默认空，用于获取关联帖子。填写已有 cid 而非标签关键词；不自动搜索 ID，也不保证取得全部参与记录。",
          "sectionCaption": "Hashtag Posts (aka Challenge)",
          "sectionDescription": "Get all video posts that participate in a specific TikTok hashtag (aka challenge). You'll need the challenge ID (cid) which can be found in hashtag search results or challenge URLs. Use pagination to get more than the default 20 posts."
        },
        "listComments_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 10,
          "description": "可选整数，默认 10，请求所选视频的一页顶层评论。它与回复数量分开，不保证固定条数或完整讨论。"
        },
        "musicPosts_musicId": {
          "type": "string",
          "title": "music_id",
          "editor": "textfield",
          "default": "",
          "description": "可选音乐 ID 字符串，默认空，选择使用该曲目的帖子。这是帖子列表请求，与音乐资料分开，不代表完整使用历史或媒体下载。",
          "sectionCaption": "Music Posts",
          "sectionDescription": "Get all video posts that use a specific TikTok music track. You'll need the music_id (obtained from the Get Music section or video post data) to find all videos using that sound. Use pagination to get more than the default 18 posts."
        },
        "searchLives_offset": {
          "type": "integer",
          "title": "offset",
          "editor": "number",
          "default": 0,
          "description": "可选整数偏移量，默认 0，用于当前直播搜索。若返回分页信息，再为同一关键词使用该实际信息；它不是时间戳、稳定直播序号，也不保证有更多结果。"
        },
        "searchPosts_offset": {
          "type": "integer",
          "title": "offset",
          "editor": "number",
          "default": 0,
          "description": "可选整数偏移量，默认 0，用于已选帖子搜索。保持与同一查询和设置对应，有实际继续请求信息时按该信息使用。它不是日期，不保证完整或无重复分页。"
        },
        "searchPosts_region": {
          "type": "string",
          "title": "region",
          "editor": "textfield",
          "default": "GB",
          "description": "可选两字母地区提示，默认 GB，用于帖子搜索。可能影响可用搜索结果，不证明创作者居住地，也不代表完整覆盖某国内容。"
        },
        "searchSounds_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 10,
          "description": "可选整数，默认 10，请求一页匹配声音。不保证全部匹配曲目、固定条数或交付音频文件。"
        },
        "searchUsers_cursor": {
          "type": "integer",
          "title": "cursor",
          "editor": "number",
          "default": 0,
          "description": "可选整数游标，默认 0，用于同一用户搜索。有实际继续请求值时按返回值使用；不通过加一推断下一页，也不把它当用户 ID。"
        },
        "followers_secUserId": {
          "type": "string",
          "title": "sec_user_id",
          "editor": "textfield",
          "default": "",
          "description": "可选准确次级用户 ID 字符串，默认空，用于粉丝分区标识所属账号。它不是某个粉丝的 ID 或用户名；多个已填标识符没有明确优先顺序。"
        },
        "following_secUserId": {
          "type": "string",
          "title": "sec_user_id",
          "editor": "textfield",
          "default": "",
          "description": "可选次级用户 ID 字符串，默认空，用于已选账号的关注列表。保持原样并与该账号对应；它不标识某个被关注账号，也不保证访问隐藏列表。"
        },
        "listComments_cursor": {
          "type": "integer",
          "title": "cursor",
          "editor": "number",
          "default": 0,
          "description": "可选整数游标，默认 0，用于同一视频的另一页顶层评论。有实际继续请求信息时按该信息使用；不混用回复游标，也不假设会自动获取全部评论。"
        },
        "searchLives_keyword": {
          "type": "string",
          "title": "keyword",
          "editor": "textfield",
          "default": "",
          "description": "可选关键词字符串，默认空。搜索来源在采集时视为正在直播、并匹配标题或创作者背景的可用列表。列表记录不等于持续直播、录像或后续直播访问保证。",
          "sectionCaption": "Search Lives",
          "sectionDescription": "Search for currently live TikTok streams by keyword. This will return active live streams that match your search term in their title or creator name. Use pagination to get more than the default 20 results."
        },
        "searchPosts_keyword": {
          "type": "string",
          "title": "keyword",
          "editor": "textfield",
          "default": "",
          "description": "可选关键词字符串，默认空，请求可用匹配视频帖子。来源匹配可能使用描述或标签，不应假设完整全文检索、视觉内容理解或获取全部匹配 TikTok 帖子。",
          "sectionCaption": "Search Posts",
          "sectionDescription": "Search for TikTok video posts by keyword. This will return videos that match your search term in their description, hashtags, or content. You can filter by publish time and sort by relevance, likes, or date."
        },
        "searchSounds_cursor": {
          "type": "integer",
          "title": "cursor",
          "editor": "number",
          "default": 0,
          "description": "可选整数游标，默认 0，用于同一声音搜索。若返回实际继续请求信息则按其使用，不编造下一游标，也不假设完整或无重复曲目覆盖。"
        },
        "searchSounds_region": {
          "type": "string",
          "title": "region",
          "editor": "textfield",
          "default": "GB",
          "description": "可选，声音搜索的两字母地区提示，默认 GB。可能影响来源结果，不证明创作者所在地，也不授予音乐使用权。"
        },
        "searchUsers_keyword": {
          "type": "string",
          "title": "keyword",
          "editor": "textfield",
          "default": "",
          "description": "可选关键词字符串，默认空。请求用户名或显示名称匹配的可用用户。这些是来源账号记录，不是独立身份核实或私密分析，也不保证取得所有匹配账号。",
          "sectionCaption": "Search Users",
          "sectionDescription": "Search for TikTok users by keyword. This will return a list of users whose usernames or display names match your search term. Use pagination to get more than the default 20 results."
        },
        "userLikes_maxCursor": {
          "type": "string",
          "title": "max_cursor",
          "editor": "textfield",
          "default": "0",
          "description": "可选字符串游标，默认 \"0\"，用于已选用户的点赞帖子列表。完整保留字符串，为同一列表使用实际继续请求值；不转成数值或日期，也不假设它授予隐藏列表访问权。"
        },
        "userPosts_maxCursor": {
          "type": "string",
          "title": "max_cursor",
          "editor": "textfield",
          "default": "0",
          "description": "可选字符串游标，默认 \"0\"，用于已选用户的帖子列表。原样保留，为该列表使用实际继续请求信息；它不是发布日期、数值页码，也不自动获取完整历史。"
        },
        "userPosts_secUserId": {
          "type": "string",
          "title": "sec_user_id",
          "editor": "textfield",
          "default": "",
          "description": "可选次级用户 ID 字符串，默认空，用于已选用户的帖子列表。原样保留并对应该账号；不应假设它优先于 userPosts_userId，也不自动转换标识符。"
        },
        "challengePosts_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 20,
          "description": "可选整数，默认 20，请求所选挑战 ID 关联的一页帖子。实际条数可能不同，不保证参与总数或完整历史。"
        },
        "commentReplies_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 10,
          "description": "可选整数，默认 10，请求指定上级评论下的一页回复。它与顶层评论数量分开，不保证固定条数或完整对话。"
        },
        "listComments_awemeId": {
          "type": "string",
          "title": "aweme_id",
          "editor": "textfield",
          "default": "",
          "description": "可选视频或帖子 ID 字符串，默认空，选择要获取顶层评论的视频。填写 ID 而非链接；回复需另用回复分区，并提供匹配的上级评论和视频 ID。",
          "sectionCaption": "List Comments",
          "sectionDescription": "Get all top-level comments on a specific TikTok video. You'll need the aweme_id (video ID) to fetch the comments. Use pagination to get more than the default 10 comments."
        },
        "searchHashtags_count": {
          "type": "integer",
          "title": "count",
          "editor": "number",
          "default": 20,
          "description": "可选整数，默认 20，请求一页匹配标签记录。它不是标签下的帖子数量，不代表完整标签名单，也不保证精确返回条数。"
        },
        "searchPosts_sortType": {
          "type": "integer",
          "title": "sort_type",
          "editor": "number",
          "default": 0,
          "description": "可选整数，默认 0。来源说明的选项为 0（相关性）、1（点赞最多）、3（日期）。用于排列可用搜索结果，不证明完整全站互动排名，也不保证每条结果的精确位置。"
        },
        "searchSounds_keyword": {
          "type": "string",
          "title": "keyword",
          "editor": "textfield",
          "default": "",
          "description": "可选关键词字符串，默认空。请求匹配曲目标题或创作者背景的可用音乐或声音记录。结果和引用地址不交付音频文件，也不授予许可。",
          "sectionCaption": "Search Sounds",
          "sectionDescription": "Search for TikTok music tracks and sounds by keyword. This will return audio tracks that match your search term in their title or creator name. You can filter by type and sort by relevance, usage, or duration."
        },
        "challengePosts_cursor": {
          "type": "integer",
          "title": "cursor",
          "editor": "number",
          "default": 0,
          "description": "可选整数游标，默认 0，用于同一挑战 ID 的关联帖子。若返回实际继续请求信息则按其使用，不用其他列表的游标，也不编造日期或递增值。"
        },
        "commentReplies_cursor": {
          "type": "integer",
          "title": "cursor",
          "editor": "number",
          "default": 0,
          "description": "可选整数游标，默认 0，用于同一视频、同一上级评论下的回复。若返回实际回复分页信息则按其使用；不混用顶层评论游标，也不据此重建完整回复树。"
        },
        "searchHashtags_cursor": {
          "type": "integer",
          "title": "cursor",
          "editor": "number",
          "default": 0,
          "description": "可选整数游标，默认 0，用于同一标签搜索。有实际继续请求信息时按其使用；它不计算帖子数量，也不保证存在下一页。"
        },
        "searchHashtags_region": {
          "type": "string",
          "title": "region",
          "editor": "textfield",
          "default": "GB",
          "description": "可选，标签搜索的两字母地区提示，默认 GB。可能影响可用结果，不验证创作者居住地，也不代表全国完整标签使用记录。"
        },
        "searchSounds_filterBy": {
          "type": "integer",
          "title": "filter_by",
          "editor": "number",
          "default": 0,
          "description": "可选整数，默认 0。来源说明的选项为 0（全部）、1（标题）、2（创作者）。需要筛选时启用声音筛选开关；这些代码不保证完整或精确匹配。"
        },
        "searchSounds_sortType": {
          "type": "integer",
          "title": "sort_type",
          "editor": "number",
          "default": 0,
          "description": "可选整数，默认 0。来源说明的选项为 0（相关性）、1（使用最多）、2（最新）、3（最短）、4（最长）。排列可用声音搜索结果，不证明完整全站使用情况或精确排名。"
        },
        "usernameToId_username": {
          "type": "string",
          "title": "username",
          "editor": "textfield",
          "default": "",
          "description": "可选不带 @ 的用户名字符串，默认空，请求其可用用户 ID。它与账号资料查询分开，返回 ID 后不自动请求帖子、列表或其他分区。",
          "sectionCaption": "Get Username to ID",
          "sectionDescription": "Convert a TikTok username to its corresponding user ID. This is essential for most other API calls that require user IDs. Use this when you have a username but need the ID for followers, posts, or other data retrieval."
        },
        "commentReplies_awemeId": {
          "type": "string",
          "title": "aweme_id",
          "editor": "textfield",
          "default": "",
          "description": "可选视频或帖子 ID 字符串，默认空。在回复分区与该视频内对应的上级评论 ID 合用；它不是视频链接，也不能替代上级评论 ID。"
        },
        "searchHashtags_keyword": {
          "type": "string",
          "title": "keyword",
          "editor": "textfield",
          "default": "",
          "description": "可选关键词字符串，默认空，请求匹配标签记录和可用来源背景。它与用已知挑战 ID 获取关联帖子分开，不自动采集每个结果下的全部帖子。",
          "sectionCaption": "Search Hashtags",
          "sectionDescription": "Search for TikTok hashtags by keyword. This will return hashtags that match your search term, including their users, view counts, user counts, and posts. Use pagination to get more than the default 20 results."
        },
        "searchPosts_publishTime": {
          "type": "integer",
          "title": "publish_time",
          "editor": "number",
          "default": 0,
          "description": "可选整数，默认 0。来源说明的选项为 0（全部时间）、1（昨天）、7（本周）、30（本月）、90（最近 3 个月）、180（最近 6 个月）。请求来源时间筛选，不保证具体时区、滚动天数或日历边界；全部时间不保证完整历史。"
        },
        "searchSounds_useFilters": {
          "type": "boolean",
          "title": "use_filters",
          "editor": "checkbox",
          "default": false,
          "description": "可选布尔值，默认 false。true 请求启用声音筛选，false 为关闭设置；填写布尔值，而非数值 0 或 1。相关筛选和排序代码是独立设置。"
        },
        "commentReplies_commentId": {
          "type": "string",
          "title": "comment_id",
          "editor": "textfield",
          "default": "",
          "description": "可选上级评论 ID 字符串，默认空。与匹配的视频 ID 合用请求回复；它与获取顶层评论分开，不自动获取全部下级回复或重建缺失的上级背景。",
          "sectionCaption": "List Comment Replies",
          "sectionDescription": "Get all replies to a specific comment on a TikTok video. You'll need both the comment_id and aweme_id (video ID) to fetch the replies. Use pagination to get more than the default 10 replies."
        },
        "videoWithoutWatermark_awemeId": {
          "type": "string",
          "title": "aweme_id",
          "editor": "textfield",
          "default": "",
          "description": "可选视频 ID 字符串，默认空。请求可用的不带 TikTok 水印的直接视频地址。这是链接引用，不交付下载文件，不保证长期播放，也不授予视频再利用许可。",
          "sectionCaption": "Video Without Watermark",
          "sectionDescription": "Download a TikTok video without the TikTok watermark. You'll need the aweme_id (video ID) which can be found in TikTok video URLs. This returns a direct download link to the clean video file."
        }
      },
      "description": "可选，填写本次所需分区的设置。要进行有用请求，需提供对应用户名、ID 或关键词，只填写准备使用的分区。空标识符默认值不代表已选账号或帖子，同时提供多个标识符时没有明确的优先顺序。",
      "schemaVersion": 1
    }
  },
  "additionalProperties": false
}