TheStatsAPI

TheStatsAPI란 무엇인가요?

TheStatsAPI는 개발자를 위한 축구 통계 API로, 경기 데이터, 선수 및 팀 통계, 일정/결과, 배팅 오즈에 대한 프로그램적 접근을 제공합니다. 문서화된 엔드포인트에서 깨끗하고 페이지네이션된 JSON 형식으로 구조화된 축구 데이터를 제공하여 이를 필요로 하는 애플리케이션을 구동하도록 설계되었습니다.

API는 기본적으로 80개 대회 통계를 다루며(요청 시 최대 1,196개 대회 가능), 10년 치 역사 데이터(10년 커버리지로 표시)와 가능한 경우 라이브 데이터(예: 인플레이 경기 오즈 및 경기 통계)를 포함합니다.

주요 기능

경기 일정 및 결과: 다루는 대회의 일정 목록과 과거 결과를 가져옵니다.
선수 및 팀 통계: 시즌 및 커리어 선수 통계(예: 득점, 어시스트, 출전, 분, 카드, 슛)와 팀 관련 통계를 확인합니다.
라이브 및 확정 경기 통계: 슛, 기대 득점(xG), 점유율, 패스, 분 단위 이벤트 등을 포함한 경기 통계 엔드포인트를 사용합니다.
오즈(사전 및 라이브): 사전 오즈를 가져오며, 지원되는 경기에서 live_odds_available이 true인 라이브 엔드포인트를 통해 인플레이 오즈를 확인합니다.
고급 분석: 기대 득점 지표(xG, 비페널티 xG(npxG), xA) 및 관련 세부 측정치, 더 깊은 경기 분석을 가져옵니다.
대회 범위 및 구조화된 데이터: 대회와 시즌(대회 상세의 current_season_id와 일치하는 현재 시즌 선택)을 쿼리하며, 5개 카테고리(Competitions, Teams, Matches, Players, Odds)에서 19개 엔드포인트의 JSON 응답을 받습니다.

TheStatsAPI 사용 방법

무료 평가판 시작하고 인터랙티브 데모로 엔드포인트를 테스트합니다(문서에 예제 요청과 “Run API Call” 워크플로우 표시).
API 키 발급받고 Authorization: Bearer YOUR_API_KEY 헤더로 요청을 인증합니다.
문서화된 기본 경로 /api/football/*를 사용합니다(예: 대회 목록 또는 경기 통계).
필요한 특정 리소스를 요청(대회, 시즌, 경기, 선수, 오즈)하고 엔드포인트에서 반환된 페이지네이션 매개변수를 따릅니다.

사이트에 표시된 예제 호출:

GET /api/football/matches/mt_010249745/stats (Bearer 토큰 포함).

사용 사례

판타지 풋볼 앱: 선수 시즌/커리어 통계와 경기별 득점 입력을 사용해 스코어링 및 선수 선택 기능을 구축합니다.
경기 당일 스코어보드: 라이브 데이터 지원 경기에서 실시간 오즈와 라이브 경기 통계(상태 및 이벤트 기반 업데이트 포함)를 표시합니다.
배팅 분석 및 백테스팅: 과거 사전 오즈 데이터와 역사 경기 결과, xG 지표를 활용해 모델링 및 분석을 지원합니다.
팀 및 선수 성과 보고서: 시즌 및 커리어 집계(득점, 어시스트, 분, 카드, 슛)와 경기 및 이벤트 맥락으로 대시보드를 생성합니다.
편집 또는 스포츠 데이터 제품: 구조화된 일정/결과와 xG, npxG 등의 분석 필드로 기사나 피드를 풍부하게 합니다.

자주 묻는 질문

TheStatsAPI가 라이브 데이터와 확정 데이터를 반환하나요?

API는 라이브 및 확정 경기 통계(슛, xG, 점유율, 패스, 카드, 득점, 분 단위 이벤트)를 제공하며, live_odds_available이 true인 경기에 대한 라이브 경기 오즈 엔드포인트도 포함합니다.

이용 가능한 대회는 몇 개인가요?

사이트에 따르면 기본 80개 대회, 요청 시 최대 1,196개입니다.

엔드포인트 반환 형식은 무엇인가요?

문서에 따르면 엔드포인트는 깨끗하고 페이지네이션된 JSON을 반환합니다.

어떤 종류의 데이터를 쿼리할 수 있나요?

사이트에 대회, 팀, 경기, 선수, 오즈에 대한 엔드포인트와 카테고리가 나열되어 있으며, 일정/결과, 선수 시즌 통계, 사전/라이브 오즈를 포함합니다.

요청 인증 방법은?

데모에 표시된 요청은 Authorization Bearer 토큰 헤더를 사용합니다: Authorization: Bearer YOUR_API_KEY.

대안

축구 API를 제공하는 스포츠 데이터 집계기: 동일 카테고리 대안은 일반적으로 경기 통계와 선수/일정 데이터를 JSON으로 제공하지만, 커버리지 범위와 라이브 오즈/인플레이 피드 가용성에서 차이가 날 수 있습니다.
스포츠 커넥터를 가진 일반 분석/데이터 플랫폼: 시각화나 파이프라인이 더 쉬울 수 있지만, 동일한 경기 수준 이벤트 및 xG 필드를 추출하려면 추가 단계가 필요할 수 있습니다.
배팅 중심 오즈 API: 주요 필요가 오즈(사전 및/또는 인플레이)라면 배팅 오즈 우선 API가 오즈 접근을 단순화할 수 있지만, 경기/이벤트 및 xG 분석 범위가 좁을 수 있습니다.
오즈 없는 오픈 축구 데이터 소스: 북메이커 오즈 없는 팀/선수/경기라면 오픈 데이터 소스가 적합하지만, xG와 배팅 오즈는 별도 소스가 필요할 가능성이 큽니다.