fond-kino APIfond-kino.ru ↗
Access Russian cinema box office stats, film catalog, screening schedules, exhibitor data, and analytical reports from the EAIS platform via 9 structured endpoints.
What is the fond-kino API?
The fond-kino.ru API exposes 9 endpoints covering the Russian cinema industry data published by the Cinema Fund's EAIS platform, including box office revenue, ticket sales, and screening distribution. get_top20_box_office returns daily or period-level rankings with ruble revenue and distributor attribution. get_film_box_office_dynamics provides time-series performance data per film. get_exhibitors_list surfaces registered cinema operators with region and chain details.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/d56c4fb4-6737-4279-8ed5-a838f3c7f232/get_homepage_trends' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace fond-kino-ru-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""EAIS Cinema Data API - Usage Example
Explore Russian cinema box office data: search films, view trends,
drill into per-film performance, and browse exhibitors.
"""
from parse_apis.eais_cinema_data_api import Eais, FilmSortOrder, FilmNotFound
client = Eais()
# Browse top box office films for yesterday — iterate the collection.
for top in client.topfilms.list(limit=5):
print(f"{top.title} ({top.distributor}): revenue={top.money0}, tickets={top.tickets0}")
# Search films sorted by revenue, take first result and drill in.
film = client.films.search(order=FilmSortOrder.MONEY, limit=1).first()
if film:
print(f"\nTop film: {film.title} (id={film.id}, released {film.release_date})")
# Box office dynamics over the default last 30 days.
for point in film.box_office_dynamics(limit=3):
print(f" {point.date_start}: revenue={point.sum}, viewers={point.quantity}")
# Screening distribution data.
for sched in film.screening_schedule(limit=3):
print(f" {sched.date_start}: cinemas={sched.cinemas_num}, rooms={sched.srooms_num}")
# Browse exhibitors with auto-pagination.
for exhibitor in client.exhibitors.list(limit=3):
print(f"{exhibitor.name} — {exhibitor.city}, {exhibitor.region}")
# Typed error handling for a non-existent film.
try:
detail = client.films.get(id="99999999999")
print(detail.title)
except FilmNotFound as exc:
print(f"\nFilm not found: {exc.film_id}")
print("\nExercised: topfilms.list / films.search / box_office_dynamics / screening_schedule / exhibitors.list / films.get")
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.
No input parameters required.
{
"type": "object",
"fields": {
"top_films": "array of top-performing films with detailed box office metrics and metadata",
"general_stats": "array of weekend box office statistics with revenue, tickets, sessions, and average price"
},
"sample": {
"data": {
"top_films": [
{
"id": "121113926",
"sum": 38805964,
"year": "2026",
"genre": "биографический,музыка",
"title": "МАЙКЛ",
"money0": 841408002,
"country": "США, Великобритания",
"director": "Антуан Фукуа",
"quantity": 83430,
"sessions": 4642,
"tickets0": 1525923,
"distributor": "ВОЛЬГА",
"launch_date": "2026.05.28T00:00:00"
}
],
"general_stats": [
{
"sum": 2539154749,
"rupart": 56.8,
"periodId": "TOTAL",
"quantity": 4976149,
"sessions": 406093,
"dateStart": "2026.05.12T00:00:00",
"dateFinish": "2026.06.11T00:00:00",
"middlePrice": 510.27,
"moneyPerSession": 6252.64,
"ticketsPerSession": 12
}
]
},
"status": "success"
}
}About the fond-kino API
Film Catalog and Box Office
search_films accepts filters for release date range (period_start, period_end), distributor ID, age restrictions, box office bracket (money), and a keyword query. Results return paginated film objects with id, title, poster, url, and release_date, controlled via offset and has_more. get_film_detail takes a film_id and returns structured metadata (distributor, genre, country, director) alongside an audience ratings object from the EAIS ratings feed.
Time-Series Performance Data
get_film_box_office_dynamics returns per-period records — each with sum (rubles), quantity (tickets), sessions, dateStart, and dateFinish — for a given film over a configurable date window. The group_by parameter controls granularity (1 for daily). get_film_screening_schedule covers distribution metrics for the same window: cinemasNum, sroomsNum, and seansesNum per period. Both endpoints default to the last 30 days when dates are omitted.
Trends, Rankings, and Industry Content
get_homepage_trends returns two parallel datasets: top_films (yesterday's leaders with box office metadata) and general_stats (weekend-aggregated revenue, tickets, sessions, and average ticket price for the past 30 days). get_top20_box_office accepts period_start and period_end in YYYY.MM.DD format and returns ranked film objects including money0, tickets0, distributor, and launch_date.
Exhibitors, News, and Reports
get_exhibitors_list returns paginated records of registered cinema exhibitors, each carrying region, city, name, id, and chain. get_news_list provides industry news items with title, date, summary, and views. get_analytical_reports_list lists periodic research publications with title, date_range, and a direct url to the report download.
The fond-kino API is a managed, monitored endpoint for fond-kino.ru — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fond-kino.ru changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official fond-kino.ru API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track weekly Russian box office rankings by pulling
get_top20_box_officefor consecutive weekend periods. - Build a film performance dashboard using
get_film_box_office_dynamicsto chart ruble revenue and ticket sales over time. - Monitor how wide a film's theatrical release is by comparing
cinemasNumandsroomsNumfromget_film_screening_schedule. - Populate a Russian cinema catalog with poster, release date, distributor, and genre data from
search_filmsandget_film_detail. - Map cinema operator coverage by region using exhibitor
region,city, andchainfields fromget_exhibitors_list. - Aggregate industry news headlines and view counts for a media monitoring tool using
get_news_list. - Download links to official EAIS analytical reports for offline research using
get_analytical_reports_list.
| 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 | 100 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 fond-kino.ru have an official public developer API?+
What does `get_film_box_office_dynamics` return and how granular is the data?+
get_film_box_office_dynamics returns an array of period records for a specific film_id, each with total revenue (sum in rubles), tickets sold (quantity), screening sessions, and the period start/end timestamps. Setting group_by to 1 gives daily granularity. Omitting date parameters defaults the window to the past 30 days.Does the API cover individual cinema-level box office breakdowns?+
Can I filter the film catalog by distributor or genre?+
search_films supports filtering by distributor_id, age_restrictions, box office bracket (money), release date range, and a keyword query. Genre is returned in the metadata object from get_film_detail but is not currently a filter parameter in the search endpoint. You can fork the API on Parse and revise it to add genre-based filtering.How far back does box office historical data go?+
period_start and period_end parameters are accepted on get_film_box_office_dynamics, get_film_screening_schedule, and get_top20_box_office, allowing custom date ranges. The effective historical depth depends on what the EAIS platform retains; deep archival coverage is not guaranteed for all films.