Tidy Access to Women's Tennis Association (WTA) Data
Overview
Scrapes and tidies publicly available data from the Women's Tennis Association website (https://www.wtatennis.com). Provides helpers to retrieve player biographies, singles and doubles career overviews, match histories, live rankings and aggregate statistics. Dynamic pages are rendered through a headless 'Chrome' session so 'JavaScript'-generated content is fully captured, and all outputs are returned as tidy data frames suitable for downstream analysis or visualisation.
First public release.
Features
wta_player_url()builds canonical player URLs from a WTA numeric id, an optional slug and a section ("overview"or"matches").wta_get_player_basics()returns a one-row tibble with the player's name, nationality, birth date and place, height, handedness, headshot and nationality flag. Biographical data is read from the page's schema.org JSON-LD block (with a CSS-selector fallback) for resilience against site redesigns.wta_get_player_overview()returns a long tibble of career highlights (singles/doubles rank, career titles, career prize money, career-high singles rank).
Show all changes in 0.1.0Hide the rest of the changes in 0.1.0
wta_get_player_matches()walks the "Matches" page, clicking *Show more* until the full history is loaded, and returns one row per match with tournament, tournament date, round, opponent, opponent seed and country code, opponent rank, score and win/loss result.wta_get_rankings()scrapes the current singles or doubles ranking table and returns a tidy tibble (rank, player id, player, country, age, tournaments played, points).
Infrastructure
- Tests (
testthat3rd edition) run entirely against local HTML fixtures — no network, no headless browser required for CI. - GitHub Actions workflows for
R CMD check(Ubuntu / Windows / macOS × devel / release / oldrel-1) and pkgdown deployment. - Vignette "Getting started with matchpointR".
Not yet covered
- Tour-wide statistics leaderboards (aces, winners, break-points converted, …) are tracked in issue #1 for a future release.
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK5 OK2026-04-29
Documentation
- Help pages
- 8 (3 internal)includes a package overview page
- Examples that run
- 100%5 run in a plain check (4 of them under a condition)
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Repository
7 development-tooling and community-health practices detected across 4 families in the upstream repository
Checks run against github.com/angnar-97/matchpointr on 2026-10-11.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2026-04-22Commits: at least 5 crediting it in the message
- Claude Opus 4.75 commits · Apr 2026
Dependencies
Code & Tests
People & History
- 0.1.0Latest2026-04-28 · current release
- RR 4.6.0 released · 2026-04-24
Package metadata
- First published
- 2026-04-28
- Total releases
- 1 / 1 yrs
- License
- Apache License (>= 2)
- Minimum R
- ≥ 4.1.0
- Download size
- 173 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("matchpointR")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-19, which the citation names so these numbers can be found later. More on citing and the projects behind them.