查看原始 JSON
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"title": "Input schema for TikTok scraper",
"required": [
"postURLs"
],
"properties": {
"postURLs": {
"type": "array",
"title": "Direct URL(s) for scraping specific video(s)",
"editor": "stringList",
"default": [
"https://www.tiktok.com/@apifylife/video/7200360993149553925"
],
"example": [
"https://www.tiktok.com/@apifylife/video/7200360993149553925"
],
"prefill": [
"https://www.tiktok.com/@apifylife/video/7200360993149553925"
],
"description": "必填列表,每项为公开 TikTok 帖子的链接字符串。原生默认值、示例和预填值均指向同一个 Apifylife 示例帖子;请明确提供本次要获取的帖子,直接在列表中填写链接。"
},
"resultsPerPage": {
"type": "integer",
"unit": "videos",
"title": "💯 Number of related videos per post",
"default": 1,
"example": 100,
"maximum": 1000000,
"minimum": 1,
"prefill": 100,
"description": "可选,仅在 scrapeRelatedVideos 为 true 时生效,分别限制每个输入帖子链接的相关视频数量。整数范围为 1 至 1,000,000,默认 1,表单预填值和示例为 100。它不是整次请求的总上限,也不保证返回指定数量。"
},
"scrapeRelatedVideos": {
"type": "boolean",
"title": "Scrape related videos",
"editor": "checkbox",
"default": false,
"example": false,
"description": "可选,默认 false。设为 true 时,请求采集输入帖子的相关视频,由 resultsPerPage 分别限制每个输入帖子的相关记录。启用后,采集范围会扩展到已选原帖之外。",
"sectionCaption": "🔗 Related videos"
},
"shouldDownloadCovers": {
"type": "boolean",
"title": "Include thumbnails",
"editor": "checkbox",
"default": false,
"example": false,
"description": "可选,默认 false。设为 true 时,请求下载视频封面或缩略图,可能增加提取时间和费用;按实际返回的引用使用,不假定文件已交付到本地。"
},
"shouldDownloadVideos": {
"type": "boolean",
"title": "⬇️ Add-on: video download ($)",
"editor": "checkbox",
"default": false,
"example": false,
"description": "可选的收费视频下载附加项,默认 false。设为 true 时,请求下载至 Apify 存储,可通过 videoKvStoreIdOrName 指定存储。仅说明实际可用的返回链接,不假定本地文件或长期访问一定可用。",
"sectionCaption": "📹 Download TikTok videos",
"sectionDescription": "You can download scraped TikTok videos to your storage. Links to the downloaded videos will be stored in the dataset (field <code>mediaUrls</code>). Unlike TikTok CDN URLs, they won't expire after scraping has finished. <br> You can also find all downloaded files in the <strong>📦 Storage sidebar → Key-value stores tab</strong>."
},
"videoKvStoreIdOrName": {
"type": "string",
"title": "✍️ Name your storage for videos",
"editor": "textfield",
"example": "tiktok-videos",
"pattern": "^[a-zA-Z0-9-]+$",
"description": "可选,指定存放已下载视频及其他媒体的 Apify 键值存储名称或 ID;省略时使用默认存储。名称可含字母、数字或连字符,不能有空格。这是 Apify 存储,不是本地文件夹,也不保证永久保留。",
"resourceType": "keyValueStore",
"resourcePermissions": [
"READ",
"WRITE"
]
},
"downloadSubtitlesOptions": {
"enum": [
"NEVER_DOWNLOAD_SUBTITLES",
"DOWNLOAD_SUBTITLES",
"DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES",
"TRANSCRIBE_ALL_VIDEOS"
],
"type": "string",
"title": "Subtitles & Transcription",
"editor": "select",
"default": "NEVER_DOWNLOAD_SUBTITLES",
"example": "NEVER_DOWNLOAD_SUBTITLES",
"enumTitles": [
"Don't download subtitles",
"Download subtitles (only when present on the video)",
"Download subtitles + transcribe videos without subtitles (using speech-to-text models) ($)",
"Transcribe all videos (using speech-to-text models) ($)"
],
"description": "可选。默认 NEVER_DOWNLOAD_SUBTITLES,不处理字幕或转写;DOWNLOAD_SUBTITLES 仅采集视频已有字幕;DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES 采集已有字幕,没有字幕时使用 AI 将语音转成文字;TRANSCRIBE_ALL_VIDEOS 对所有输入视频使用 AI 转写。AI 转写额外收费,不保证准确度、语言或实际返回文本或引用的格式。",
"sectionCaption": "📝 Download TikTok subtitles or transcription ($)",
"sectionDescription": "Choose how to handle subtitles and audio transcription for the input videos."
},
"shouldDownloadSlideshowImages": {
"type": "boolean",
"title": "Download slideshow images",
"editor": "checkbox",
"default": false,
"example": false,
"description": "可选,默认 false。设为 true 时,请求下载图集帖子的图片,可能增加采集时间和费用;可用返回引用本身不证明文件已交付到本地。"
}
},
"description": "必填请求对象,包含已选帖子链接。采集相关视频、下载媒体、选择存储以及处理字幕或语音转写,均为可选设置。",
"schemaVersion": 1
}
},
"additionalProperties": false
}