v1

latestOpenAPI 3.1.02026-07-266827131.9 KB

Upload Video from Platform URL

post/serve/api/v1/scraper_url

Request body

video_urlsstring[] required

Platform video URLs. Merged with tiktok_post_urls; combined list must be non-empty and <= 50. All URLs must be from the same platform.

tiktok_post_urlsstring[]

Optional TikTok post URLs. Server merges these into video_urls before processing. Counts toward the 50-URL cap.

callback_urlstring uri

Callback URL for task-complete and per-video indexing-complete notifications.

quality'360' | '480' | '720' | '1080' | '1440' | '2160'

Target video resolution. Must be one of 360/480/720/1080/1440/2160 (string).

folder_idinteger

Optional target folder for the upload. Omit or pass -1 for the account's Default folder (auto-created on first use). A positive id must belong to your account.

Example request

{
  "video_urls": [
    "https://www.tiktok.com/@cutshall73/video/7543017294226558221",
    "https://www.tiktok.com/@abcnews/video/7543794552365124919"
  ],
  "callback_url": "https://your.app/callback",
  "quality": "1080",
  "folder_id": 671631448308117500
}

Response

Successful response

codestring

Business status code. 0000 indicates success.

msgstring

successboolean

failedboolean

Example response

{
  "code": "0000",
  "msg": "success",
  "data": {
    "taskId": "31b0fccb-d6f9-4135-922d-1e8828499812"
  },
  "success": true,
  "failed": false
}