xG через API — ожидаемые голы и shotmap SportWire

Что такое xG и что отдаёт API

xG (Expected Goals) — вероятность того, что удар завершится голом, основанная на позиции, части тела, типе ситуации и позиции вратаря. Значение от 0 до 1: у пенальти xG высокий, у удара с острого угла — низкий.

Координаты каждого удара

Координаты x, y, сторона, минута и результат — shot_type: goal, save, miss, block, post

Суммарный xG команд за матч

Итоговые xG хозяев и гостей приходят в статистике матча — сравнивайте с фактическим счётом для оценки эффективности реализации

Моментум по ходу матча

Перевес по минутам — поле momentum в ответе события: наглядно показывает, когда команда создавала давление, а когда уступала

Траектория и точка в воротах

У удара есть trajectory — ломаная полёта, и goal_mouth_xy — куда именно он пришёл в створ. Хватает, чтобы нарисовать не только точку, но и удар целиком

Российская премьер-лига · 2-й тур · 2 августа 2026 матч завершён

КРА Краснодар

3:2

Факел Воронеж ФАК

Карта ударов · 24 удара

xG 0.83 xG 2.1

Краснодар: 11 ударов · 5 в створ Факел Воронеж: 13 ударов · 3 в створ цвет точки = результат удара

Из базы SportWire: матч #11220580, Российская премьер-лига, 2 августа 2026. Размер точки одинаковый: xG отдельного удара по этому матчу источник не прислал — поле xg у каждого удара пустое, и дорисовывать его мы не будем.

Когда нужен xG

Три типа продуктов, где xG создаёт реальную ценность для пользователей.

Спортивные редакции

Контекст к материалу

Автоматический вывод в матч-карточку:
«xG 0.83:2.1 — Факел Воронеж создал больше моментов, но проиграл 2:3» — матч #11220580 из базы SportWire.

Матч-центр Репортажи Превью

Аналитические сервисы

Исторические модели

Исторические xG для оценки реального уровня команды — без искажений, которые создаёт счёт. Базис для рейтинговых моделей и рекомендательных систем.

Data science ML-модели

Беттинг / Affiliate

Индикатор уровня команды

xG сглаживает удачу: в матче #11220580 Факел Воронеж создал 2.1 xG против 0.83 у команды Краснодар, но проиграл 2:3 — по созданию моментов он был сильнее. Используется для оценки недооценённых и переоценённых исходов на дистанции.

Value-поиск Контент

// ENDPOINT

Endpoint reference

Карта ударов живёт отдельным адресом, суммарный xG приходит в статистике матча внутри полного ответа события. Ключ передаётся заголовком, строкой запроса ключи не принимаются.

GET /v1/event/{id}/shotmap

Все удары матча с координатами, плюс сводка totals по сторонам

GET /v1/event/{id}

Полное событие: statistics (в нём xG за матч и по таймам), shotmap, momentum — кривая давления, не xG

Как передаётся ключ

x-api-keyзаголовок запроса, обязательный. Без него ответ 401

Других параметров у этих двух адресов нет: карта ударов отдаётся целиком, обеими сторонами, отсортированная по минуте.

api.sportwire.ru · настоящий ответ, матч 11220580

$ curl -H "x-api-key: …" \
    api.sportwire.ru/v1/event/11220580/shotmap
{
  "event_id": 11220580, "available": true,
  "count": 24,
  "totals": {
    "home": { "shots": 11, "goals": 3, "on_target": 5, "xg": 0 },
    "away": { "shots": 13, "goals": 2, "on_target": 3, "xg": 0 }
  },
  "shots": [
    {
      "is_home": true, "player": "Jubal", "minute": 4,
      "shot_type": "goal", "situation": "set-piece",
      "body_part": "head", "goal_type": "regular",
      "xg": null, "xgot": null,
      "x": 9.9, "y": 54.9,
      "trajectory": { "start": {"x": 54.9, "y": 9.9},
                       "end": {"x": 52.8, "y": 0} },
      "goal_mouth": "high-right",
      "goal_mouth_xy": { "x": 0, "y": 47.2, "z": 24.7 }
    }
    // … ещё 23 удара
  ]
}

Ответ снят с боевого API 05.08.2026. xg и xgot по этому матчу пустые — xG отдельного удара источник не прислал; у матчей, где он есть, в этих полях приходит число, и totals.xg перестаёт быть нулём.

xG и карта ударов через API