pickleball live API

An enterprise-grade REST API delivering unified, real-time pickleball data — players, rankings, results, tournaments, leagues, and clubs — across the entire professional and recreational pickleball ecosystem.

原始信息汇总

数据集概述：Pickleball Live API

这是一个面向企业的、生产就绪的 REST API，用于聚合和提供来自多个官方数据源的匹克球数据，包括 PPA 巡回赛排名、DUPR 技能评分、实时比赛比分、锦标赛赛程、联赛日程和俱乐部信息。

• 基础路径: /api/v1/pickleball
• 数据源: 聚合自 pickleball.com, pickleballtournaments.com, pickleballleagues.com 和 pickleballclubs.com。
• 当前版本: 1.0.0

核心端点与功能

API 提供以下主要数据类别，每个类别包含多个 RESTful 端点：

1. Rankings (排名)

   • 端点: GET /rankings
   • 描述: 获取实时的 PPA 巡回赛球员排名，可按六个竞技项目（如男子单打、女子双打）过滤，并支持返回前十名或完整的约百人排行榜。

2. Players (球员)

   • 端点: GET /players, GET /players/filters, GET /players/{slug}
   • 描述: 搜索、过滤和检索超过 79.4 万名注册球员的完整档案。支持按姓名、性别、年龄、DUPR 技能评分范围、WPR 徽章等级、地理位置等进行过滤。球员档案包含个人信息、所有评分系统、PPA 积分与排名、赞助商、社交媒体链接、简介以及按时间排序的赛事比赛历史。

3. Results (结果)

   • 端点: GET /results, GET /results/matchup/{matchup_id}, GET /results/h2h, GET /results/tiebreaker, GET /results/division-matchups, GET /results/match-infos
   • 描述: 查询指定日期的赛事和团体联赛结果。提供详细的对抗赛报告（包括球队、每局比分、球员名单）、两支球队之间的历史交锋数据、抢七局的逐分序列以及分区对抗赛信息。

4. News (新闻)

   • 端点: GET /news
   • 描述: 获取来自 pickleball.com 官方新闻源的最新匹克球文章，内容分页，每条包含标题、日期、摘要、作者和图片。

5. Ticker (实时比分)

   • 端点: GET /ticker, GET /tl-ticker
   • 描述: 获取正在进行的 PPA 巡回赛或 MLP（大联盟匹克球）比赛的实时比分数据，适用于构建实时计分板。

6. Tournaments (赛事)

   • 端点: GET /tournaments, GET /tournaments/{slug}
   • 描述: 搜索和检索来自 pickleballtournaments.com 的赛事详情（该平台托管超过 21,500 个赛事）。支持按关键词、类别（如特色、本地、国家级巡回赛）和地理区域进行搜索。

7. Leagues (联赛)

   • 端点: GET /leagues/search, GET /leagues/filters, GET /leagues/score-formats, GET /leagues/{slug}/session/{session_id}/header, GET /leagues/matches, GET /leagues/completed-matches, GET /leagues/groups
   • 描述: 探索来自 pickleballleagues.com 的休闲与竞技匹克球联赛。支持按状态、关键词、格式、球员分组等搜索。提供比赛日详细信息，包括场地分配、球员名单、比赛得分和分组结构。

8. Clubs (俱乐部)

   • 端点: GET /clubs, GET /clubs/{slug}, GET /clubs/{slug}/info, GET /clubs/{slug}/members
   • 描述: 检索来自 pickleballclubs.com 的俱乐部档案（全球约 6,000 个）。提供俱乐部简介、成员名册（成员名册包含每位成员的 DUPR 评分、PPA 排名等评级信息）以及附属的赛事和联赛信息。