🎬 Douban Movie Top 250 Scraper 豆瓣电影: Hot Charts, Filters, Changes

Douban rates films, books and albums. This suite reads all three. Run the film and TV charts here, then pull the book and album rankings with the same filters and change tracking.
DOUBAN RANKINGS SUITE   •  Books, films and albums from Douban's public charts
Douban Books Top 250, tags, new releases	Douban Movies ➤ You are here	Douban Music Top 250, weekly charts, tags

Douban film and TV charts in one run, filtered to the titles you need Collect the Top 250, weekly best, trending, cinema and TV charts plus 28 genre charts, with rating, rating count, directors, cast and genres on every row. Turn on change tracking to see what moved between runs.

🎞️ Ten charts, 28 genres Top 250, weekly best, trending, now showing, coming soon and TV charts, plus genre charts.

🎯 Precise filters Filter by rating, rating count, year, genre, country, language, title text or a director or actor name.

🔎 IMDb ID and audience stats Optionally add IMDb IDs, full cast, release dates, star-rating shares and watched or want-to-watch counts.

📈 What changed Change tracking flags new entries, titles that moved, rating changes and titles that dropped out.

Point this Actor at 豆瓣电影, Douban's film and TV community, and get its charts as a clean dataset you can filter, sort and export to JSON, CSV or Excel. No login required.

🔍 What does Douban Movie Top 250 Scraper do?

This Actor reads Douban's public movie and TV charts and returns one tidy row per title. Pick one chart or several, add the genre charts you care about, filter the results, and choose how many titles you want from each list.

• Ten charts: Douban Top 250, weekly best-rated movies, real-time hottest, now showing, coming soon, trending, recent popular, and three TV series charts (global weekly best, Chinese-language weekly best, recent popular).
• Genre charts: Douban's ranked chart for 28 genres, from Drama and Sci-Fi to Animation and Film noir.
• Every row: rank, Douban ID, Chinese and original titles, year, rating, number of ratings, directors, lead cast, genres, countries, poster and page link.
• Optional title details: full cast, writers, spoken languages, runtime, every release date, IMDb ID, summary, tags, other charts the title appears on, and review counts.
• Optional audience statistics: share of 5 to 1 star ratings, how many people watched or want to watch it, and how it ranks inside its genres.
• Optional change tracking: new entries, places moved up or down, rating changes and titles that dropped out of a chart.

No Douban account is needed. Review counts are returned as numbers, and this Actor does not collect the text of reviews or comments.

💡 Why use it

• I am a film distributor's acquisitions analyst comparing Douban scores and rating counts of foreign films by country and year, so I can see which titles Chinese audiences rate highest before I pitch.
• I am a streaming programmer shortlisting highly rated titles in one genre, such as Sci-Fi after 2010 rated above 8.5, so I can fill a catalogue gap with proven picks.
• I am an entertainment journalist running the charts every week with change tracking on, so my column on what China is watching starts from what entered, climbed or dropped.
• I am a data analyst joining Douban scores to my own IMDb dataset through the IMDb ID, so one table shows how a film rates in both markets.

🚀 How it works

STEP 1 Choose your charts Pick one or more charts or genre charts, and set how many titles you want.

STEP 2 Add filters and extras Limit by rating, year, country or cast, and switch on IMDb IDs and audience statistics if needed.

STEP 3 Run, export or schedule Download JSON, CSV or Excel, or schedule runs with change tracking on.

📥 Input

Field	Type	Required	Description
rankingLists	array of options	No	Which charts to read: Top 250, weekly and real-time charts, cinema lists, trending lists or TV charts. Defaults to the Top 250. Each title is labelled with the list it came from.
genreCharts	array of options	No	Add Douban's ranked chart for one or more genres, for example Sci-Fi or Animation. Leave empty to skip genre charts.
genreChartBand	enum	No	Which score slice of each genre chart to read. The first option is the best-rated slice and is what most people want.
minRating	number	No	Keep only titles rated at least this high on the 10-point scale. Titles without a rating are left out when this is set. Use 0 for no limit.
minRatingCount	integer	No	Keep only titles with at least this many ratings, which removes titles rated by only a handful of people. Use 0 for no limit.
yearFrom	integer	No	Keep only titles released in this year or later. Genre charts do not show the year, so this adds one lookup per candidate title there.
yearTo	integer	No	Keep only titles released in this year or earlier.
genres	array of options	No	Keep titles that belong to at least one of these genres.
countries	array of strings	No	Keep titles produced in at least one of these places. English names such as Japan, USA or South Korea work, and so do Chinese names such as 日本.
languages	array of strings	No	Keep titles with at least one of these spoken languages, for example English, Japanese or Cantonese. Language is only shown on each title's own page, so this adds one lookup per candidate title.
titleContains	string	No	Keep titles whose Chinese, original or alternative title contains this text. Not case sensitive.
personContains	string	No	Keep titles where a director, writer or cast member's name contains this text, for example 诺兰. Ranking pages show lead actors only, so turn on title details to match the full cast.
sortBy	enum	No	Order of results inside each list: Douban order, rating, number of ratings, or release year. Anything other than Douban order reads the whole list first.
maxItems	integer	No	Most titles to return from each selected list, counted after the filters. Defaults to 25.
dedupeAcrossLists	boolean	No	Return a title only once, in the first list that has it, when you select several lists. Off by default, which gives one row per list.
enrichDetails	boolean	No	Add full cast, writers, languages, runtime, every release date, IMDb ID, summary, tags, chart honors, review counts and a larger poster. Runs take longer. Off by default.
includeAudienceStats	boolean	No	Add the share of 1 to 5 star ratings, how many people watched, are watching or want to watch, and how the title ranks inside its genres. Off by default.
trackChanges	boolean	No	Compare each list with your previous run and label every title as new, moved up, moved down, rating changed or unchanged, with the previous rank and rating.
onlyChanges	boolean	No	With change tracking on, skip titles whose rank and rating did not change since the last run. The first run returns everything as new.
stateName	string	No	A name for this tracker. Runs that share a name continue the same history, and different names keep separate histories.
proxyConfiguration	object	No	Connection settings for Douban's public pages. The default works for most runs. Switch to residential proxies if Douban refuses many requests.

The default input returns the first 25 titles of the Douban Top 250 in a few seconds.

📊 Data table

Field	Type	Description
rankingList	string	Which list the row came from, for example top250 or genre:剧情.
rankingListName	string	Readable name of that list.
rank	integer	Position in the list as Douban shows it.
subjectId	string	Douban title ID, a stable key for joining and deduplicating.
mediaType	string	movie or tv.
title	string	Chinese title.
originalTitle	string	Title in its original language.
alternativeTitles	array	Other titles and regional names.
year	integer	Release year.
rating	number	Douban rating out of 10.
ratingCount	integer	Number of Douban ratings.
ratingDistribution	object	Share of 5, 4, 3, 2 and 1 star ratings in percent (audience statistics).
genrePercentiles	array	Share of titles in each genre that this title out-scores (audience statistics).
watchedCount	integer	People who marked the title as watched (audience statistics).
watchingCount	integer	People currently watching (audience statistics).
wishlistCount	integer	People who want to watch it (audience statistics).
reviewCount	integer	Number of long reviews (title details).
shortCommentCount	integer	Number of short comments (title details).
directors	array	Directors.
writers	array	Writers (title details).
cast	array	Cast. Lead actors only on ranking pages, full cast with title details.
genres	array	Genres.
countries	array	Countries or regions of production.
languages	array	Spoken languages (title details).
runtimeMinutes	integer	Runtime in minutes (title details).
episodeCount	integer	Number of episodes for TV (title details).
episodesInfo	string	Episode progress text for TV series.
firstReleaseDate	string	Earliest release date listed (title details).
releaseDates	array	All release dates with region or festival (title details).
imdbId	string	IMDb ID such as tt0111161 (title details).
quote	string	Short quote shown on the Top 250.
summary	string	Plot summary (title details).
tags	array	Viewer tags (title details).
honors	array	Charts this title also appears on, with its rank there (title details).
weeksOnChart	integer	Consecutive weeks on a weekly chart.
posterUrl	string	Poster image URL.
stillUrls	array	Still image URLs shown with the list.
url	string	Douban title page.
changeType	string	NEW, RANK_UP, RANK_DOWN, RATING_CHANGE, UNCHANGED or DROPPED (change tracking).
previousRank	integer	Rank at the previous run (change tracking).
rankChange	integer	Places moved since the previous run, positive means moved up (change tracking).
previousRating	number	Rating at the previous run (change tracking).
ratingChange	number	Rating difference since the previous run (change tracking).
ratingCountChange	integer	Change in number of ratings since the previous run (change tracking).
firstSeenAt	string	When the tracker first saw this title in this list (change tracking).
previousSeenAt	string	When the tracker last saw it before this run (change tracking).
sourceUrl	string	Page or feed the row came from.
retrievedAt	string	Time the row was collected.

Fields that Douban does not show are left out of the row, never filled with placeholders. You can download the dataset as JSON, CSV or Excel from the Output tab of any run.

📤 Sample output

{
    "rankingList": "top250",
    "rankingListName": "Douban Top 250",
    "rank": 1,
    "subjectId": "1292052",
    "mediaType": "movie",
    "title": "肖申克的救赎",
    "originalTitle": "The Shawshank Redemption",
    "alternativeTitles": [
        "月黑高飞(港)",
        "刺激1995(台)"
    ],
    "year": 1994,
    "rating": 9.7,
    "ratingCount": 3349614,
    "directors": [
        "弗兰克·德拉邦特"
    ],
    "cast": [
        "蒂姆·罗宾斯"
    ],
    "genres": [
        "犯罪",
        "剧情"
    ],
    "countries": [
        "美国"
    ],
    "quote": "希望让人自由。",
    "posterUrl": "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2934829882.webp",
    "url": "https://movie.douban.com/subject/1292052/",
    "sourceUrl": "https://movie.douban.com/top250",
    "retrievedAt": "2026-10-11T09:26:53.599Z"
}

💰 Pricing

Pricing is pay per result, with no subscriptions. You pay for each title delivered to your dataset. Full title details and audience statistics are billed separately, and only for the titles where that extra data was actually delivered. A title that dropped out of a chart counts as one ranked title when change tracking is on. Empty runs cost nothing. If you set a maximum charge per run in Apify, it is respected: the run stops cleanly when the limit is reached and keeps everything already delivered. Your Apify plan sets the rate, and higher plans pay less.

⭐ Enjoying Douban Movie Top 250 Scraper?

⭐ ⭐ ⭐ ⭐ ⭐ One run puts every Douban chart you follow in a single table you can sort and filter. A 5-star rating takes 10 seconds and helps other film buyers, programmers and analysts find this actor. Your feedback also tells us what to build next.

★  Rate this Actor on Apify

❓ FAQ

豆瓣电影 Top 250 怎么导出？

Run the Actor with its default settings and download the dataset as JSON, CSV or Excel from the Output tab. The default reads 25 titles, so raise the maximum titles per list to 250 to get the whole Top 250.

豆瓣电影 评分 8.5 以上 日本 怎么筛选？

Set a minimum rating of 8.5 and add Japan to the countries filter. Filters apply to every selected chart, and you can add a release year range or a genre the same way.

How do I get a weekly feed of what changed on Douban?

Turn on change tracking, schedule the Actor weekly and switch on the option to return only changes. Each run returns new entries, titles that moved, rating changes and titles that dropped out.

Does it need a Douban login, and does it collect reviews?

No login is needed. It reads public charts and title pages and returns the number of reviews and comments, but not their text.

🔗 Other actors

• Douban Book Scraper 豆瓣读书: Top 250, Tags, New Releases, Changes ↗ - Collects Douban's book Top 250, topic tag lists and new releases.
• Douban Music Scraper 豆瓣音乐: Top 250, Weekly Charts and Tag Lists ↗ - Collects Douban's album Top 250, weekly charts and tag lists.
• Bilibili Trending Videos Scraper 哔哩哔哩: Rankings & Hot Searches ↗ - Collects Bilibili's video rankings and hot searches.
• Xigua Video Scraper 西瓜视频: Keyword & Hashtag Search, Play Stats ↗ - Collects Xigua video search results with play stats by keyword or hashtag.