SEATmio API - cinema sales data for your own systems

What teams build with it

BI dashboards

Daily feeds into Power BI, Tableau, Looker or your data warehouse, next to your own sales.

Forecasting models

Presale curves and comparable titles as model inputs for opening-weekend and run forecasts.

Alternative data

Daily attendance of listed exhibitors and the films driving them, months before quarterly reports.

Endpoints

Method	Path	Description
GET	/v1/overview	Totals, tickets per day and the top films, chains and markets for the period.
GET	/v1/rank/{film\|chain\|market\|cinema}	A full ranking by film, chain, market or cinema, with share, occupancy and change.
GET	/v1/detail/{film\|chain\|market\|cinema}/{key}	One film, chain, market or cinema: totals, daily series, breakdowns, weekday x hour, formats, and the presale curve for films.
GET	/v1/premieres	Films opening in the next 45 days or in the last 7, with presold tickets.
GET	/v1/compare?dim=film&keys=a,b,c	Two to five films, chains, markets or cinemas side by side.
GET	/v1/search?q=	Find films and cinemas by name.

Common parameters

from: First day, YYYY-MM-DD (default: 30 days ago)
to: Last day, YYYY-MM-DD (default: today)
countries: Comma-separated ISO country codes, e.g. de,fr,br (default: all in your plan)
chains: Comma-separated chain keys (default: all in your plan)
compare: period | year | none: adds the previous period or the same period last year

Authentication

Every request carries your organisation's key in the Authorization header. A key sees exactly what your plan allows: the same markets, chains and history as your dashboard.

Limits and formats

JSON over HTTPS, UTF-8, dates in each market's local time. 60 requests a minute per key. Figures refresh every 30 minutes; yesterday is complete from 06:00 UTC.

Example

curl -H "Authorization: Bearer $SEATMIO_KEY" \
  "https://seatmio.com/api/v1/rank/film?from=2026-09-01&to=2026-09-21&countries=de,fr"

{
  "range": ["2026-09-01", "2026-09-21"],
  "rows": [
    {
      "key": "film x|2026",
      "title": "Film X",
      "tickets": 412380,
      "screenings": 9214,
      "occupancy": 0.312,
      "share": 0.221,
      "prevTickets": 348210,
      "perScreening": 44.8,
      "venues": 611,
      "countries": 2,
      "firstShow": "2026-09-03"
    }
  ]
}

API access is part of the API plan. Keys are issued by our team after a short conversation.

Ask for API access

Screening-level cinema sales, straight into your models and BI