शो-स्तर की सिनेमा बिक्री, सीधे आपके मॉडल और BI में

सामान्य पैरामीटर

from

पहला दिन, YYYY-MM-DD (डिफ़ॉल्ट: 30 दिन पहले)

to

आख़िरी दिन, YYYY-MM-DD (डिफ़ॉल्ट: आज)

countries

कॉमा से अलग ISO देश कोड, जैसे de,fr,br (डिफ़ॉल्ट: आपके प्लान के सभी)

chains

कॉमा से अलग चेन कीज़ (डिफ़ॉल्ट: आपके प्लान की सभी)

compare

period | year | none: पिछली अवधि या पिछले साल की यही अवधि जोड़ता है

own

1: सिर्फ़ वे फ़िल्में, चेन और सिनेमाघर जो आपके रूप में चिह्नित हैं

ऑथेंटिकेशन

हर अनुरोध Authorization हेडर में आपके संगठन की की (key) लेकर जाता है। एक की ठीक वही देखती है जिसकी आपका प्लान अनुमति देता है: आपके डैशबोर्ड जैसे ही देश, चेन और इतिहास।

सीमाएँ और फ़ॉर्मेट

HTTPS पर JSON, UTF-8, हर देश के स्थानीय समय में तारीख़ें। प्रति की 60 अनुरोध प्रति मिनट। आँकड़े हर 30 मिनट में अपडेट होते हैं; कल का डेटा 06:00 UTC से पूरा होता है।

उदाहरण

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

{
  "range": ["2026-09-28", "2026-10-04"],
  "rows": [
    {
      "key": "film x|2026",
      "title": "Film X",
      "tickets": 412380,
      "screenings": 9214,
      "occupancy": 0.312,
      "share": 0.221,
      "prevTickets": 351904,
      "matchedTickets": 369720,
      "change": 0.0506,
      "perScreening": 44.8,
      "venues": 611,
      "countries": 2,
      "firstShow": "2026-10-02"
    }
  ]
}

बदलाव समान आधार पर गिने जाते हैं: अवधि के हर दिन को पिछली अवधि के उसी दिन से जोड़ा जाता है (एक हफ़्ता उन्हीं वारों की तुलना करता है), और केवल वे सिनेमा गिने जाते हैं जिन्हें जोड़ी के दोनों दिन पढ़ा गया। prevTickets और previous इन जोड़ियों पर पिछली अवधि हैं, matchedTickets और currentMatched वर्तमान; change इनके बीच का बदलाव है, या null जब जोड़ियों में वर्तमान टिकटों का दसवें हिस्से से कम हो। tickets और current हमेशा सभी सिनेमा शामिल करते हैं।