比赛详情

比赛事件、技术统计、阵容及历史交锋。

本页内容

赛事事件

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 密钥价格

这页有帮助吗？

不太有

联系支持 →