Youku 优酷 Scraper - Video Search, Video & Channel Details
Pricing
Pay per event
Youku 优酷 Scraper - Video Search, Video & Channel Details
Collect Youku (优酷) data without an account: search videos by keyword, get any video's details (title, category, duration, publish time, likes, comments, uploader) and any uploader channel's public profile (followers, likes, IP location). No login or cookies. Export JSON, CSV or Excel.
Pricing
Pay per event
Rating
0.0
(0)
Developer
Silkline
Maintained by CommunityActor stats
0
Bookmarked
4
Total users
3
Monthly active users
2 days ago
Last modified
Categories
Features
Share
You put in: {"mode": "search", "keywords": ["纪录片"], "maxResults": 10}
You get back: one record per video with 13 fields. Three records from a real run on 2026-10-27, some of the fields:
title | durationSeconds | publishedText | uploaderName |
|---|---|---|---|
| 雨林巨物 | 2495 | 前天 | 乐侃纪录片 |
| 丛林极限上学路,央视播出过的高分纪录片,建议带着孩子一起看 | 484 | 4年前 | 南有布谷 |
| 央视纪录片 2019《水下中国 第1集:黑暗洞穴》[全6集] 国语中… | 2068 | 6年前 | 老子作道德经 |
You pay: 100 videos from one keyword cost $0.523. Free Apify accounts get 2 trial runs of up to 10 results each, nothing charged.
Youku Scraper is a Youku API that reads public data from Youku (优酷), one of China's largest video platforms: it searches video by keyword, returns the details of any Youku video and the public channel profile of any uploader, as clean, flat JSON records. It is built for media researchers, content and MCN teams, marketers and developers who need Chinese video data. No Youku account, API keys, proxies or cookies are needed.
Pricing is pay-per-event: $0.005 per video found by search and $0.025 per video or channel profile looked up by ID, plus a $0.023 start fee per run. 100 search results cost $0.523.
What is Youku?
Youku (优酷) is a Chinese video platform. It hosts licensed series, films and documentaries as well as videos uploaded by creators (UGC). Every video has an ID, and every uploader has a channel with a user ID, followers and likes.
What data can you get?
The Actor has three modes, chosen with mode:
search(default) finds videos by keyword (typeisvideo), about 28 per page.videoreturns the details of videos you name by ID or link (typeisvideoDetail).profilereturns the public channel profile of uploaders you name by ID or link (typeisprofile).
Youku video search results (mode: search)
| Field | What it is |
|---|---|
videoId, url | Video ID (use it as input of video mode) and the link to the video page |
title | Video title (Chinese) |
coverUrl | Cover image link |
durationSeconds | Video length in seconds |
publishedText | When the video was published as the search result shows it, for example 4天前 (4 days ago) |
danmakuCount | Danmaku (on-screen comments) of the video |
showId | ID of the series the video belongs to; empty for stand-alone uploads |
uploaderId, uploaderName, uploaderAvatar | Uploader ID (use it as input of profile mode), name and avatar link |
searchKeyword | The keyword that found the video |
badge | Corner tag on the video as Youku shows it, for example VIP (null when none) |
searchTotal | How many results Youku reports for the keyword in all, the same on every video of the search |
Youku video details (mode: video)
| Field | What it is |
|---|---|
videoId, url, title, coverUrl, durationSeconds | As in search mode |
publishedAt | Exact publish time, ISO 8601 UTC |
category, videoType | Youku category (for example 纪录片) and kind of video (for example 正片, a full episode) |
likeCount, commentCount | Likes and comments of the video |
showId, showName, episodeNumber, episodeTotal | The series the video belongs to, its episode number and episode count |
genres, areas, releaseYear, description | Genres, production regions, release year and synopsis of the series |
badge, updateInfo | Corner tag of the series (for example VIP) and its update status (for example 8期全); null for a stand-alone upload |
uploaderId, uploaderName, uploaderAvatar, uploaderVerification, uploaderFollowerCount | The uploader's public card: ID, name, avatar, verification label and followers |
Youku uploader channel profiles (mode: profile)
| Field | What it is |
|---|---|
userId, numericUserId, name, avatar | IDs, channel name and avatar link |
description | The channel bio exactly as published |
verification | Verification label, for example 机构认证 (organisation) or 大鱼号认证作者 |
followerCount, followingCount, likeCount | Followers, accounts followed and total likes received |
genderCode | Gender code as Youku shows it (1 or 2) |
ipLocation | IP location shown on the channel page |
How to use Youku Scraper
- Open the Actor on Apify and click Try for free (or Start).
- Choose a Mode: search videos (
search), details of videos (video) or profiles of uploaders (profile). - For
search, enter one or more words in Keywords. Forvideo, enter video IDs or links such ashttps://v.youku.com/v_show/id_XNjU1NTAzMDQ5Ng==.htmlin Videos. Forprofile, enter uploader IDs (theuploaderIdof search and video records) in Uploaders. - Set Max results to the total number of records you want for the run.
- Click Start, then open the Videos, Video details or Channel profiles view of the dataset and export as JSON, CSV or Excel, or fetch it through the API.
The Actor also runs with an empty input: {} searches for 纪录片 (documentary), a quick way to see the output format.
A common workflow is to search a topic, then look up the videoId of interesting videos in video mode and their uploaderId in profile mode.
Input
| Field | Type | Required | What it does | Default |
|---|---|---|---|---|
mode | string | Optional | search, video or profile | prefilled with search; when left out, video if videos is given, profile if users is given, otherwise search. Giving more than one of the three lists without mode is an error. |
keywords | array of strings | Optional | Used in search mode. Videos are collected keyword by keyword, page by page, until maxResults is reached. | Falls back to 纪录片 when empty |
videos | array of strings | Needed for video mode | Video IDs (text or numeric form) or links containing id_<ID> or vid=<ID>. A number here is always read as a video ID, never as an uploader. | none |
users | array of strings | Needed for profile mode | Uploader IDs (text or numeric form), or channel links such as https://i.youku.com/i/<ID> or links containing uid=<ID>. | none |
maxResults | integer | Optional | Maximum number of records to return in total for this run, from 1 to 5000. The run stops as soon as it is reached. You are charged per record returned. | 20 |
Example: search Youku videos
{"mode": "search", "keywords": ["纪录片", "美食"], "maxResults": 100}
Example: details of Youku videos
{"mode": "video", "videos": ["XNjU1NTAzMDQ5Ng==", "https://v.youku.com/v_show/id_XNjU4MTk3NTI0OA==.html"]}
Example: profile of a Youku uploader
{"mode": "profile", "users": ["UMTU5MjkzNTE2NzI="]}
Output example
{"type": "video","videoId": "XNjU1NTAzMDQ5Ng==","url": "https://v.youku.com/v_show/id_XNjU1NTAzMDQ5Ng==.html","title": "雨林巨物","coverUrl": "https://vthumb.ykimg.com/054106016AD9EDEA1F0B3301A404C7FA","durationSeconds": 2495,"publishedText": "前天","danmakuCount": 0,"showId": "fcac9491c8614d6da993","uploaderId": "UMTU5MjkzNTE2NzI=","uploaderName": "示例频道","uploaderAvatar": "https://m.ykimg.com/example-avatar","searchKeyword": "纪录片"}
{"type": "videoDetail","videoId": "XNjU1NTAzMDQ5Ng==","url": "https://v.youku.com/v_show/id_XNjU1NTAzMDQ5Ng==.html","title": "雨林巨物","coverUrl": "https://m.ykimg.com/054101016A9E6EE7334D992488A9C6D1","durationSeconds": 2495,"publishedAt": "2026-10-24T16:00:01Z","category": "纪录片","videoType": "正片","likeCount": 0,"commentCount": 0,"showId": "fcac9491c8614d6da993","showName": "追踪巨型鱼 第五季","episodeNumber": 7,"episodeTotal": 8,"genres": ["探险", "自然"],"areas": ["加拿大"],"releaseYear": 2026,"description": "《追踪巨型鱼 第五季》跟随西里尔深入全球最偏远危险的水域……","uploaderId": "UMTU5MjkzNTE2NzI=","uploaderName": "示例频道","uploaderAvatar": "https://m.ykimg.com/example-avatar","uploaderVerification": "机构认证","uploaderFollowerCount": 225}
{"type": "profile","userId": "UMTU5MjkzNTE2NzI=","numericUserId": "3982337918","name": "示例频道","avatar": "https://m.ykimg.com/example-avatar","description": "做优质精品短视频","verification": "机构认证","followerCount": 225,"followingCount": 0,"likeCount": 392,"genderCode": 2,"ipLocation": "北京"}
How much does it cost?
The Actor uses pay-per-event pricing. These are the charge events:
| Event | Price (USD) | When it is charged |
|---|---|---|
run-start | $0.023 | Once per run, charged when the first request succeeds, even if that request returns nothing. It is not charged when the run fails from the start, or when your spending limit cannot cover it. Each further keyword, video or uploader the run actually reaches pays one more start fee. That fee is charged before its first request and is kept even if it then fails or returns nothing. A later keyword, video or uploader is only reached when the earlier ones did not fill maxResults. |
result | $0.005 | For each video returned by search mode. |
detail | $0.025 | For each video returned by video mode and for each channel profile returned by profile mode. |
Worked examples:
- 100 videos from one keyword cost $0.023 + 100 × $0.005 = $0.523. Two keywords that together fill 100 videos cost $0.046 + 100 × $0.005 = $0.546.
- 10 videos in
videomode cost 10 × $0.023 (the run's start fee and one more for each further video) + 10 × $0.025 = $0.48. - 5 channel profiles cost 5 × $0.023 + 5 × $0.025 = $0.24.
You never pay for more than maxResults records, and you are never charged for records that were not delivered. The run stops by itself if your spending limit is reached.
On the free Apify plan you get 2 free trial runs of this Actor with your own input, up to 10 results each, and nothing is charged; after that, runs return a stored sample dataset (a real result of the prefilled input). Use any paid Apify plan for full runs.
Use cases
- Content and trend research: see which videos and uploaders appear for a topic on Youku, and how long they run.
- Creator discovery: find uploaders by the videos they publish, then read their follower count, likes and verification in
profilemode. - Catalogue and series tracking: follow the episodes, genres, regions and synopsis of series and documentaries.
- Media monitoring: check regularly which videos Youku returns for a brand, a title or a person.
- AI and data projects: collect Chinese video titles, categories and metadata for search, classification and recommendation models.
Why use this Youku scraper
- No account, no cookies, no proxies. You give keywords, links or IDs; the Actor does the rest.
- You pay for data you get. Per-result fees are charged only for records delivered to your dataset. A failed or empty run tells you why in its status message and whether anything was charged.
- It runs. In the 30 days to 2 November 2026, 21 of 21 public runs succeeded (100%, Apify run statistics).
- Try before paying. On a free Apify plan you get 2 free trial runs with your own input, up to 10 results each, nothing charged.
- Flat JSON records ready for spreadsheets, databases and AI pipelines; export as JSON, CSV or Excel.
Integrations and API
You can start runs from your own code through the Apify API, schedule them on the Apify platform (for example a weekly keyword check), and send results to other tools with Apify integrations and webhooks. Results are stored in a dataset you can download as JSON, CSV or Excel.
Python example using the apify-client package:
from apify_client import ApifyClientclient = ApifyClient("<YOUR_APIFY_TOKEN>")run = client.actor("clover_folktale/youku-scraper").call(run_input={"mode": "search","keywords": ["纪录片"],"maxResults": 100,})for item in client.dataset(run["defaultDatasetId"]).iterate_items():print(item)
Use it from AI agents (MCP, n8n, Make)
This Actor works as a tool for AI agents through the Apify MCP server. Add it to Claude, Cursor or any MCP client with https://mcp.apify.com?tools=clover_folktale/youku-scraper, and the agent can search Youku and read the results itself. It also has ready-made integrations for n8n, Make and Zapier on the Apify platform.
Tips and limits
- Reliability. The Actor retries transient errors on its own and stops cleanly instead of failing half-way. It never charges for records it did not deliver.
- Speed. A search page holds about 28 videos, so large runs make many requests; expect roughly 2-5 seconds per page.
- Run size.
maxResultsis the total for the whole run (1 to 5000, default 20). With several keywords, IDs or uploaders, records are collected one after the other until the total is reached. - Search results. Search mode returns video cards: ID, title, cover, length, relative publish time, danmaku count and uploader. Likes, comments and the exact publish time come with
videomode. A page with no new videos (none that this run has not already returned) ends the listing. - No play counts. Youku does not show a play count on these pages, so none is returned.
- Series and stand-alone videos. For an episode of a series,
description,genres,areasandreleaseYeardescribe the series. For a stand-alone upload they are empty. - Two forms of one uploader ID. The search result and the video page can show different forms of the same uploader ID.
profilemode accepts both, and returns the form Youku uses on the channel page inuserId. - Channel profiles. The bio is the text the channel published. A user ID Youku does not know is skipped as nothing found. The profile does not include a video count.
- Video details. One request per video. A video ID Youku does not know is asked a few times and then skipped as nothing found; no
detailis charged for it; the start fee of a further ID is kept. - Entries that name no video or uploader. A series page (
v_nextstageorshow_pagelink, or a 20-charactershowId) or any other text that is not a video or uploader ID is skipped, the log names it and says why, and the status message says how many were skipped; the other entries still run and nothing is charged for a skipped one. The run stops with an input error only when no entry can be read. - Free plan. On the free Apify plan you get 2 free trial runs of this Actor with your own input, up to 10 results each, and nothing is charged; after that, runs return a stored sample dataset (a real result of the prefilled input). Use any paid Apify plan for full runs.
- Privacy. Only public data is returned: what anyone sees on Youku video and channel pages. No private messages, no contact data beyond what a channel publishes in its bio.
FAQ
Do I need a Youku account, cookies or an API key?
No. You only need an Apify account to run the Actor.
Is this the official Youku API?
No. This Actor is not affiliated with Youku. It is an independent tool that collects public data and returns it as structured JSON.
Is it legal to scrape Youku?
The Actor only returns public data that anyone can see on Youku. It does not return private messages or account data. You are responsible for how you use the data and for following the laws and rules that apply to you.
How fresh is the data?
The data is collected live during each run.
Where do I find a video ID or an uploader ID?
In the links and in search results: https://v.youku.com/v_show/id_XNjU1NTAzMDQ5Ng==.html is video XNjU1NTAzMDQ5Ng==. Search records carry videoId and uploaderId, ready to use as input. The numeric forms work too: video 1638757624 is the same as XNjU1NTAzMDQ5Ng==, and the numericUserId of a profile record can be given as an uploader. A showId names a series, not a video: use the link of one of its episodes.
Why are some fields empty?
Stand-alone uploads have no series, so showName, genres and the like are empty. Gender, IP location and a bio are shown only when the channel has them.
How many results can I get?
You can set maxResults up to 5000 per run. A keyword with fewer matches returns what exists.
Can I schedule runs and export the data?
Yes. You can schedule runs on Apify, start them through the API, and export the dataset as JSON, CSV or Excel.
Something is missing. How do I ask for it?
Missing a field or a mode? Open an issue from the Actor page and it will be looked at.
Support
Found a bug, a missing field or a mode you need? Open an issue on the Issues tab. We reply within 24 hours, and a mode that stops working is fixed within 24 hours. What changed and when is listed on the Changelog tab.
Other tools by Silkline
Every tool below charges per result and needs no login or cookies.
Chinese social media and content
- Xiaohongshu 小红书 RedNote Scraper - Notes, Comments & Replies
- Douyin 抖音 Scraper - Videos, Comments, Profiles & Hot Search
- Weibo 微博 Scraper - Hot Search, Posts, Comments & Users
- Bilibili B站 Scraper - Videos, Comments, Danmaku & Subtitles
- WeChat Official Account 公众号 Scraper - Articles & Read Counts
- Zhihu 知乎 Scraper - Answers, Articles, Comments & Hot List
- Kuaishou 快手 Scraper - Videos, Comments, Users & Hot Lists
- Douban 豆瓣 Scraper - Movies, Ratings, Comments & Reviews
- Toutiao 今日头条 Scraper - Articles, Videos & Comments
- China Social Media Search - Weibo, WeChat, Douyin & More
More from Silkline
- Taobao Tmall 淘宝 Product Scraper - Prices, Sales & Shops (E-commerce)
- TikTok Scraper - Video Search, Hashtags, Profiles & Sounds (Global platforms)
- Douyin Xingtu 巨量星图 KOL Scraper - Rates, CPM & Rankings (Marketing and creator data)