حيّ · مجاني · بلا مفتاح

واجهة كأس العالم 2026 — JSON API

واجهة JSON مجانيّة وعامّة لكأس العالم 2026: المباريات، النتائج المباشرة، أهداف وبطاقات المباراة، إحصائيات الفيفا الرسميّة، الهدّافون، وترتيب المجموعات. بلا مفتاح وبلا تسجيل.

⚡ CORS: * 📦 application/json 🕐 كاش ~60 ثانية 🆓 بلا تسجيل

الرابط الأساسي

كل طلب هو GET بسيط — بلا ترويسات وبلا توكن.

https://wcup2026.org/api/data.php?action=<ACTION>

// كل رد ضمن غلاف موحّد
{ "ok": true, "action": "today", "updated": 1718600000, "matches": [ … ] }

نقاط النهاية (Endpoints)

مرّر معامل action. المعاملات بالبرتقالي إلزاميّة.

الإجراء	المعاملات	يُرجِع
`today`	—	مباريات اليوم
`live`	—	المباريات المباشرة الآن
`upcoming`	limit	المباريات القادمة
`results`	limit	المباريات المنتهية بنتائجها
`all`	—	كل الـ104 مباراة
`match`	id	مباراة واحدة بكامل التفاصيل — أهداف، بطاقات، إحصائيات الفيفا
`scorers`	—	الهدّافون (سباق الحذاء الذهبي)
`standings`	—	ترتيب المجموعات الـ12
`group`	g	ترتيب مجموعة واحدة (`Group A`)
`physical`	—	بيانات الجري لكل لاعب من تقارير الفيفا

بداية سريعة

استخدمها مباشرةً من المتصفّح أو تطبيق جوّال (React Native / Flutter) أو أي خادم.

# curl
curl "https://wcup2026.org/api/data.php?action=results"
curl "https://wcup2026.org/api/data.php?action=match&id=12"
curl "https://wcup2026.org/api/data.php?action=scorers"

// JavaScript
const res  = await fetch(
  'https://wcup2026.org/api/data.php?action=scorers');
const data = await res.json();
console.log(data.scorers);
// [{ name, team, goals }, …]

جرّبها الآن

هذا الصندوق يستدعي الـAPI الحقيقي من متصفّحك الآن.

GET `?action=scorers` → أعلى 5

جارٍ التحميل…

بنية الردود

كائن المباراة

{
  "id": 12, "round": "Matchday 7", "group": "Group C",
  "team1": "Brazil",   "team2": "Morocco",
  "team1_ar": "البرازيل", "team2_ar": "المغرب",
  "flag1": "https://flagcdn.com/w80/br.png",
  "status": "finished",   // upcoming | live | finished
  "score": [1, 1],       // [team1, team2] full-time (incl. extra time), or null
  "penalties": [4, 2],   // shoot-out [team1, team2] — only if decided on penalties, else null
  "winner": "team1",   // team1 | team2 | draw | null (not finished)
  "live_minute": null,
  "date": "2026-06-14", "time": "20:00", "datetime": 1718390000,
  "ground": "Dallas (Arlington)"
}

`?action=match&id=N` يضيف تفاصيل

{
  "ht": [0, 1],                              // half-time
  "goals1": [{ "name":"Vinícius Júnior", "minute":"32", "penalty":true }],
  "goals2": [ … ],
  "cards":  [{ "team":1, "minute":61, "name":"…", "type":"yellow" }],
  "stats":  { "possession":[…], "shots":[…], "xg":[…] }
}

هدّاف

{ "name":"Lionel Messi",
  "team":"Argentina",
  "goals":3 }

صفّ ترتيب

{ "team":"Mexico", "pts":3,
  "played":1, "w":1, "d":0, "l":0,
  "gf":2, "ga":0, "gd":2 }

نصّ صِرف (football.txt)

البطولة كاملةً مُصدَّرة أيضاً بصيغة openfootball football.txt.

https://wcup2026.org/football.php            # الجدول + النتائج
https://wcup2026.org/football.php?results    # النتائج فقط
https://wcup2026.org/football.php?reports    # + هدّافون + بطاقات

🚀 بُنيت بواجهتنا

تطبيقات ومشاريع يبنيها مطوّرون باستخدام هذا الـAPI:

FIFA World Cup Fixtures — تطبيق أندرويد على Google Play

بنيت شيئاً بواجهتنا؟ أخبرنا لنعرضه هنا: info@wcup2026.org

الاستخدام العادل

للقراءة فقط ومجّاني. خزّن مؤقّتاً حيثما أمكن (البيانات تتحدّث كل دقيقة تقريباً). الإسناد مُقدَّر — ضع رابطاً إلى wcup2026.org. بيانات الجدول من openfootball (ملك عام)؛ إحصائيات المباراة من بيانات الفيفا الرسميّة.