# Zgdypw — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track China's movie box office performance with daily rankings by movie, cinema, circuit, and city, plus access detailed weekly and monthly reports for comprehensive market analysis. Monitor industry trends through curated market analysis articles and reports to stay informed on the Chinese film industry's performance and growth.

**Category:** Entertainment | **Website:** [zgdypw.cn/](https://zgdypw.cn/) | **Docs:** [parse.bot/marketplace/2c483492-1cc5-48c5-a567-8cb690ec9ac8/zgdypw-cn-api](https://parse.bot/marketplace/2c483492-1cc5-48c5-a567-8cb690ec9ac8/zgdypw-cn-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get daily box office cinemas

Fetch current daily box office data for cinemas. Returns top 10 cinemas ranked by daily sales with their name, total sales, session count, and audience count.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/get_daily_box_office_cinemas \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get daily box office circuits

Fetch current daily box office data for cinema circuits/chains. Returns top 10 circuits ranked by daily sales with their name, total sales, session count, and audience count.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/get_daily_box_office_circuits \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get daily box office cities

Fetch current daily box office data for cities. Returns top 10 cities ranked by daily sales with their name, total sales, session count, and audience count.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/get_daily_box_office_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get daily box office movies

Fetch current daily box office data for movies. Returns top 10 movies ranked by daily sales and a real-time market summary including total box office revenue, audience count, cinema count, and session count. Data updates throughout the business day.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/get_daily_box_office_movies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get market analysis article

Fetch and parse a specific market analysis article. Returns full article text content including province-level box office analysis. The URL must be obtained from list_market_analysis_articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the market analysis article, obtained from list_market_analysis_articles results |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/get_market_analysis_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get monthly box office report

Fetch and parse a specific monthly box office report article. These reports are image-based, returning the report title and image URLs of the report charts. The URL must be obtained from list_data_reports or list_monthly_reports.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the monthly report article, obtained from list_data_reports or list_monthly_reports results |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/get_monthly_box_office_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get new cinemas monthly report

Fetch and parse a market info article, typically a monthly new cinemas report. New cinemas reports contain structured table data listing newly opened cinemas with their names, locations, screen counts, and opening dates. The URL must be obtained from list_market_info_articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the market info article, obtained from list_market_info_articles results |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/get_new_cinemas_monthly_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get weekly box office report

Fetch and parse a specific weekly box office report article. These reports are image-based. The URL must be obtained from list_data_reports or list_weekly_reports; older URLs may return 404.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the weekly report article, obtained from list_data_reports or list_weekly_reports results |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/get_weekly_box_office_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### List data reports

Fetch the paginated list of all data reports (monthly and weekly box office reports). Each page returns up to 10 reports with their titles, publication dates, and article URLs. Navigate pages to access older reports.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/list_data_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### List market analysis articles

Fetch the paginated list of market analysis articles. Returns article titles, publication dates, and URLs. Articles contain province-level box office analysis and weekly market summaries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/list_market_analysis_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### List market info articles

Fetch the paginated list of market information articles including new cinema reports and movie announcements. Each page returns up to 10 articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/list_market_info_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### List monthly reports

Fetch only the monthly box office reports from the data reports listing, filtered by title containing the monthly report keyword (月报). Returns a subset of list_data_reports results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/list_monthly_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### List weekly reports

Fetch only the weekly box office reports from the data reports listing, filtered by title containing the weekly report keyword (周报). Returns a subset of list_data_reports results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-zgdypw-cn-api-2c483492/list_weekly_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```