maoyan.com APIwww.maoyan.com ↗
Access Maoyan movie data via API: now-showing and coming-soon listings, detailed movie info, cinema availability, and filter options for Chinese theaters.
curl -X GET 'https://api.parse.bot/scraper/e9bfd954-21ee-4c0c-8ba9-f8fe2c8276d5/list_movies?limit=5&city_id=1&show_type=2' \ -H 'X-API-Key: $PARSE_API_KEY'
List movies currently showing in theaters or coming soon. Returns movie names, scores, stars, release dates, poster images, and showing info. For now-showing (show_type=1), returns paginated results in batches of up to 12 per offset page. For coming-soon (show_type=2), returns all upcoming movies up to the limit.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of movies to return. |
| offset | integer | Pagination offset for now-showing movies (applies to show_type=1 only). |
| city_id | string | City ID (e.g. 1 for Beijing, 59 for Chengdu). |
| show_type | string | 1 for now showing, 2 for coming soon. |
{
"type": "object",
"fields": {
"count": "integer number of movies returned in this response",
"total": "integer total number of movies available",
"movies": "array of movie objects with id, name, poster, score, stars, release_date, show_info",
"movie_ids": "array of all movie IDs (now_showing only)",
"show_type": "string indicating 'now_showing' or 'coming_soon'"
},
"sample": {
"data": {
"count": 5,
"total": 60,
"movies": [
{
"id": 1528954,
"name": "消失的人",
"score": 0,
"stars": "郑恺,刘浩存,邱泽",
"poster": "https://p0.pipi.cn/mediaplus/friday_image_fe/e429583d494b81374c1fae82faddb2ae3dbf5.jpg?imageMogr2/quality/80",
"version": "",
"pre_show": false,
"show_info": "今天282家影院放映2094场",
"wish_count": 88602,
"release_date": "2026-05-01"
}
],
"offset": 0,
"movie_ids": [
1528954,
1575885,
1525209
],
"show_type": "now_showing"
},
"status": "success"
}
}About the maoyan.com API
This API exposes 4 endpoints covering Maoyan's Chinese movie ecosystem, returning now-showing and coming-soon film listings, full movie details, and cinema availability data. The list_movies endpoint alone returns up to 12 fields per movie object including score, cast, poster URL, release date, and show info. Together, the endpoints let you query across cities, filter cinemas by district, and retrieve trailers and photo galleries for specific titles.
Movie Listings
The list_movies endpoint returns paginated movie data for either now-showing (show_type=1) or coming-soon (show_type=2) films. Each movie object includes id, name, poster, score, stars, release_date, and show_info. Results can be scoped to a specific city using city_id (e.g. 1 for Beijing, 59 for Chengdu). For now-showing titles, the response also includes a movie_ids array covering all available film IDs in the city. Pagination is controlled via offset and limit, with up to 12 results per page for now-showing queries.
Movie Details
get_movie_detail accepts a movie_id from list results and returns an expanded record: director, category (genre tags), duration in minutes, wish_count, video_url for the trailer, and a photos array of image URLs. Score and cast fields (stars) are also present, giving enough data to build a full movie profile page without additional requests.
Cinema Listings and Filters
list_cinemas returns up to 20 cinemas per request showing a given movie_id in a city. Each cinema object includes name, address, sell_price, distance, allow_refund, has_snack, vip_tag, and show_times. Use district_id — obtained from get_cinema_filters — to narrow results to a specific urban district. Pagination via offset is supported, though the upstream source caps results at 20 per page.
get_cinema_filters provides the full set of filterable dimensions for a movie/city combination: brand, district, hallType, service, subway, and timeRanges. Each filter category carries a name and an options array, which feeds directly into district_id values for list_cinemas.
- Build a city-specific now-showing listings page using list_movies with city_id and show_type=1
- Display a movie detail page with trailer, cast, director, genre, and photo gallery from get_movie_detail
- Find cinemas near a district screening a given film using list_cinemas with district_id from get_cinema_filters
- Track wish_count across coming-soon titles over time to gauge pre-release audience interest
- Aggregate sell_price data from list_cinemas to compare ticket pricing across theaters in a city
- Surface refund policy and snack availability per cinema using allow_refund and has_snack fields
- Populate a movie search UI with poster images, scores, and release dates from list_movies
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.