Co zespoły z tym budują
Dashboardy BI
Codzienne zasilanie Power BI, Tableau, Looker albo hurtowni danych, obok Twojej własnej sprzedaży.
Modele prognoz
Krzywe przedsprzedaży i podobne tytuły jako dane wejściowe do prognoz weekendu otwarcia i całej eksploatacji.
Dane alternatywne
Dzienna frekwencja notowanych sieci kinowych i filmów, które je napędzają, miesiące przed raportami kwartalnymi.
Endpointy
| Metoda | Ścieżka | Opis |
|---|---|---|
| GET | /v1/overview | Sumy, bilety dziennie oraz najlepsze filmy, sieci i rynki w okresie. |
| GET | /v1/rank/{film|chain|market|cinema} | Pełny ranking według filmu, sieci, rynku lub kina, z udziałem, frekwencją i zmianą. |
| GET | /v1/detail/{film|chain|market|cinema}/{key} | Jeden film, sieć, rynek lub kino: sumy, seria dzienna, podziały, dzień tygodnia x godzina, formaty i krzywa przedsprzedaży dla filmów. |
| GET | /v1/premieres | Filmy wchodzące w ciągu 45 dni albo w ostatnich 7, z przedsprzedażą. |
| GET | /v1/compare?dim=film&keys=a,b,c | Od dwóch do pięciu filmów, sieci, rynków lub kin obok siebie. |
| GET | /v1/search?q= | Wyszukiwanie filmów i kin po nazwie. |
Wspólne parametry
- from
- Pierwszy dzień, RRRR-MM-DD (domyślnie: 30 dni temu)
- to
- Ostatni dzień, RRRR-MM-DD (domyślnie: dziś)
- countries
- Kody krajów ISO po przecinku, np. de,fr,br (domyślnie: wszystkie z pakietu)
- chains
- Klucze sieci po przecinku (domyślnie: wszystkie z pakietu)
- compare
- period | year | none: dodaje poprzedni okres albo ten sam okres rok wcześniej
Uwierzytelnianie
Każde zapytanie zawiera klucz Twojej organizacji w nagłówku Authorization. Klucz widzi dokładnie to, na co pozwala pakiet: te same rynki, sieci i historię co panel.
Limity i formaty
JSON przez HTTPS, UTF-8, daty w czasie lokalnym każdego rynku. 60 zapytań na minutę na klucz. Dane odświeżane co 30 minut; wczoraj jest kompletne od 06:00 UTC.
Przykład
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"
}
]
}Dostęp do API jest częścią pakietu API. Klucze wydaje nasz zespół po krótkiej rozmowie.
Zapytaj o dostęp do API