Package 'matchpointR'

Get basic bio for a WTA player

Description

Parses the profile header of a WTA player page and returns a one-row tibble with name, nationality, birth date, birth place, height and handedness. The bulk of the data is read from the page's JSON-LD (schema.org Person) block, which is more stable than the visual markup; height is read from the profile bio block as a fallback.

Usage

wta_get_player_basics(player_url, download_images = TRUE)

Arguments

player_url	Character. Full URL to a player page. Build it with wta_player_url() if you only have the numeric id.
download_images	Logical. When TRUE (default) the headshot is downloaded into a magick-image object. Set to FALSE to skip the network round-trip and return only the image URL.

Value

A one-row tibble::tibble() with columns:

player_id

Numeric WTA id parsed from ⁠@id⁠.

name, given_name, family_name

Name fields.

birth_date

Date of birth (ISO 8601 character).

nationality, birth_place, birth_country

Geography fields.

height

Height string as shown on the bio (e.g. ⁠5' 9" (1.74m)⁠).

handedness

Dominant hand ("Right-Handed" / "Left-Handed").

nationality_code

3-letter IOC/ISO code extracted from the flag image (e.g. "CZE", "USA").

player_image_url, nationality_flag_url

Headshot and flag URLs.

player_image

magick-image of the headshot, when download_images = TRUE.

nationality_flag

magick-image of the flag SVG, when download_images = TRUE and the suggested package rsvg is installed (otherwise NA).

Examples

wta_get_player_basics(wta_player_url(320301, "katerina-siniakova"))

---

Get the match history for a WTA player

Description

Walks the dynamic "Matches" page of a player profile, clicking the "Show more" button until the full history is loaded, and returns one row per match with tournament, round, opponent, score and result.

Usage

wta_get_player_matches(player_url, max_clicks = 50L)

Arguments

player_url	Character. URL to the player page; the function normalises to the ⁠/matches⁠ path automatically.
max_clicks	Integer. Safety cap for the "Show more" click loop. Defaults to 50.

Value

A tibble::tibble() with one row per match and columns: tournament, tournament_date, round, opponent, opponent_seed, opponent_country, opponent_rank, score, result.

Examples

url <- wta_player_url(320301, "katerina-siniakova", "matches")
wta_get_player_matches(url)

---

Get a WTA player's career highlights

Description

Returns the structured "additional properties" block from the page's JSON-LD: current singles and doubles rank, career titles, career prize money. Supplements with the career-high singles rank read from the bio side panel.

Usage

wta_get_player_overview(player_url)

Arguments

player_url

Character. URL to the player overview page.

Value

A long-format tibble::tibble() with columns metric and value. Rows include singles_rank, doubles_rank, singles_career_titles, doubles_career_titles, career_prize_money, career_high.

Examples

wta_get_player_overview(wta_player_url(320301, "katerina-siniakova"))

---

Get the current WTA rankings

Description

Scrapes the rankings table at https://www.wtatennis.com/rankings/singles (or ⁠/doubles⁠) and returns a tidy tibble. The initial page renders the first 50 rows; increase the browser dwell time with wait if the widget hasn't hydrated yet.

Usage

wta_get_rankings(type = c("singles", "doubles"), top = NULL, wait = 12)

Arguments

type	Character. One of "singles", "doubles". Defaults to "singles".
top	Integer. Limit the output to the top N ranked players. NULL (default) keeps every row rendered by the page.
wait	Numeric. Seconds to wait for the rankings widget to hydrate after navigation. Defaults to 12.

Value

A tibble::tibble() with one row per player and columns: rank, player_id, player, country, age, tournaments_played, points.

Examples

wta_get_rankings("singles", top = 50)

---

Build a WTA player URL

Description

Convenience wrapper to assemble a canonical player URL from a numeric id and an optional slug.

Usage

wta_player_url(id, slug = NULL, section = c("overview", "matches"))

Arguments

id	Character or integer. The WTA numeric player id (e.g. 320301).
slug	Optional character. Player slug (e.g. "katerina-siniakova"). When omitted the URL still resolves — WTA redirects to the canonical one.
section	Optional character. Page section to append as a path segment, one of "overview", "matches". Defaults to "overview", which maps to the bare player URL.

Value

A single character string with the full URL.

Examples

wta_player_url(320301, "katerina-siniakova")
wta_player_url(320301, "katerina-siniakova", "matches")

---