US Open Tennis Draws & Scores Scraper
SPORTS
US Open Tennis Draws & Scores Scraper
Scrapes US Open Tennis draw data and match results directly from the official usopen.org JSON feeds — the same endpoints the US Open website uses to render its draws pages.
Returns structured match records for all five draw types: Men's Singles (MS), Ladies' Singles (LS), Men's Doubles (MD), Ladies' Doubles (LD), and Mixed Doubles (XD).
What you get
Each record contains:
| Field | Description |
|---|---|
tournament_year |
Tournament year (e.g. 2024) |
draw_code |
Draw code: MS, LS, MD, LD, or XD |
draw_name |
Full draw name (e.g. "Men's Singles") |
round |
Round name (e.g. "Round 1", "Semi-Finals", "Final") |
match_id |
Match identifier from the feed |
court_name |
Court name (e.g. "Arthur Ashe Stadium") |
scheduled_start |
Scheduled start time (ISO 8601) |
status |
Match status: Pre, Live, or Completed |
player_1_name |
Player/team 1 name |
player_1_seed |
Player 1 seed (null if unseeded) |
player_1_country |
Player 1 nation code (e.g. USA, ITA) |
player_1_atp_id |
Player 1 ATP/WTA ID |
player_2_name |
Player/team 2 name |
player_2_seed |
Player 2 seed |
player_2_country |
Player 2 nation code |
player_2_atp_id |
Player 2 ATP/WTA ID |
sets |
Set scores as JSON string, e.g. [[6,4],[6,3],[6,2]] |
winner |
Winner indicator: "1" (player 1) or "2" (player 2) |
duration_minutes |
Match duration in minutes |
aces_p1 |
Aces by player 1 (null — not available in draws feed) |
aces_p2 |
Aces by player 2 (null — not available in draws feed) |
source |
Source URL for this record |
Input
| Parameter | Type | Default | Description |
|---|---|---|---|
year |
integer | current year | Tournament year to fetch. Historical data (2019+) is available year-round. |
drawCodes |
array | all five | Which draws to fetch. Any subset of: MS, LS, MD, LD, XD. |
maxItems |
integer | required | Maximum match records to return across all draws. |
Use cases
- Sports analytics & DFS — seed draw data into bracket prediction or fantasy scoring models.
- AI sports content — generate pre-match previews, draw brackets, and match result summaries.
- Historical research — retrieve full draw trees for any US Open going back to 2019.
- Live scoring — poll during the US Open fortnight (Aug 25 – Sep 7) for live match updates.
Architecture notes
Fetches from https://www.usopen.org/en_US/scores/feeds/{year}/draws/{DRAW_CODE}.json directly — no browser rendering, no proxy. One request per draw code (5 total). Runs in under 60 seconds.
Sibling of wimbledon-feeds-draws-scores-scraper — same architecture, same field names.
Notes
- Draws publish only during the tournament window. Requesting year 2026 before late August 2026 returns no matches.
aces_p1/aces_p2are always null — aces appear only in the per-match scoring endpoint (reserved for future enhancement).