# China Box Office API

> China daily box office: national totals and top films, cinema chains, cities and cinemas

- Vendor: `chinaboxofficeapi` · version 1.0 · category Movies · tags china box office api, chinese movies api, box office data api, cinema revenue api, film ticket sales api, china cinema api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/chinaboxofficeapi
- This document: https://apiclay.com/docs/chinaboxofficeapi.md
- OpenAPI 3.1: https://apiclay.com/api/chinaboxofficeapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `chinaboxofficeapi`
- Updated: 2026-11-18

## About

## China Box Office API

The national box-office figures published by China's film data platform (zgdypw.cn, the National Film Special Fund Office): for the current business day, the national gross, screenings, admissions and number of cinemas, and the top 10 films (day gross, screenings, admissions, cumulative gross), top 10 cinema chains, top 10 cities and top 10 cinemas.

Data comes from **zgdypw.cn** (https://www.zgdypw.cn). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/daily` for today's figures; call it through the day to follow the running total.

### Routes

#### GET `/daily` - Daily box office
No parameters.

Returns: `data.businessDay`, `data.dayBoxoffice` (`totalBoxoffice`, `totalSession`, `totalAudience`, `cinemaCount`), `top10Films` (`rank`, `filmName`, `daySales`, `daySession`, `dayAudience`, `filmTotalSales`), `top10CinemaChains`, `top10Citys`, `top10Cinemas`.

### Caveats

- Money is in units of 10,000 yuan (万元). Names are in Chinese. Figures update through the day and are final the next morning.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by zgdypw.cn.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /daily — Daily box office
- Gateway: `GET https://api.apiclay.com/v1/api/chinaboxofficeapi/daily`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/chinaboxofficeapi/daily" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
