SEATmio API

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

डैशबोर्ड जो कुछ दिखाता है, वह सब JSON के रूप में उपलब्ध है: हर शो, फ़िल्म, सिनेमा, चेन और मार्केट के लिए टिकट, ऑक्यूपेंसी और एडवांस बुकिंग, आपके प्लान के मार्केट्स के लिए।

API एक्सेस API प्लान का हिस्सा है। कीज़ हमारी टीम एक छोटी बातचीत के बाद जारी करती है।

टीमें इससे क्या बनाती हैं

BI डैशबोर्ड

Power BI, Tableau, Looker या आपके डेटा वेयरहाउस में रोज़ाना फ़ीड, आपकी अपनी बिक्री के साथ।

फ़ोरकास्टिंग मॉडल

ओपनिंग वीकेंड और पूरे रन के अनुमानों के लिए मॉडल इनपुट के रूप में एडवांस बुकिंग कर्व और तुलनीय फ़िल्में।

ऑल्टरनेटिव डेटा

लिस्टेड एग्ज़िबिटर्स और उन्हें चलाने वाली फ़िल्मों की रोज़ाना दर्शक संख्या, तिमाही रिपोर्ट से महीनों पहले।

एंडपॉइंट

मेथडपाथविवरण
GET/v1/overviewअवधि के लिए टोटल, प्रति दिन टिकट और टॉप फ़िल्में, चेन और मार्केट्स।
GET/v1/rank/{film|chain|market|cinema}फ़िल्म, चेन, मार्केट या सिनेमा के अनुसार पूरी रैंकिंग, शेयर, ऑक्यूपेंसी और बदलाव के साथ।
GET/v1/detail/{film|chain|market|cinema}/{key}एक फ़िल्म, चेन, मार्केट या सिनेमा: टोटल, रोज़ाना सीरीज़, ब्रेकडाउन, हफ़्ते का दिन x घंटा, फ़ॉर्मेट, और फ़िल्मों के लिए एडवांस बुकिंग कर्व।
GET/v1/premieresअगले 45 दिनों में या पिछले 7 दिनों में रिलीज़ होने वाली फ़िल्में, एडवांस में बिके टिकटों के साथ।
GET/v1/compare?dim=film&keys=a,b,cदो से पाँच फ़िल्में, चेन, मार्केट्स या सिनेमाघर साथ-साथ।
GET/v1/search?q=नाम से फ़िल्में और सिनेमाघर खोजें।

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

from
पहला दिन, YYYY-MM-DD (डिफ़ॉल्ट: 30 दिन पहले)
to
आख़िरी दिन, YYYY-MM-DD (डिफ़ॉल्ट: आज)
countries
कॉमा से अलग ISO देश कोड, जैसे de,fr,br (डिफ़ॉल्ट: आपके प्लान के सभी)
chains
कॉमा से अलग चेन कीज़ (डिफ़ॉल्ट: आपके प्लान की सभी)
compare
period | year | none: पिछली अवधि या पिछले साल की यही अवधि जोड़ता है

ऑथेंटिकेशन

हर अनुरोध 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-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 एक्सेस API प्लान का हिस्सा है। कीज़ हमारी टीम एक छोटी बातचीत के बाद जारी करती है।

API एक्सेस माँगें