# Zgdypw — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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.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.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.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.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.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.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.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.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.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.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.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.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.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.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>"}'
```