fond-kino.ru 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.
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'
Get current cinema trends including general box office statistics for the last 30 days grouped by weekend and the top films for yesterday.
No input parameters required.
{
"type": "object",
"fields": {
"top_films": "array of top-performing films with detailed box office and metadata",
"general_stats": "array of weekend box office statistics with revenue, tickets, sessions, and average price"
},
"sample": {
"data": {
"top_films": [
{
"id": "111081426",
"year": "2025",
"genre": "драма",
"title": "Коммерсант",
"money0": 373921381,
"country": "Россия",
"tickets0": 680069,
"launch_date": "2026.04.23T00:00:00"
}
],
"general_stats": [
{
"sum": 2462148730,
"rupart": 74.4,
"periodId": "TOTAL",
"quantity": 4991378,
"sessions": 453910,
"dateStart": "2026.04.15T00:00:00",
"dateFinish": "2026.05.15T00:00:00",
"middlePrice": 493.28,
"moneyPerSession": 5424.31,
"ticketsPerSession": 11
}
]
},
"status": "success"
}
}About the fond-kino.ru 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.
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.
- 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 | 250 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.