Youku Video Scraper

🎬 Youku video metadata for research and review

Built for media researchers, content teams, and developers, this Actor searches public Youku videos and series or looks up a video or creator from a public reference. It returns source IDs, titles, page links, visible metadata, search details, and source-hosted playback links when available. This gives you a structured dataset for catalog work, monitoring, and review without a Youku account or API key.

• Submit a public Youku link with the Youku Video Download task.
• Search for Korean dramas with the Youku Korean Drama task.
• Review public Youku videos and series with the Youku Videos task.
• Find public shows with the Youku Series Search task.
• Inspect one public video’s fields with the Youku Video Metadata task.
• Look up a public creator profile with the Youku Creator Profile task.

📦 Youku rows for videos, series, and creators

Row types

Each saved row has a resultType of video, series, or creator. Video rows can include titles, IDs, uploader details, engagement, availability, tags, descriptions, and playback choices. Series rows can include title, year, category, episode count, status, country, rating, cast, directors, and availability. Creator rows can include a public name, avatar, profile link, follower and like totals, verification, and biography. Optional fields appear only when Youku exposes them. Playback links stay on the source and may expire.

▶️ Run a Youku search or lookup

1. Choose search, video, or creator in the Target field.
2. For Search Youku, enter one keyword or one public Youku search URL. Choose result types, order, duration, publication dates, and minimum video quality as needed.
3. For Video lookup or Creator lookup, add one or more public page URLs or source IDs in the matching field.
4. Set maxItems to a small value when you want a shorter test and less data to review. Leave it empty to return all available results until the source is exhausted.
5. Start the run and open the dataset link in the Output section.

The Actor saves the first eligible occurrence of a source item during a search. If the same item appears later through another keyword or search URL, that later match is ignored and the saved row keeps the first search details.

⚙️ Input

Input fields

Field	Type	What it does
target	string	Required. Selects search, video, or creator.
searchQuery	string	One keyword or one public Youku search URL for Search Youku.
searchResultTypes	array of strings	Chooses video, series, or both for Search Youku. The default uses both.
searchSort	string	Orders Search Youku results by relevance, newest, or most-viewed. The default is relevance.
durationMinSeconds	integer	Keeps Search Youku results at or above this duration in seconds. Omit it to set no minimum.
durationMaxSeconds	integer	Keeps Search Youku results at or below this duration in seconds. Omit it to set no maximum.
publicationFrom	string	Includes Search Youku results published on or after this UTC date. Use YYYY-MM-DD, or omit it.
publicationTo	string	Includes Search Youku results published on or before this UTC date. Use YYYY-MM-DD, or omit it.
searchQuality	string	Keeps Search Youku video results with this quality or higher: any, 360p, 540p, 720p, or 1080p. The default is any.
maxItems	integer	Optional positive limit for one Search Youku run. Leave it empty to return all available results until the source is exhausted.
videoReferences	array of strings	One or more public Youku video page URLs or source IDs, one per line. Used only for Video lookup.
creatorReferences	array of strings	One or more public Youku creator profile URLs or source IDs, one per line. Used only for Creator lookup.
videoQuality	string	Chooses best, 1080p, 720p, 540p, 360p, or worst for direct playback links in Search Youku video results and Video lookup. The default is best. It is ignored for Creator lookup and series rows.

Example input

This public input is from a successful current-beta default search run:

{
  "target": "search",
  "searchQuery": "youku videos",
  "searchResultTypes": [
    "video",
    "series"
  ],
  "searchSort": "relevance",
  "searchQuality": "any",
  "maxItems": 1,
  "videoQuality": "best"
}

🧾 Output

The Actor returns a link to the default dataset. Open it to view or export the saved rows. Each row follows one of the three shapes below.

Run output

Field	Type	What it does
dataset	string	Link to the dataset rows collected by this Actor.

Video rows

Field	Type	What it does
resultType	string	Always video for this shape.
videoId	string	Public Youku ID for the video.
title	string	Visible video title.
pageUrl	string	Public Youku video page URL.
durationSeconds	integer	Video length in seconds.
category	string	Visible video category or type.
publishedAt	string	Publication date or time shown by Youku.
thumbnailUrl	string	Public thumbnail URL.
uploader	object	Public reference for the video uploader.
uploader.id	string	Public Youku ID for the uploader.
uploader.name	string	Visible uploader name.
uploader.profileUrl	string	Public uploader profile URL.
engagement	object	Visible engagement totals for the video.
engagement.likeCount	integer	Visible number of likes.
engagement.commentCount	integer	Visible number of comments.
availability	object	Visible playback, payment, and availability details.
availability.isAvailable	boolean	Whether Youku shows the video as available.
availability.isPlayable	boolean	Whether Youku shows the video as playable.
availability.isPaid	boolean	Whether Youku shows that payment or VIP access is needed.
tags	array of strings	Visible tags for the video.
description	string	Visible video description text.
playbackUrl	string	Source-hosted playback URL for an accessible video.
playbackQuality	string	Quality selected for playbackUrl.
playbackVariants	array of objects	Available source-hosted playback links and their quality labels.
playbackVariants[].quality	string	Quality label for a playback link.
playbackVariants[].url	string	Source-hosted playback URL for that quality.
search	object	Search details when Search Youku first found the video.
search.query	string	Keyword or public Youku search URL that first found the video.
search.resultRank	integer	Position of the video in the source search results.
search.collectedAt	date-time string	Time when the search row was collected.

Example video row

This genuine row came from a successful current-beta video lookup run:

{
  "resultType": "video",
  "videoId": "XNjQ0NjcyNTcyOA==",
  "title": "湖北安陆蓝山明珠购物广场随拍快乐舞蹈队舞蹈《战马》",
  "pageUrl": "https://v.youku.com/v_show/id_XNjQ0NjcyNTcyOA==.html",
  "durationSeconds": 133,
  "category": "体育",
  "publishedAt": "2024-11-21 10:42:12",
  "thumbnailUrl": "https://m.ykimg.com/05410101673E9D380000013AC20BA07F",
  "uploader": {
    "id": "UNjI2Mzc3MDI1Ng==",
    "name": "安陆蔡世峰",
    "profileUrl": "https://i.youku.com/u/UNjI2Mzc3MDI1Ng=="
  },
  "engagement": {
    "commentCount": 0
  },
  "availability": {
    "isAvailable": true,
    "isPlayable": true,
    "isPaid": false
  },
  "description": "湖北安陆蓝山明珠购物广场随拍快乐舞蹈队舞蹈《战马》 是在优酷播出的体育高清视频,于2024-11-21 10:42:12上线。视频内容简介:湖北安陆蓝山明珠购物广场随拍快乐舞蹈队舞蹈《战马》",
  "playbackUrl": "http://pl-ali.youku.com/playlist/m3u8?vid=XNjQ0NjcyNTcyOA%3D%3D&type=hd3&ups_client_netip=ad2c9895&utid=s0YXIxweBWcCAcgKKb11ixAm&ccode=0502&psid=8f959ea8b2fd095acc218f7a7fa7218041346&app_ver=9.21.5&duration=133&expire=18000&drm_type=147&drm_device=7&drm_default=1&nt=1&dyt=1&ups_ts=1787844790&onOff=4656&encr=0&ups_key=24a6b4727c558df48a0409a5adf2dd36&ckt=5&m_onoff=0&pn=com.youku.pcweb&app_key=24679788&drm_type_value=default&v=v1&bkp=0",
  "playbackQuality": "1080p",
  "playbackVariants": [
    {
      "quality": "360p",
      "url": "http://pl-ali.youku.com/playlist/m3u8?vid=XNjQ0NjcyNTcyOA%3D%3D&type=flv&ups_client_netip=ad2c9895&utid=s0YXIxweBWcCAcgKKb11ixAm&ccode=0502&psid=8f959ea8b2fd095acc218f7a7fa7218041346&app_ver=9.21.5&duration=133&expire=18000&drm_type=147&drm_device=7&drm_default=1&nt=1&dyt=1&ups_ts=1787844790&onOff=4656&encr=0&ups_key=4a19d8d2c702ee161a02d853cf368dac&ckt=5&m_onoff=0&pn=com.youku.pcweb&app_key=24679788&drm_type_value=default&v=v1&bkp=0"
    },
    {
      "quality": "480p",
      "url": "http://pl-ali.youku.com/playlist/m3u8?vid=XNjQ0NjcyNTcyOA%3D%3D&type=hd&ups_client_netip=ad2c9895&utid=s0YXIxweBWcCAcgKKb11ixAm&ccode=0502&psid=8f959ea8b2fd095acc218f7a7fa7218041346&app_ver=9.21.5&duration=133&expire=18000&drm_type=147&drm_device=7&drm_default=1&nt=1&dyt=1&ups_ts=1787844790&onOff=4656&encr=0&ups_key=57b9058417960f623c4c7520106c3198&ckt=5&m_onoff=0&pn=com.youku.pcweb&app_key=24679788&drm_type_value=default&v=v1&bkp=0"
    },
    {
      "quality": "720p",
      "url": "http://pl-ali.youku.com/playlist/m3u8?vid=XNjQ0NjcyNTcyOA%3D%3D&type=hd2&ups_client_netip=ad2c9895&utid=s0YXIxweBWcCAcgKKb11ixAm&ccode=0502&psid=8f959ea8b2fd095acc218f7a7fa7218041346&app_ver=9.21.5&duration=133&expire=18000&drm_type=147&drm_device=7&drm_default=1&nt=1&dyt=1&ups_ts=1787844790&onOff=4656&encr=0&ups_key=cac0f02689fce5235dd9484bc9ff7d8b&ckt=5&m_onoff=0&pn=com.youku.pcweb&app_key=24679788&drm_type_value=default&v=v1&bkp=0"
    },
    {
      "quality": "1080p",
      "url": "http://pl-ali.youku.com/playlist/m3u8?vid=XNjQ0NjcyNTcyOA%3D%3D&type=hd3&ups_client_netip=ad2c9895&utid=s0YXIxweBWcCAcgKKb11ixAm&ccode=0502&psid=8f959ea8b2fd095acc218f7a7fa7218041346&app_ver=9.21.5&duration=133&expire=18000&drm_type=147&drm_device=7&drm_default=1&nt=1&dyt=1&ups_ts=1787844790&onOff=4656&encr=0&ups_key=24a6b4727c558df48a0409a5adf2dd36&ckt=5&m_onoff=0&pn=com.youku.pcweb&app_key=24679788&drm_type_value=default&v=v1&bkp=0"
    }
  ]
}

Series rows

Field	Type	What it does
resultType	string	Always series for this shape.
seriesId	string	Public Youku ID for the series or program.
title	string	Visible series or program title.
pageUrl	string	Public Youku series page URL.
category	string	Visible series category or type.
releaseYear	integer	Series release year shown by Youku.
episodeCount	integer	Visible number of episodes.
status	string	Visible update or completion status.
country	string	Country information shown for the series.
rating	number	Visible numeric rating for the series.
cast	array of strings	Visible cast names.
directors	array of strings	Visible director names.
thumbnailUrl	string	Public series thumbnail URL.
availability	object	Visible availability and payment details.
availability.isAvailable	boolean	Whether Youku shows the series as available.
availability.isPlayable	boolean	Whether Youku shows the series as playable, when provided.
availability.isPaid	boolean	Whether Youku shows that payment or VIP access is needed.
search	object	Search details when Search Youku first found the series.
search.query	string	Keyword or public Youku search URL that first found the series.
search.resultRank	integer	Position of the series in the source search results.
search.collectedAt	date-time string	Time when the search row was collected.

Example series row

This genuine row came from a successful current-beta series search run:

{
  "resultType": "series",
  "seriesId": "aaeb6be400ad41199ca4",
  "title": "《欢迎来龙餐馆》优酷独家幕后记录",
  "pageUrl": "https://v.youku.com/video?s=aaeb6be400ad41199ca4",
  "category": "电影",
  "releaseYear": 2026,
  "episodeCount": 2,
  "status": "ongoing",
  "country": "中国",
  "thumbnailUrl": "http://m.ykimg.com/053500006A85761629D21514B2940C0C",
  "availability": {
    "isAvailable": true,
    "isPaid": false
  },
  "search": {
    "query": "https://so.youku.com/search/q_%E4%BC%98酷?isProgramTab=1",
    "resultRank": 1,
    "collectedAt": "2026-08-27T15:22:30.118Z"
  }
}

Creator rows

Field	Type	What it does
resultType	string	Always creator for this shape.
creatorId	string	Public Youku ID for the creator.
name	string	Visible public creator name.
pageUrl	string	Public Youku creator profile URL.
avatarUrl	string	Public creator avatar URL.
followerCount	integer	Visible number of creator followers.
likeCount	integer	Visible number of likes for the creator.
isVerified	boolean	Whether Youku marks the creator as verified.
biography	string	Visible creator biography text.

Example creator row

This genuine row came from a successful current-beta creator lookup run:

{
  "resultType": "creator",
  "creatorId": "UMTMxOTU2NjQ5Mg==",
  "name": "优酷最动漫",
  "pageUrl": "https://i.youku.com/u/UMTMxOTU2NjQ5Mg==",
  "avatarUrl": "https://image.9xsecndns.cn/image/uicon/120ccb467169fee531afec910a4122bb66c530726d4c82.jpg",
  "followerCount": 394151,
  "likeCount": 110250,
  "isVerified": false,
  "biography": "优酷君陪你看遍二次元~"
}

💳 Pricing

This Actor uses pay-per-event pricing. The Video event covers one public Youku video saved to the dataset. The Series event covers one public Youku series or program saved to the dataset. The Creator profile event covers one public Youku creator profile saved to the dataset. Use maxItems to bound Search Youku work, and check the Pricing tab for current prices for your Apify plan.

🔌 Integrations

Use the dataset link in the Output section with the Apify API, schedules, webhooks, and export tools. This video shows how to connect Actors:

❓ FAQ

Can I search by keyword or a Youku search URL?

Yes. Set target to search, then enter one keyword or one public Youku search URL in searchQuery.

Can I get only videos or only series?

Yes. Set searchResultTypes to video or series. Use both values when you want both shapes.

Can I look up a video or creator directly?

Yes. Set target to video or creator, then add public page URLs or source IDs to the matching reference field. One run uses one target, so it does not automatically chain a search into a video or creator lookup.

How do I choose a playback quality?

Set videoQuality to a preferred quality or to best or worst. The video row reports the quality that was available. Playback URLs and quality variants are source-hosted, so they may expire.

What if Youku does not show a field?

Optional fields appear only when Youku exposes them for that source item. The Actor leaves unavailable values out instead of inventing them.

What happens when the same item appears more than once?

The first eligible occurrence is saved at once. Later matches for the same source item are ignored, even when they come from another keyword or search URL. The saved row keeps the first search details.

Does this Actor download or store full videos?

No. It returns source-hosted playback links and available quality variants for accessible videos. It does not promise permanent links or actor-hosted media files.

Do I need a Youku account or API key?

No. Public Youku search and lookup inputs do not need a Youku account or an external API key. Private, paid, VIP-only, and region-restricted access is not bypassed.

What happens when I leave maxItems empty?

Search Youku returns all available results until the source is exhausted. Set a positive value when you want less data to review.

Does the Actor keep history between runs?

No. Each run saves its own current dataset. It does not maintain cross-run snapshots or change history.

📝 Changelog

0.0: Initial release

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• YouTube Channel Search Scraper finds public YouTube channels from topics and reusable search URLs.
• YouTube Channel Statistics Scraper checks public subscriber, view, and video counts for known channels.
• VK Videos Search Scraper searches VKVideo for public videos from keywords or search URLs.
• TikTok Search Scraper finds public TikTok videos or creator profiles by keyword.
• Douyin Analytics Scraper tracks public Douyin hot search trends for China market research.

Made with ❤️ by Maxime Dupré