MLB Intelligence API

Today's games scored for HR potential. Every umpire graded. Statcast leaderboards. One API. Three MLB analytics APIs in one — Park Factor Intelligence, Umpire Intelligence, and Statcast Leaderboard. Park factor + wind + temperature combined into a 0-100 HR score for every game. Umpire grades A-F with K-rate and over/under tendencies. Barrel %, exit velocity, xwOBA from Baseball Savant. Clean JSON. Live data.

原始信息汇总

数据集名称

MLB Intelligence API

提供方

PropTechUSA.ai (Saint Paul, MN)

描述

该API整合了三个MLB数据分析功能：公园因素情报、裁判员情报和Statcast排行榜。它提供实时数据，以清洁的JSON格式输出。

核心功能

• 今日赛程HR评分：结合公园因素、实时风速和温度，为每场MLB比赛生成0-100分的HR潜力评分，并分为BOMB（70+）、WARM（55-69）、NEUTRAL（40-54）、COLD（<40）四个等级。
• 裁判员评分：对20名主裁判进行A-F等级评分，提供K率（三振率）提升/降低、保送率、HR影响、大小分倾向及即时投注信号。
• Statcast排行榜：提供桶装率、出口速度、强击率、xwOBA、冲刺速度、K%、BB%、xBA、xSLG等指标的排行榜。
• 球员HR分布图：展示球员所有本垒打的出口速度、发射角、距离、投手等信息。
• 近失球分析：统计未过墙但距离≥285英尺、出口速度≥95mph、发射角18-52°的飞球和林立球。

主要端点 (共10个)

• 公园因素：
  • GET /v1/mlb/park?venue=Coors+Field — 单个球场档案
  • GET /v1/mlb/park/list — 30个球场排名
  • GET /v1/mlb/park/slate — 今日赛程HR评分（含场地、投手、天气）
  • GET /v1/mlb/park/factors?handedness=R&rolling=3 — Baseball Savant的HR/wOBA指数（支持左右手拆分和滚动平均）
• 裁判员情报：
  • GET /v1/mlb/umpire?name=Angel+Hernandez — 单一裁判档案
  • GET /v1/mlb/umpire/list — 20名追踪裁判排名
  • GET /v1/mlb/umpire/today — 今日主裁判分配及信号
• Statcast：
  • GET /v1/mlb/statcast/leaders?metric=barrel_pct — 排行榜
  • GET /v1/mlb/statcast/player?id=592450 — 球员HR分布图 [BASIC及以上]
  • GET /v1/mlb/statcast/near-misses?id=592450 — 近失球 [PRO及以上]

基准URL

https://propdata-mlb-api.sales-fd3.workers.dev

认证方式

所有端点需在请求头中包含API密钥：

• X-RapidAPI-Key: YOUR_KEY 或
• x-api-key: YOUR_PROPDATA_KEY

定价方案

方案	价格	每月请求数	包含功能
STARTER	$4.99/月	500	公园因素 + 裁判查询
BASIC	$14.99/月	2,000	+ Statcast排行榜 + 球员HR图
PRO	$24.99/月	10,000	+ 近失球 + 批量查询
ULTRA	$49.99/月	无限制	所有功能

错误码

• 200: 成功
• 400: 缺少必要参数
• 401: API密钥无效或缺失
• 403: 需要更高等级计划
• 404: 球场或裁判未找到
• 429: 超出速率限制或月度配额
• 502: 上游API（MLB/Savant）暂时不可用