Douban Scraper — Movies, TV, Ratings & Cast

Scrape Douban (豆瓣), China's biggest film, TV and culture rating site, into clean JSON, CSV or Excel. This Douban scraper extracts rating, vote count, genres, cast, directors, year, original title, countries, runtime and cover image for movies, TV series and variety shows. Pull hot lists, run a keyword search, or fetch full details by subject id. Fast and reliable.

Perfect for China film and TV intelligence, rating benchmarks, catalog enrichment and content research.

What does Douban Scraper do?

The Douban Scraper collects movie, TV and variety-show entries from Douban and returns them as structured data. It supports three modes — browse a hot-list collection, search by keyword, or fetch details by subject id — and extracts the full metadata for each title, including the Douban rating and number of votes, so you can build a complete Chinese film and TV dataset.

What data can you scrape from Douban?

Category	Fields
⭐ Ratings	rating, rating count, comment count
🎬 Title	title, original title, type, year
🎭 People & genre	directors, actors, genres, countries, durations
📝 Content	summary, cover image
🔗 Links & meta	subject id, listing URL, source URL, collected date

What you get

Each title is returned as one clean record. Example output:

{
  "id": "37450627",
  "title": "痴迷",
  "originalTitle": "Obsession",
  "type": "movie",
  "year": 2025,
  "rating": 7.5,
  "ratingCount": 160122,
  "genres": ["恐怖"],
  "countries": ["美国"],
  "durations": ["110分钟"],
  "directors": ["库里·巴克"],
  "actors": ["迈克尔·约翰斯顿", "印达·纳瓦雷特"],
  "commentCount": 4821,
  "summary": "A chilling supernatural thriller...",
  "coverImage": "https://img9.doubanio.com/...",
  "url": "https://movie.douban.com/subject/37450627/",
  "sourceUrl": "https://movie.douban.com/explore",
  "collectedAt": "2026-07-30T12:00:00.000Z"
}

Output schema

Field	Type	Description
id	string	Douban subject id of the title.
title	string	Title as shown on Douban.
originalTitle	string	Original-language title.
type	string	Content type, e.g. movie or TV.
year	integer	Release year.
rating	number	Douban rating on a 0–10 scale.
ratingCount	integer	Number of ratings received.
genres	array	List of genres.
countries	array	List of production countries or regions.
durations	array	Runtime values for the title.
directors	array	List of directors.
actors	array	List of main cast members.
commentCount	integer	Number of user comments.
summary	string	Plot summary or synopsis.
coverImage	string (URL)	Cover poster image URL.
url	string (URL)	Direct link to the Douban page.
sourceUrl	string (URL)	Source page URL for the record.
collectedAt	string (ISO date)	Timestamp when the record was collected.

Use cases

• Rating benchmarks — compare Douban scores and vote counts across titles and genres.
• Catalog enrichment — add Chinese-market metadata and ratings to your media database.
• Content research — track hot movies, TV and variety shows over time.
• Recommendation engines — feed genres, cast and ratings into similarity models.
• Market intelligence — analyze how titles perform with Chinese audiences.
• Cast and crew analysis — map directors and actors across a body of work.

How to scrape Douban data

1. Add the Douban Scraper to your Apify account.
2. Pick a mode — collection (hot list), search (keyword), or detail (by subject id).
3. Set the collection, search query or subject ids, and a max item limit.
4. Optionally turn on Enrich with full details to add genres, countries and runtime.
5. Click Run, then export as JSON, CSV, Excel or XML, or pull via the Apify API.

Input

{
  "mode": "collection",
  "collection": "movie_hot_gaia",
  "maxItems": 100
}

Search, enriched with full details:

{ "mode": "search", "searchQuery": "诺兰", "enrichDetails": true, "maxItems": 40 }

Details by id:

{ "mode": "detail", "subjectIds": ["37450627", "35267208"] }

Field	Type	Description
mode	string	collection, search, or detail.
collection	string	Which hot list to pull (hot movies, hot TV, Korean TV, animation and more).
searchQuery	string	Keyword for search mode (a title or a person).
subjectIds	array	Douban subject ids for detail mode.
enrichDetails	boolean	For collection/search: fetch full detail (genres, countries, runtime) per item.
maxItems	integer	Maximum number of items to scrape.

Need more media and culture data?

• Letterboxd Scraper
• TVmaze Scraper
• NetEase Music Scraper
• Bilibili Scraper

FAQ

How many titles can I scrape? As many as you like — set maxItems to cap the run, or leave it high to pull everything available.

Do I need any setup or a login? No setup and no login. Just add the actor, choose a mode, and run.

Why are genres, countries or runtime empty in collection mode? List mode returns the core fields quickly. Turn on Enrich with full details (or use detail mode) to add genres, countries and runtime per title.

Can I search for a specific title or director? Yes. Use search mode with a keyword, or detail mode with subject ids.

What export formats are supported? JSON, CSV, Excel and XML, plus programmatic access through the Apify API.

How does billing work? You pay only per item you get, so costs scale with the number of titles you scrape.

Is the data only public data? Yes — the scraper returns only publicly available title information.

Can I integrate this with other tools? The Douban Scraper can be connected with almost any cloud service or web app thanks to integrations on the Apify platform. It works with Make, Zapier, Slack, Airbyte, GitHub, Google Drive and many more, plus the Apify API, JavaScript/Python clients and MCP. Or use webhooks to trigger an action whenever a run finishes.

Related Actors

• Toutiao Scraper
• V2EX Scraper
• Weibo Scraper

Notes

Original clean-room implementation. Returns only public data; you are responsible for compliance with Douban's terms. Not affiliated with Douban.