比賽詳情

比賽事件、技術統計、上陣名單及對賽往績。

本頁內容

賽事事件

GET/v1/football/matches/{matchId}/events

參數

matchIdinteger (int32)path必填
從即時比分或賽程列表取得的 Tipsme 數字比賽 ID，適用於比賽詳情、賠率及分析；分析需要 Plus 或 Pro。在 API 參考尋找此數值

請求範例

請先填寫必填參數：matchId

回應欄位 · 23

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
matchId	integer	Tipsme 比賽識別碼。
events	MatchEventDto[]	按時間排列的入球、領牌及換人。
└minute	string可能省略	事件發生的比賽分鐘。
└homeType	string可能省略	主隊事件類型，例如入球、黃牌或換人（如適用）。
└homeDetail	string可能省略	主隊事件涉及的球員及詳情。
└awayType	string可能省略	客隊事件類型（如適用）。
└awayDetail	string可能省略	客隊事件涉及的球員及詳情。
corners	TimedTallyDto[]	角球累計數隨時間的變化。
└minute	string可能省略	記錄時的比賽分鐘。
└home	string可能省略	該分鐘的主隊累計值。
└away	string可能省略	該分鐘的客隊累計值。
technicalStats	TimedTallyDto[]	射門、進攻等技術統計隨時間的變化。
└minute	string可能省略	記錄時的比賽分鐘。
└home	string可能省略	該分鐘的主隊累計值。
└away	string可能省略	該分鐘的客隊累計值。
home	MatchLineupDto可能省略	已公佈的主隊陣容。
└formation	string可能省略	陣式文字，例如 4-2-3-1。
└starters	string[]	正選球員姓名。
└bench	string[]	後備球員姓名。
away	MatchLineupDto可能省略	已公佈的客隊陣容。
└formation	string可能省略	陣式文字，例如 4-2-3-1。
└starters	string[]	正選球員姓名。
└bench	string[]	後備球員姓名。

回應狀態 200, 401, 403, 404, 429

前往試用

賽事統計

GET/v1/football/matches/{matchId}/statistics

參數

matchIdinteger (int32)path必填
從即時比分或賽程列表取得的 Tipsme 數字比賽 ID，適用於比賽詳情、賠率及分析；分析需要 Plus 或 Pro。在 API 參考尋找此數值

請求範例

請先填寫必填參數：matchId

回應欄位 · 11

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
matchId	integer	Tipsme 比賽識別碼。
goalDistribution	GoalDistributionDto[]	每 15 分鐘時段的入球／失球數。
└timeframe	string可能省略	比賽時段，例如 0-15 分鐘。
└homeScoredPercent	string可能省略	主隊於此時段射入的球季入球比例。
└homeConcededPercent	string可能省略	主隊於此時段的失球比例。
└awayScoredPercent	string可能省略	客隊於此時段的入球比例。
└awayConcededPercent	string可能省略	客隊於此時段的失球比例。
metrics	TeamMetricDto[]	主隊與客隊的球季平均數據。
└metric	string可能省略	統計項目名稱，例如射正。
└home	string可能省略	主隊球季平均值。
└away	string可能省略	客隊球季平均值。

回應狀態 200, 401, 403, 404, 429

前往試用

陣容、球員事件及缺陣

GET/v1/football/matches/{matchId}/lineups

參數

matchIdinteger (int32)path必填
從即時比分或賽程列表取得的 Tipsme 數字比賽 ID，適用於比賽詳情、賠率及分析；分析需要 Plus 或 Pro。在 API 參考尋找此數值

請求範例

請先填寫必填參數：matchId

回應欄位 · 164

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
matchId	integer	Tipsme 比賽識別碼。
confirmed	boolean	true 表示官方陣容已公佈；false 表示預測陣容。
home	TeamSquadDto	主隊球員名單。
└formation	string可能省略	陣式文字，例如 4-3-3。
└coachId	string可能省略	陣容資料中的教練識別碼，如有提供。
└players	LineupPlayerDto[]	正選及後備名單。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	賽事陣容資料中的球員姓名。
└shirtNumber	integer可能省略	球衣號碼。
└position	string可能省略	位置代碼，例如 GK（門將）、DF（後衛）、MF（中場）、FW（前鋒）。
└isStarter	boolean	true 表示正選球員。
└isCaptain	boolean	true 表示隊長。
└rating	string可能省略	比賽評分，滿分 10 分（如有提供）。
└pitch	PitchPositionDto可能省略	正選球員在球場上的位置；後備球員會省略。
└x	integer	水平位置：0 代表己方底線，最大 100。
└y	integer	垂直位置：0 代表左邊線，最大 100。
└photoUrl	string可能省略	球員照片。
└incidents	LineupIncidentDto[]	已棄用：請改用 events 取得統一格式的事件名稱及分組詳情。保留此欄位以兼容現有用戶端。
└typeCode	integer	來源事件類型代碼，例如入球、烏龍球、黃牌、紅牌及換人。
└minute	integer可能省略	比賽分鐘。
└stoppageTime	integer可能省略	事件發生於補時時的補時分鐘。
└homeScore	integer可能省略	事件後的主隊入球數。
└awayScore	integer可能省略	事件後的客隊入球數。
└player	PlayerRefDto可能省略	涉及的球員。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└assist1	PlayerRefDto可能省略	入球的第一助攻者。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└assist2	PlayerRefDto可能省略	入球的第二助攻者。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└playerIn	PlayerRefDto可能省略	換人時入替的球員。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└playerOut	PlayerRefDto可能省略	換人時離場的球員。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└events	LineupEventDto[]可能省略	涉及此球員的入球、領牌、受傷及換人事件，格式已統一。
└type	enum	事件類型；沒有支援的對應類型時為 unknown。unknown \| goal \| yellowCard \| redCard \| injury \| penalty \| substitution \| secondYellowCard \| missedPenalty
└minute	integer可能省略	比賽分鐘。
└stoppageTime	integer可能省略	補時分鐘數，如有提供。
└score	LineupEventScoreDto可能省略	事件發生後的比數，如有提供。
└home	integer可能省略	事件發生後的主隊入球數，如有提供。
└away	integer可能省略	事件發生後的客隊入球數，如有提供。
└player	PlayerRefDto可能省略	涉及的球員，如有提供。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└assists	PlayerRefDto[]	助攻球員，按資料提供的次序排列；未有提供時為空陣列。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└substitution	LineupSubstitutionDto可能省略	換入及換出的球員，如有提供。
└in	PlayerRefDto可能省略	換人時入替的球員，如有提供。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└out	PlayerRefDto可能省略	換人時離場的球員，如有提供。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└injuries	InjuryDto[]	已棄用：請改用 absences 取得未能上陣的球員資料。保留此欄位以兼容現有用戶端。
└playerId	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└position	string可能省略	位置代碼。
└reason	string可能省略	傷患或停賽說明。
└typeCode	integer可能省略	資料來源的缺陣類型代碼。
└missedMatches	integer可能省略	至今缺陣的比賽場數。
└startUtc	datetime可能省略	開始缺陣的時間。
└endUtc	datetime可能省略	預計復出時間（如已知）。
└photoUrl	string可能省略	球員照片。
└squadRatings	SquadRatingDto[]	每名球員的球季評分。
└shirtNumber	string可能省略	球衣號碼。
└name	string可能省略	球員姓名。
└position	string可能省略	位置代碼。
└seasonRating	string可能省略	球季評分，與單場比賽評分不同。
└recentTeamRatings	number[]	球隊近期賽事評分，最新賽事排在最前。
└absences	LineupAbsenceDto[]可能省略	未能上陣的球員，以及已提供的缺陣原因及日期。
└playerId	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	資料提供的球員姓名。
└position	string可能省略	位置代碼，如有提供。
└reason	string可能省略	已提供的傷患、停賽或其他缺陣原因說明。
└missedMatches	integer可能省略	目前已缺陣的賽事數目，如有提供。
└startUtc	datetime可能省略	開始缺陣的時間。
└endUtc	datetime可能省略	預計復出時間（如已知）。
└photoUrl	string可能省略	球員照片。
away	TeamSquadDto	客隊球員名單。
└formation	string可能省略	陣式文字，例如 4-3-3。
└coachId	string可能省略	陣容資料中的教練識別碼，如有提供。
└players	LineupPlayerDto[]	正選及後備名單。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	賽事陣容資料中的球員姓名。
└shirtNumber	integer可能省略	球衣號碼。
└position	string可能省略	位置代碼，例如 GK（門將）、DF（後衛）、MF（中場）、FW（前鋒）。
└isStarter	boolean	true 表示正選球員。
└isCaptain	boolean	true 表示隊長。
└rating	string可能省略	比賽評分，滿分 10 分（如有提供）。
└pitch	PitchPositionDto可能省略	正選球員在球場上的位置；後備球員會省略。
└x	integer	水平位置：0 代表己方底線，最大 100。
└y	integer	垂直位置：0 代表左邊線，最大 100。
└photoUrl	string可能省略	球員照片。
└incidents	LineupIncidentDto[]	已棄用：請改用 events 取得統一格式的事件名稱及分組詳情。保留此欄位以兼容現有用戶端。
└typeCode	integer	來源事件類型代碼，例如入球、烏龍球、黃牌、紅牌及換人。
└minute	integer可能省略	比賽分鐘。
└stoppageTime	integer可能省略	事件發生於補時時的補時分鐘。
└homeScore	integer可能省略	事件後的主隊入球數。
└awayScore	integer可能省略	事件後的客隊入球數。
└player	PlayerRefDto可能省略	涉及的球員。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└assist1	PlayerRefDto可能省略	入球的第一助攻者。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└assist2	PlayerRefDto可能省略	入球的第二助攻者。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└playerIn	PlayerRefDto可能省略	換人時入替的球員。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└playerOut	PlayerRefDto可能省略	換人時離場的球員。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└events	LineupEventDto[]可能省略	涉及此球員的入球、領牌、受傷及換人事件，格式已統一。
└type	enum	事件類型；沒有支援的對應類型時為 unknown。unknown \| goal \| yellowCard \| redCard \| injury \| penalty \| substitution \| secondYellowCard \| missedPenalty
└minute	integer可能省略	比賽分鐘。
└stoppageTime	integer可能省略	補時分鐘數，如有提供。
└score	LineupEventScoreDto可能省略	事件發生後的比數，如有提供。
└home	integer可能省略	事件發生後的主隊入球數，如有提供。
└away	integer可能省略	事件發生後的客隊入球數，如有提供。
└player	PlayerRefDto可能省略	涉及的球員，如有提供。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└assists	PlayerRefDto[]	助攻球員，按資料提供的次序排列；未有提供時為空陣列。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└substitution	LineupSubstitutionDto可能省略	換入及換出的球員，如有提供。
└in	PlayerRefDto可能省略	換人時入替的球員，如有提供。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└out	PlayerRefDto可能省略	換人時離場的球員，如有提供。
└id	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└injuries	InjuryDto[]	已棄用：請改用 absences 取得未能上陣的球員資料。保留此欄位以兼容現有用戶端。
└playerId	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	球員姓名。
└position	string可能省略	位置代碼。
└reason	string可能省略	傷患或停賽說明。
└typeCode	integer可能省略	資料來源的缺陣類型代碼。
└missedMatches	integer可能省略	至今缺陣的比賽場數。
└startUtc	datetime可能省略	開始缺陣的時間。
└endUtc	datetime可能省略	預計復出時間（如已知）。
└photoUrl	string可能省略	球員照片。
└squadRatings	SquadRatingDto[]	每名球員的球季評分。
└shirtNumber	string可能省略	球衣號碼。
└name	string可能省略	球員姓名。
└position	string可能省略	位置代碼。
└seasonRating	string可能省略	球季評分，與單場比賽評分不同。
└recentTeamRatings	number[]	球隊近期賽事評分，最新賽事排在最前。
└absences	LineupAbsenceDto[]可能省略	未能上陣的球員，以及已提供的缺陣原因及日期。
└playerId	string可能省略	陣容資料中的球員識別碼，如有提供。
└name	string可能省略	資料提供的球員姓名。
└position	string可能省略	位置代碼，如有提供。
└reason	string可能省略	已提供的傷患、停賽或其他缺陣原因說明。
└missedMatches	integer可能省略	目前已缺陣的賽事數目，如有提供。
└startUtc	datetime可能省略	開始缺陣的時間。
└endUtc	datetime可能省略	預計復出時間（如已知）。
└photoUrl	string可能省略	球員照片。

回應狀態 200, 401, 403, 404, 429

前往試用

對賽紀錄及近況

GET/v1/football/matches/{matchId}/h2h

參數

matchIdinteger (int32)path必填
從即時比分或賽程列表取得的 Tipsme 數字比賽 ID，適用於比賽詳情、賠率及分析；分析需要 Plus 或 Pro。在 API 參考尋找此數值

請求範例

請先填寫必填參數：matchId

回應欄位 · 89

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
matchId	integer	Tipsme 比賽識別碼。
meetings	H2hMeetingDto[]	雙方過往交鋒，最近的在前。
└matchId	integer	該次交鋒的 Tipsme 比賽識別碼。
└date	string可能省略	比賽日期。
└competition	string可能省略	賽事名稱。
└homeTeam	string可能省略	該次交鋒的主隊。
└awayTeam	string可能省略	該次交鋒的客隊。
└score	string可能省略	完場比分，格式為「主隊-客隊」。
└corners	string可能省略	角球數，格式為「主隊-客隊」。
└isNeutralVenue	boolean	true 表示在中立場地作賽。
└outcome	MatchOutcomeDto	該次交鋒於常見盤口的結果。
└result	string可能省略	以主隊角度表示的勝／和／負。
└handicap	string可能省略	主隊於亞洲讓球盤口的結果。
└overUnder	string可能省略	比賽總入球是否高於或低於盤口。
└halfTimeFullTime	string可能省略	半場／全場結果組合。
home	TeamContextDto	主隊相關資料。
└recentMatches	TeamFormMatchDto[]	近期賽果，最近的在前。
└matchId	integer	Tipsme 比賽識別碼。
└date	string可能省略	比賽日期。
└competition	string可能省略	賽事名稱。
└homeTeam	string可能省略	主隊。
└awayTeam	string可能省略	客隊。
└score	string可能省略	完場比分。
└halfTimeScore	string可能省略	半場比分。
└homeCorners	string可能省略	主隊角球數。
└awayCorners	string可能省略	客隊角球數。
└homeRedCards	string可能省略	主隊紅牌數。
└awayRedCards	string可能省略	客隊紅牌數。
└isNeutralVenue	boolean	true 表示在中立場地作賽。
└outcome	MatchOutcomeDto	常見盤口的結果。
└result	string可能省略	以主隊角度表示的勝／和／負。
└handicap	string可能省略	主隊於亞洲讓球盤口的結果。
└overUnder	string可能省略	比賽總入球是否高於或低於盤口。
└halfTimeFullTime	string可能省略	半場／全場結果組合。
└leagueRecords	LeagueRecordDto[]	按全部／主場／客場劃分的積分榜。
└split	string可能省略	overall（全部）、home（主場）或 away（客場）。
└rank	string可能省略	聯賽排名。
└played	string可能省略	已比賽場數。
└won	string可能省略	勝出場數。
└drawn	string可能省略	和局場數。
└lost	string可能省略	落敗場數。
└goalsFor	string可能省略	入球數。
└goalsAgainst	string可能省略	失球數。
└goalDifference	string可能省略	得失球差。
└points	string可能省略	積分。
└winRate	string可能省略	勝率百分比。
└upcoming	UpcomingFixtureDto[]	未來賽程。
└date	string可能省略	賽程日期。
└daysAway	string可能省略	距離比賽的日數。
└competition	string可能省略	賽事名稱。
└homeTeam	string可能省略	主隊。
└awayTeam	string可能省略	客隊。
away	TeamContextDto	客隊相關資料。
└recentMatches	TeamFormMatchDto[]	近期賽果，最近的在前。
└matchId	integer	Tipsme 比賽識別碼。
└date	string可能省略	比賽日期。
└competition	string可能省略	賽事名稱。
└homeTeam	string可能省略	主隊。
└awayTeam	string可能省略	客隊。
└score	string可能省略	完場比分。
└halfTimeScore	string可能省略	半場比分。
└homeCorners	string可能省略	主隊角球數。
└awayCorners	string可能省略	客隊角球數。
└homeRedCards	string可能省略	主隊紅牌數。
└awayRedCards	string可能省略	客隊紅牌數。
└isNeutralVenue	boolean	true 表示在中立場地作賽。
└outcome	MatchOutcomeDto	常見盤口的結果。
└result	string可能省略	以主隊角度表示的勝／和／負。
└handicap	string可能省略	主隊於亞洲讓球盤口的結果。
└overUnder	string可能省略	比賽總入球是否高於或低於盤口。
└halfTimeFullTime	string可能省略	半場／全場結果組合。
└leagueRecords	LeagueRecordDto[]	按全部／主場／客場劃分的積分榜。
└split	string可能省略	overall（全部）、home（主場）或 away（客場）。
└rank	string可能省略	聯賽排名。
└played	string可能省略	已比賽場數。
└won	string可能省略	勝出場數。
└drawn	string可能省略	和局場數。
└lost	string可能省略	落敗場數。
└goalsFor	string可能省略	入球數。
└goalsAgainst	string可能省略	失球數。
└goalDifference	string可能省略	得失球差。
└points	string可能省略	積分。
└winRate	string可能省略	勝率百分比。
└upcoming	UpcomingFixtureDto[]	未來賽程。
└date	string可能省略	賽程日期。
└daysAway	string可能省略	距離比賽的日數。
└competition	string可能省略	賽事名稱。
└homeTeam	string可能省略	主隊。
└awayTeam	string可能省略	客隊。

回應狀態 200, 401, 403, 404, 429

前往試用

由免費方案開始

一條 API 金鑰，每個帳戶每日 30 次請求，另加每日 50 次免費賽程列表請求。真實數據，毋須信用卡。

取得免費 API 金鑰收費

這頁有幫助嗎？

不太有

聯絡支援 →