Douban Scraper

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?

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

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"] }

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.

Notes

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

You pay only for what the run returns. Set a maximum cost per run and it stops cleanly at that limit.