m.maoyan.com APIm.maoyan.com ↗
Access Maoyan movie data via API: currently showing films, upcoming releases, ratings, cast, directors, posters, and detailed film info for the Chinese cinema market.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/9233022b-0167-4e26-915b-01866cc5090c/now_showing' \ -H 'X-API-Key: $PARSE_API_KEY'
获取正在热映的电影列表，包含电影ID、名称、评分、海报、演员、上映日期等信息。无需任何参数，返回当前所有正在上映的电影。
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer - 电影总数",
"movies": "array of movie objects with id, title, score, poster, actors, release_date, version, wish_count, show_info"
},
"sample": {
"data": {
"total": 71,
"movies": [
{
"id": 1528954,
"score": 9.5,
"title": "消失的人",
"actors": "郑恺,刘浩存,邱泽",
"poster": "https://p0.pipi.cn/mediaplus/friday_image_fe/e429585b9a14a19fd149480fe71def82fcf7a.jpg?imageMogr2/quality/80",
"version": "",
"show_info": "今天275家影院放映1836场",
"wish_count": 119402,
"release_date": "2026-05-01"
}
]
},
"status": "success"
}
}About the m.maoyan.com API
The Maoyan Movies API exposes 3 endpoints covering China's cinema listings from m.maoyan.com, returning structured data for currently showing films, upcoming releases, and individual movie records. The now_showing endpoint alone returns fields including title, score, poster, actors, release_date, version, and wish_count for every film currently in theaters — no parameters required.
Endpoints and Data Coverage
The API provides three endpoints. now_showing requires no input and returns the full list of films currently in Chinese theaters, including each film's id, title, score, poster, actors, release_date, version, wish_count, and show_info. The coming_soon endpoint adds an optional limit parameter to cap result count and an optional city_id parameter (e.g. 1 for Beijing) to filter upcoming films by city, returning the same core fields plus a coming_title field specific to pre-release listings.
Movie Detail
The movie_detail endpoint accepts a single required movie_id, obtained from the id field in either listing endpoint. It returns an expanded record with director, duration (in minutes), language, photos (an array of still image URLs), score, actors, poster, and version. This is the only endpoint that exposes director credits and film duration.
Regional Context and Field Notes
All data reflects the Chinese cinema market as listed on Maoyan. The version field captures release format (e.g. IMAX, 3D). The wish_count field in listing responses represents the number of users who have marked a film as anticipated — a demand signal available for both now-showing and coming-soon titles. City filtering in coming_soon uses numeric city IDs; Beijing maps to 1.
- Build a Chinese cinema schedule app showing currently playing films with posters and showtimes from
show_info - Track Maoyan audience scores over time using the
scorefield fromnow_showing - Display pre-release demand by surfacing
wish_countfor upcoming films fromcoming_soon - Populate a film database with director, duration, language, and cast from
movie_detail - Filter upcoming releases by city using the
city_idparameter to power a local cinema guide - Aggregate still images for a film using the
photosarray returned bymovie_detail - Monitor new theatrical releases by comparing
release_datevalues across periodicnow_showingcalls
| 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.
Does Maoyan have an official developer API?+
What does `movie_detail` return that the listing endpoints do not?+
movie_detail is the only endpoint that exposes director, duration (in minutes), language, and photos (an array of still image URLs). The listing endpoints now_showing and coming_soon return wish_count and show_info but do not include those fields.Does city filtering apply to currently showing films as well as upcoming ones?+
city_id parameter is available on coming_soon only. The now_showing endpoint returns a single national listing with no city filtering. You can fork this API on Parse and revise it to add city-scoped now-showing results as a separate endpoint.Does the API return user reviews or review text for films?+
Is pagination supported for the listing endpoints?+
now_showing returns all currently showing films in one response with no pagination parameters. coming_soon supports a limit parameter to cap the number of results but does not expose offset or page-based pagination. For large upcoming-film datasets you can fork the API on Parse and revise it to add offset support.