ما تبنيه الفرق باستخدامه
لوحات BI
تغذية يومية إلى Power BI أو Tableau أو Looker أو مستودع بياناتك، إلى جانب مبيعاتك الخاصة.
نماذج التوقع
منحنيات المبيعات المسبقة والأفلام المماثلة كمدخلات للنماذج لتوقع إيرادات عطلة الافتتاح ومدة العرض.
البيانات البديلة
الحضور اليومي لدى مشغّلي دور السينما المدرجين في البورصة والأفلام التي تحركه، قبل التقارير الفصلية بأشهر.
نقاط النهاية
كل مسار أدناه هو نقطة نهاية تعمل عليها لوحة SEATmio نفسها. ما لم يذكر الصف خلاف ذلك، يقبل المعاملات المشتركة ولا يجيب إلا ضمن حدود خطتك.
السوق والترتيب
| الطريقة | المسار | الوصف |
|---|---|---|
| GET | /v1/overview | الإجماليات والتذاكر يوميًا وأبرز الأفلام والسلاسل والدول للفترة. |
| GET | /v1/rank/{film|chain|market|cinema|distributor} | ترتيب كامل حسب الفيلم أو السلسلة أو الدولة أو دار السينما أو الشركة، مع الحصة ونسبة الإشغال والتذاكر لكل عرض والتغير المماثل. يضيّقه chain= أو film=. |
| GET | /v1/detail/{film|chain|market|cinema|distributor}/{key} | فيلم أو سلسلة أو دولة أو دار سينما واحدة: الإجماليات والسلسلة اليومية والتفصيلات ويوم الأسبوع x الساعة والصيغ ومنحنى المبيعات المسبقة للأفلام. |
| GET | /v1/compare?dim=film&keys=a,b,c&align=release | الخطوط اليومية لاثنين إلى خمسة أفلام أو سلاسل أو دول أو دور سينما جنبًا إلى جنب؛ align=release يبدأ كل فيلم من يومه الأول. |
| GET | /v1/weekend?friday=YYYY-MM-DD | شباك تذاكر عطلة نهاية الأسبوع بالتذاكر، من الجمعة إلى الأحد حسب الفيلم، مقارنة بالعطلة السابقة، مع أسبوع العرض والتذاكر لكل دار والإجمالي حتى الآن. |
| GET | /v1/live | اليوم حتى الآن: الإجماليات والتذاكر حسب ساعة البدء وأبرز الأفلام وأكثر عروض اليوم مبيعًا. |
| GET | /v1/legs | الأفلام المستمرة: آخر سبعة أيام عرض مع أسبوع العرض والانخفاض المماثل مقارنة بالأسبوع السابق والمضاعف. |
| GET | /v1/search?q= | ابحث عن الأفلام ودور السينما والشركات بالاسم. |
فيلم واحد
| الطريقة | المسار | الوصف |
|---|---|---|
| GET | /v1/film/{key}/presale?country=xx | المبيعات المسبقة في دولة واحدة: التذاكر المباعة بالفعل للعروض القادمة. |
| GET | /v1/film/{key}/presale-start | متى بدأت كل سلسلة بيع الفيلم، وأي سلسلة كانت الأولى في كل دولة، وأي السلاسل لا تبيعه بعد. |
| GET | /v1/film/{key}/forecast | الأسبوع الأول المتوقع، ولا يُنشر إلا حيث أثبت النموذج دقته. |
| GET | /v1/legs/film/{key} | أسابيع عرض الفيلم في كل دولة، مع الانخفاض من أسبوع لآخر. |
| GET | /v1/film/{key}/programming | جودة البرمجة لكل دار سينما: العروض والإشغال وترتيب الفيلم في تلك الدار حسب الإشغال وعدد العروض وحصة أوقات الذروة وحجم القاعات. |
| GET | /v1/film/{key}/lost-slots | من أخذ مواعيد الفيلم: لكل دار وقاعة وفترة زمنية، الفيلم الذي كسب العروض المفقودة، مع نسبتي الإشغال. |
| GET | /v1/film/{key}/missing-cinemas | دور سينما في دول الفيلم لا تعرضه، رغم أن أفلامًا مماثلة باعت جيدًا فيها. |
| GET | /v1/demand/film?film={key} | مؤشر طلب الفيلم في كل دولة: حصة التذاكر مقسومة على حصة العروض (فوق 1.2 عروض أقل من الطلب، تحت 0.8 أكثر). |
| GET | /v1/audience/film/{key}?part=versions|timing | النسخ اللغوية (حصة العروض مقابل حصة التذاكر، مدينة بمدينة) أو مدى تبكير الشراء، مقارنة بالسوق والأفلام المماثلة. |
| GET | /v1/film/{key}/interest | مؤشر الاهتمام قبل الإصدار في كل دولة، مع إشاراته وسجل 60 يومًا. |
| GET | /v1/film/{key}/social | حسابات الفيلم على وسائل التواصل يومًا بيوم وأعداد الوسوم. |
تخطيط الإصدارات
| الطريقة | المسار | الوصف |
|---|---|---|
| GET | /v1/premieres | أفلام تُعرض لأول مرة خلال الأيام الـ 120 القادمة أو الأيام السبعة الماضية، مع التذاكر المبيعة مسبقًا. |
| GET | /v1/release-calendar?weeks=16 | الأسابيع القادمة في كل دولة: الأفلام التي تُطرح ومبيعاتها المسبقة وعدد الإصدارات الواسعة المتنافسة والعطل، إضافة إلى العناوين المعلنة حتى عام مقدمًا. |
| GET | /v1/demand | كل فيلم في النطاق مع مؤشر طلبه: أي الأفلام تبيع أكثر مما تتيحه شاشاتها وأيها أقل. |
| GET | /v1/free-screens?country=xx&weeks=YYYY-MM-DD,... | الشاشات المتوقع أن تتحرر كل أسبوع في دولة مقابل حاجة الإصدارات الجديدة، مع الخطأ المقيس للتقدير. |
| GET | /v1/cut-risk?film=&chain= | لكل سلسلة، نسبة الإشغال التي تقلص عادة دونها عروض الفيلم، حسب أسبوع العرض، ومخاطر الفيلم هذا الأسبوع. |
| GET | /v1/calendar | العطل الرسمية والمدرسية في دول النطاق خلال تواريخه. |
دور السينما والعروض والبرنامج
| الطريقة | المسار | الوصف |
|---|---|---|
| GET | /v1/screenings?dim={film|chain|market|cinema}&key= | العروض الفردية لفيلم أو سلسلة أو دولة أو دار سينما: القاعة والنسخة والتذاكر والسعة والإشغال؛ العروض القادمة تُظهر المبيعات حتى الآن. |
| GET | /v1/screening/{id} | عرض واحد: كيف بيعت تذاكره يومًا بيوم قبل بدئه، مقارنة بمتوسط عرض الفيلم ومتوسط عرض الدار في ذلك اليوم. |
| GET | /v1/schedule?days=7 | البرنامج المنشور للأيام القادمة (حتى 21) حسب الفيلم والسلسلة، مقارنة بأيام الأسبوع نفسها قبل أسبوع. |
| GET | /v1/schedule/film/{key} | برنامج فيلم واحد: سلسلة x يوم للأيام الـ 14 القادمة، والأسبوع السابق، وإلغاءاته الأخيرة. |
| GET | /v1/cancellations?days=7 | العروض المسحوبة قبل بدئها في الأيام الأخيرة (حتى 14)، حسب الفيلم والسلسلة. |
| GET | /v1/cinema/{id}/programming | كل الأفلام في دار سينما واحدة، مرتبة حسب الإشغال وعدد العروض. |
| GET | /v1/cinema/{id}/nearby?km=5|10|25 | منطقة الجذب: دور السينما ضمن المسافة، وحصة هذه الدار من تذاكرها، والأفلام التي يبيعها المنافسون أفضل. |
| GET | /v1/cinema/{id}/benchmark | دار سينما واحدة مقارنة بمنطقتها ودولتها. |
| GET | /v1/cities | ترتيب المدن في النطاق، مع إحداثيات لخريطة. |
الشركات والأشخاص
| الطريقة | المسار | الوصف |
|---|---|---|
| GET | /v1/company/{id}/films?role= | أفلام موزع أو منتج أو وكيل مبيعات مع نتائجها في دولك. |
| GET | /v1/people?category=&q= | الأشخاص مرتبون حسب تذاكر أفلامهم: المخرجون والممثلون والكتّاب وغيرهم. |
| GET | /v1/person/{id} | ملف شخص: نتائج أفلامه في دولك وأعماله وجوائزه. |
السياق وجودة البيانات
| الطريقة | المسار | الوصف |
|---|---|---|
| GET | /v1/events?country=xx | الحفلات والمباريات الكبرى قرب دور السينما والكوارث الطبيعية خلال الفترة. |
| GET | /v1/weather?country=xx | الطقس اليومي حيث يوجد الجمهور: لدار سينما واحدة أو لدولة موزونة بالتذاكر. |
| GET | /v1/coverage | لكل دولة، دور السينما التي قُرئت مبيعاتها في آخر 7 أيام. |
| GET | /v1/freshness | متى تحركت الأرقام آخر مرة، ولكل سلسلة أحدث قراءة اليوم. |
| GET | /v1/status | لكل دولة وسلسلة: دور السينما المقروءة وآخر قراءة ومنذ متى وأي مشكلة مفتوحة. |
المعاملات المشتركة
- from
- اليوم الأول، YYYY-MM-DD (الافتراضي: قبل 30 يومًا)
- to
- اليوم الأخير، YYYY-MM-DD (الافتراضي: اليوم)
- countries
- رموز ISO للدول مفصولة بفواصل، مثل de,fr,br (الافتراضي: كل ما في خطتك)
- chains
- مفاتيح السلاسل مفصولة بفواصل (الافتراضي: كل ما في خطتك)
- compare
- period | year | none: يضيف الفترة السابقة أو الفترة نفسها من العام الماضي
- own
- 1: الأفلام والسلاسل ودور السينما المعلّمة كأنها لك فقط
المصادقة
يحمل كل طلب مفتاح مؤسستك في ترويسة Authorization. يرى المفتاح بالضبط ما تسمح به خطتك: الدول والسلاسل والسجل نفسها كما في لوحة التحكم.
الحدود والصيغ
JSON عبر HTTPS بترميز 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 يشملان دائمًا كل دور السينما.
الوصول إلى API جزء من خطة API. يصدر فريقنا المفاتيح بعد محادثة قصيرة.
اطلب الوصول إلى API