piaofang.maoyan.com APIpiaofang.maoyan.com ↗
Access China box office rankings, streaming heat scores, theater revenue, movie scheduling, and release calendars from Maoyan Piaofang via 7 structured endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/9a941e3a-e0c9-4d10-9e95-29e709fcaea5/get_realtime_box_office' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns historical overall market box office record rankings by single day, showing the top revenue dates in China box office history.
No input parameters required.
{
"type": "array",
"fields": {
"date": "string, date of the record (e.g. '2025年01月29日')",
"boxDesc": "string, revenue amount (e.g. '18.08亿')"
},
"sample": [
{
"date": "2025年01月29日",
"boxDesc": "18.08亿",
"jumpUrl": "https://piaofang.maoyan.com/api/movie/national/boxRank.json?dateType=1"
},
{
"date": "2021年02月12日",
"boxDesc": "16.93亿",
"jumpUrl": "https://piaofang.maoyan.com/api/movie/national/boxRank.json?dateType=1"
}
]
}About the piaofang.maoyan.com API
The Maoyan Piaofang API exposes 7 endpoints covering China's film and streaming market, including all-time box office totals, real-time scheduling share, theater-level daily revenue, and online streaming heat rankings. The get_alltime_box_office_rankings endpoint returns each film's boxInfo, movieId, movieName, and releaseInfo, while get_theater_rankings breaks down individual cinemas by ticket price, viewer count, and screening average.
Box Office and Scheduling Data
Two endpoints target theatrical performance directly. get_alltime_box_office_rankings returns the all-time China box office total rankings with fields like boxInfo (e.g. '154.46亿'), movieId, movieName, and releaseInfo. get_realtime_box_office returns historical single-day market records, each entry carrying a date and a boxDesc revenue string. For daily scheduling, get_movie_scheduling lists every current title's screening count, countRate (percentage share of total screenings), and movieId.
Theater and Release Intelligence
get_theater_rankings surfaces individual cinemas ranked by daily revenue, with boxDesc, viewCountDesc, avgViewBoxDesc (average ticket price), and avgShowViewDesc (average viewers per screening) — useful for tracking geographic performance concentration. get_release_calendar returns the upcoming release calendar as two structured objects: releaseInfo maps dates to movie counts, and releaseList groups detailed film records by release date.
Streaming and Search
get_online_streaming_heat_rankings returns online shows ranked by currHeat score, with each entry's seriesInfo object carrying name, platformDesc, releaseInfo, and seriesId. For discovery, search_movies_and_shows accepts a query string (Chinese title or partial title) and returns matching results including title, cast, director, box_office, and release_date. Results follow Maoyan's own fuzzy matching logic.
- Track which films currently hold the largest share of national screening slots using
countRatefromget_movie_scheduling - Build an all-time China box office leaderboard with
boxInfoandmovieNamefromget_alltime_box_office_rankings - Monitor online streaming competition by comparing
currHeatscores andplatformDescacross shows - Identify top-performing cinemas by daily revenue, average ticket price, and viewers-per-screening from
get_theater_rankings - Plan release-window analysis by pulling upcoming titles and their dates from
get_release_calendar - Search a film by partial Chinese title and retrieve its box office total and cast via
search_movies_and_shows - Record historical single-day market peaks using the
dateandboxDescfields fromget_realtime_box_office
| 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 Piaofang have an official developer API?+
What does `get_theater_rankings` return and how granular is it?+
get_theater_rankings returns individual cinema entries with name, boxDesc (daily revenue in 万), viewCountDesc (total viewers), avgViewBoxDesc (average ticket price), and avgShowViewDesc (average viewers per screening). It covers today's rankings nationally but does not break down performance by individual film within each theater.Does the API return per-movie daily box office trends over time?+
get_alltime_box_office_rankings, single-day market records via get_realtime_box_office, and today's scheduling share via get_movie_scheduling, but does not expose a time-series of daily revenue per individual film. You can fork this API on Parse and revise it to add an endpoint targeting per-film daily performance data.How does `search_movies_and_shows` handle queries, and what happens if a title has no box office data?+
query string (Chinese title or partial title) and applies Maoyan's own fuzzy matching. When a result has no recorded box office, the box_office field returns the string '暂无票房数据' rather than null, so callers should check for that sentinel value rather than treating the field as numeric.