1. 기본 정보

항목 내용
Base URL https://www.thesportsdb.com/api/v1/json
무료 API Key 123 (고정값, URL에 직접 삽입)
인증 방식 URL 경로에 키 포함 /api/v1/json/123/endpoint.php
응답 포맷 JSON

2. V1 Free API | 엔드포인트 전체 요약

Search (검색)

⚠️ 무료 Search는 거의 막혀 있음. searchteams는 Arsenal 고정, 나머지도 1건 제한. 실용적이지 않으므로 ID 기반 Lookup을 주력으로 사용해야 함.

엔드포인트 용도 무료 제한
searchteams.php?t=Arsenal 팀 이름 검색 Arsenal만 가능
searchevents.php?e=Arsenal_vs_Chelsea 경기 검색 1건
searchplayers.php?p=Danny_Welbeck 선수 검색 1건
searchvenues.php?v=Wembley 경기장 검색 1건

Lookup (ID 기반 조회)

엔드포인트 용도 무료 제한
lookupleague.php?id=4328 리그 상세 1건
lookuptable.php?l=4328 리그 순위표 5건
lookupteam.php?id=133604 팀 상세 1건
lookupplayer.php?id=34145937 선수 상세 1건
lookupevent.php?id=441613 경기 상세 1건
lookupequipment.php?id=133597 팀 장비(유니폼) 2건
lookuphonours.php?id=34147178 선수 수상 이력 5건
lookupformerteams.php?id=34147178 선수 전 소속팀 5건
lookupmilestones.php?id=34161397 선수 마일스톤 5건
lookupcontracts.php?id=34147178 선수 계약 정보 1건
playerresults.php?id=34160573 선수 경기 결과 5건
lookupplayerstats.php?id=34146304 선수 통계 10건
eventresults.php?id=652890 경기 결과 5건
lookuplineup.php?id=1032723 경기 라인업 5건
lookuptimeline.php?id=1032718 경기 타임라인 5건
lookupeventstats.php?id=1032723 경기 통계 5건
lookuptv.php?id=584911 경기 TV 방송 2건
lookupvenue.php?id=16163 경기장 상세 1건

List (목록 조회)

엔드포인트 용도 무료 제한
all_sports.php 전체 스포츠 종목 2건
all_countries.php 전체 국가 50건
all_leagues.php 전체 리그 10건
search_all_leagues.php?c=England&s=Soccer 국가+종목별 리그 10건
search_all_seasons.php?id=4328 리그별 시즌 목록 5건
search_all_teams.php?l=English_Premier_League 리그별 팀 목록 10건
lookup_all_players.php?id=133604 팀별 선수 목록 10건

Schedule (일정)

엔드포인트 용도 무료 제한
eventsnext.php?id=133602 팀 다음 경기 1건 (홈만)
eventslast.php?id=133602 팀 이전 경기 1건 (홈만)
eventsnextleague.php?id=4328 리그 다음 경기 1건
eventspastleague.php?id=4328 리그 이전 경기 1건
eventsday.php?d=2014-10-10 날짜별 경기 3건
eventsday.php?d=2014-10-10&s=Baseball 날짜+종목 필터 3건
eventsday.php?d=2014-10-10&l=4424 날짜+리그 필터 3건
eventsseason.php?id=4328&s=2014-2015 시즌 전체 경기 15건
eventstv.php?d=2024-07-07 TV 방송 일정 1건

Video

엔드포인트 용도 무료 제한
eventshighlights.php?d=2024-07-07 날짜별 YouTube 하이라이트 2건