zgdypw.cn APIzgdypw.cn ↗
Access daily China box office rankings by movie, cinema, circuit, and city, plus weekly/monthly reports and market analysis via the zgdypw.cn API.
curl -X GET 'https://api.parse.bot/scraper/977f48b3-069b-4d79-b678-ac96ee7b6b36/list_data_reports?page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch the paginated list of all data reports (monthly and weekly). Returns report titles, publication dates, and article URLs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed) |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"reports": "array of report objects with title, url, and date"
},
"sample": {
"data": {
"page": 1,
"reports": [
{
"url": "https://www.zgdypw.cn/sc/sjbg/202605/06/t20260506_7405437.shtml",
"date": "2026-05-06",
"title": "Report Title"
}
]
},
"status": "success"
}
}About the zgdypw.cn API
The zgdypw.cn API exposes 13 endpoints covering China's film market data from the China Film Data Information Network, including real-time daily box office rankings across four dimensions — movies, cinemas, circuits, and cities. Endpoints like get_daily_box_office_movies return a top-10 movie list with per-film gross, cumulative sales, session count, and audience count alongside a market-level summary. Paginated report listings and full article parsers give access to weekly and monthly box office reports and market analysis.
Daily Box Office Data
Four endpoints deliver current-day rankings with no input required. get_daily_box_office_movies returns up to 10 movies ranked by daySales, each with filmName, filmTotalSales, daySession, and dayAudience, plus a summary object carrying totalBoxoffice, totalAudience, cinemaCount, and totalSession for the businessDay. The parallel endpoints get_daily_box_office_cinemas, get_daily_box_office_circuits, and get_daily_box_office_cities follow the same shape, substituting cinemaName, cinemaChainName, or cityName as the ranking key.
Weekly and Monthly Reports
list_data_reports returns a paginated list (using the page parameter) of all available reports with title, url, and date. If you only want one type, list_monthly_reports and list_weekly_reports pre-filter the list. Pass a url from those results to get_monthly_box_office_report or get_weekly_box_office_report to retrieve the full article. Both report endpoints return title, text, and image_urls — the visual charts in these reports are image-based, so text is often empty and the charts live in image_urls. Note that older weekly report URLs may return a 404.
Market Analysis and New Cinema Reports
list_market_analysis_articles paginates market commentary articles. Fetching a specific article via get_market_analysis_article returns the full text content, which typically includes province-level box office breakdowns, alongside any image_urls. For cinema supply-side data, list_market_info_articles surfaces new cinema reports and movie announcements. get_new_cinemas_monthly_report parses structured table data from these pages, returning a table_data field — an array of arrays — listing newly opened cinemas with their names, locations, screen counts, and opening dates.
- Track daily Chinese box office gross and audience count per film to feed a film industry dashboard.
- Monitor top-performing cinema circuits by daily session count and revenue using
get_daily_box_office_circuits. - Build city-level box office heat maps from the
cityNameandtotalSalesfields inget_daily_box_office_cities. - Archive China monthly box office report images by collecting
image_urlsfromget_monthly_box_office_reporton a scheduled basis. - Parse newly opened cinemas — names, locations, and screen counts — from
table_datainget_new_cinemas_monthly_reportto track exhibition capacity growth. - Aggregate province-level box office commentary from
get_market_analysis_articletext for qualitative trend analysis. - Paginate through
list_weekly_reportsto build a historical index of weekly box office PDFs and chart images.
| 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 zgdypw.cn have an official developer API?+
What does `get_daily_box_office_movies` return, and how many movies does it cover?+
daySales). Each entry includes filmName, daySales, filmTotalSales, daySession, and dayAudience. A summary object covers the full market: totalBoxoffice, totalAudience, cinemaCount, totalSession, and the businessDay date. Films ranked outside the top 10 are not included in this response.Are historical daily box office figures available for a specific past date?+
get_daily_box_office_movies, get_daily_box_office_cinemas, get_daily_box_office_circuits, get_daily_box_office_cities) all return current-day data with no date parameter. Historical daily figures are not exposed. You can fork this API on Parse and revise it to add a date-filtered endpoint if the source exposes such a page.Why do some weekly report URLs return a 404?+
list_weekly_reports for recent reports should resolve correctly, but older entries in the paginated list may point to pages that no longer exist. It is worth checking the url field before making a downstream request.