---
title: "Upload Video from Platform URL"
method: POST
path: "/serve/api/v1/scraper_url"
---

# Upload Video from Platform URL

`POST /serve/api/v1/scraper_url`

## Request body

- UploadVideoFromPlatformUrlRequest
  - `video_urls` string[], 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_urls` string[] — Optional TikTok post URLs. Server merges these into video_urls before processing. Counts toward the 50-URL cap.
  - `callback_url` string, 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_id` integer — 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.

## Response `200`

Successful response

- ScraperTaskResponse
  - `code` string — Business status code. 0000 indicates success.
  - `msg` string
  - `data` object
    - `taskId` string — Unique identifier of the scraping task.
  - `success` boolean
  - `failed` boolean

---

[API](https://skmtc.net/memories/apis/screenplay-extraction-api.md) · [All operations](https://skmtc.net/memories/apis/screenplay-extraction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memories/screenplay-extraction-api/versions/720c8c144ddc/schema)