# Fond Kino — 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.

> Access real-time Russian cinema box office statistics, search and explore detailed film catalogs, check screening schedules, and discover top-performing movies. Get industry insights through analytics reports, exhibitor information, and trending cinema data all from the official Russian Cinema Fund database.

**Category:** Entertainment | **Website:** [fond-kino.ru/](https://fond-kino.ru/) | **Docs:** [parse.bot/marketplace/f25f557b-4f2e-46cc-a810-2d242a19536b/fond-kino-ru-api](https://parse.bot/marketplace/f25f557b-4f2e-46cc-a810-2d242a19536b/fond-kino-ru-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-fond-kino-ru-api-f25f557b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_analytical_reports_list

List analytical reports and periodic cinema industry research. Returns paginated report entries with title, date range, and download URL. Each page returns up to 20 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offset` | integer | No | Pagination offset (number of items to skip). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fond-kino-ru-api-f25f557b/get_analytical_reports_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offset":"<integer>"}'
```

### get_exhibitors_list

List registered cinema exhibitors with their region, city, organization name, and cinema chain details. Results are paginated by page number with approximately 50 exhibitors per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starts at 1). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fond-kino-ru-api-f25f557b/get_exhibitors_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_film_box_office_dynamics

Get box office performance dynamics (revenue, viewers, sessions) over time for a specific film. Returns an object with an items array of data points grouped by the specified period (daily by default). Each point includes total revenue (sum), ticket count (quantity), sessions, and per-session averages. When period dates are omitted, defaults to the last 30 days. The first element with periodId 'TOTAL' is the aggregate for the entire period.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `film_id` | string | Yes | Numeric film ID. |
| `group_by` | integer | No | Grouping period: 1 for daily. |
| `period_end` | string | No | End date (YYYY-MM-DD). Omitting defaults to today. |
| `period_start` | string | No | Start date (YYYY-MM-DD). Omitting defaults to 30 days ago. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fond-kino-ru-api-f25f557b/get_film_box_office_dynamics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"film_id":"<string>","group_by":"<integer>","period_end":"<string>","period_start":"<string>"}'
```

### get_film_detail

Get detailed information about a specific film by its numeric EAIS ID. Returns the film title, metadata (box office summary from OG description, age restrictions, government support status), poster URL, and audience ratings from the ratings API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `film_id` | string | Yes | Numeric film ID from the EAIS catalog (e.g. 121113926). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fond-kino-ru-api-f25f557b/get_film_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"film_id":"<string>"}'
```

### get_film_screening_schedule

Get the screening schedule and distribution data over time for a film: number of cinemas, screening rooms, and sessions per day. When period dates are omitted, defaults to the last 30 days. The first element with periodId 'TOTAL' is the aggregate.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `film_id` | string | Yes | Numeric film ID. |
| `group_by` | integer | No | Grouping period in hours (24 for daily). |
| `period_end` | string | No | End date (YYYY-MM-DD). Omitting defaults to today. |
| `period_start` | string | No | Start date (YYYY-MM-DD). Omitting defaults to 30 days ago. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fond-kino-ru-api-f25f557b/get_film_screening_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"film_id":"<string>","group_by":"<integer>","period_end":"<string>","period_start":"<string>"}'
```

### get_homepage_trends

Retrieve current cinema market trends: general box office statistics for the last 30 days grouped by weekend period, and the top-performing films for yesterday. The general_stats array contains weekend-by-weekend revenue, tickets, sessions, and average price. The top_films array contains detailed per-film box office data including presales, first/second weekend sales, and cumulative totals.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fond-kino-ru-api-f25f557b/get_homepage_trends \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news_list

List industrial news and box office results summaries. Returns paginated results with title, date, summary, and view count. Each page returns up to 9 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offset` | integer | No | Pagination offset (number of items to skip). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fond-kino-ru-api-f25f557b/get_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offset":"<integer>"}'
```

### get_top20_box_office

Get the top box office films for a selected date or period. When period dates are omitted, defaults to yesterday. Returns an object with an items array of film objects with comprehensive box office data including presales, first/second weekend, cumulative totals, and per-session metrics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period_end` | string | No | End date in YYYY.MM.DD format. Omitting defaults to yesterday. |
| `period_start` | string | No | Start date in YYYY.MM.DD format. Omitting defaults to yesterday. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fond-kino-ru-api-f25f557b/get_top20_box_office \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period_end":"<string>","period_start":"<string>"}'
```

### search_films

Search the film catalog with optional filters by title keyword, release date range, distributor, box office bracket, and age restriction. Returns paginated results sorted by the specified order. Each page contains up to 10 films. Use the offset parameter to paginate through results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `age_restrictions` | string | No | Age restriction filter. |
| `distributor_id` | string | No | Filter by distributor ID. |
| `money` | string | No | Box office bracket filter. |
| `offset` | integer | No | Pagination offset (number of items to skip). |
| `order` | string | No | Sort order for results. |
| `period_end` | string | No | End date filter for release date (YYYY-MM-DD). |
| `period_start` | string | No | Start date filter for release date (YYYY-MM-DD). |
| `query` | string | No | Search keyword to filter films by title. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fond-kino-ru-api-f25f557b/search_films \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"age_restrictions":"<string>","distributor_id":"<string>","money":"<string>","offset":"<integer>","order":"<string>","period_end":"<string>","period_start":"<string>","query":"<string>"}'
```