Douban Scraper - Movies, TV, Books & Music Metadata

What does Douban Scraper do?

Douban Scraper extracts structured metadata from Douban (豆瓣), China's largest rating site for movies, TV series, books and music. It returns clean JSON with English field names: rating, vote count, 1–5 star distribution, genres, directors, cast, authors, publisher, page count, tags, Top 250 rank and more.

No login, cookies or proxies needed. It uses the same public endpoints as Douban's mobile site and paces requests politely.

What can you scrape?

• Rankings and charts: Movie Top 250, Book Top 250, now showing, coming soon, weekly best movies, weekly best Chinese and global TV, popular TV by region (Chinese, American, Japanese, Korean, animation, variety), popular fiction and non-fiction, bestsellers, new books
• Any subject by URL or ID: https://movie.douban.com/subject/1292052/, https://book.douban.com/subject/1007305/, mobile links, or movie:1292052 / book:1007305 / music:1394539
• Search by title: look up movies, TV or books by Chinese or original title

This Actor collects title-level metadata only. It does not scrape user reviews, comments, user profiles or any personal data.

Use cases

• Chinese box office and streaming market research: what's rated well, what's trending, by region and genre
• Book market and publishing analysis: ratings, publishers, prices, page counts for Chinese editions
• Enrich a movie or book catalog with Douban ratings next to IMDb or Goodreads scores
• Recommendation systems and datasets built on Douban Top 250 and genre percentiles
• Track weekly charts over time with a scheduled run

How to use it

1. Pick one or more Rankings & lists, paste Subject URLs, or type titles into Search by title.
2. Set Max items per list / search (Top 250 lists go up to 250).
3. Click Start and download the results as JSON, CSV, Excel or via API.

Input example

{
  "collections": ["movie_top250", "book_top250"],
  "subjects": ["https://movie.douban.com/subject/1291546/"],
  "searchQueries": ["活着"],
  "searchType": "movie",
  "maxItemsPerSource": 250,
  "includeRatingDistribution": true
}

Output example

{
  "id": "1292052",
  "type": "movie",
  "url": "https://movie.douban.com/subject/1292052/",
  "title": "肖申克的救赎",
  "originalTitle": "The Shawshank Redemption",
  "subtitle": "1994 / 美国 / 剧情 犯罪 / 弗兰克·德拉邦特 / 蒂姆·罗宾斯 摩根·弗里曼",
  "year": 1994,
  "rating": 9.7,
  "ratingCount": 3344343,
  "ratingDistribution": { "star5": 85.42, "star4": 13.01, "star3": 1.36, "star2": 0.1, "star1": 0.11 },
  "genreRanks": [{ "genre": "犯罪片", "betterThanPercent": 99 }, { "genre": "剧情片", "betterThanPercent": 99 }],
  "genres": ["剧情", "犯罪"],
  "tags": ["犯罪", "越狱", "励志"],
  "honors": [{ "title": "豆瓣电影Top250", "rank": 1 }],
  "directors": ["弗兰克·德拉邦特"],
  "actors": ["蒂姆·罗宾斯", "摩根·弗里曼", "鲍勃·冈顿"],
  "countries": ["美国"],
  "languages": ["英语"],
  "durations": ["142分钟"],
  "collection": "movie_top250",
  "collectionRank": 1
}

Books add authors, translators, publisher, pubDate, pages, price, series, authorIntro and tableOfContents. TV adds episodes. Music adds artists, media and tracks.

How much does it cost?

You pay per subject saved (see the Pricing tab). Scraping the full Movie Top 250 with star distributions costs well under a dollar, and it runs on the smallest memory setting.

Tips

• Keep Delay between requests at 800 ms or more for runs of several hundred items. Douban may temporarily throttle very fast clients; the Actor retries with backoff.
• Use Max total items as a budget cap.
• Schedule the weekly charts to build a time series.

Is it legal to scrape Douban?

This Actor only reads publicly available, non-personal title information that anyone can see without logging in. Make sure your use of the data complies with Douban's terms and the laws that apply to you.

Feedback

Found a bug or need another field or chart? Open an issue on the Issues tab.