Charting: player career profile
get_charting_playerRead-onlyIdempotent
Fetch a player's career shot-level profile: serve placement, return depth, net play, clutch-point serving, winners/errors, rally length. Ambiguous names return candidates.
Instructions
Career shot-level profile from the Match Charting Project: serve placement (deuce/ad × wide/body/T), return depth and outcomes, net play, clutch break/game/set-point serving, winners and errors by wing, rally-length tendencies — summed over the player's charted matches. COVERAGE IS CURATED (11,646 charted matches back to the 1960s, concentrated on the majors), not full-slate. An ambiguous name returns the candidates to choose from. Requires the ULTRA plan.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Player name fragment, min 3 chars — must resolve to one charted person. | |
| gender | No | Disambiguates a name charted on both tours. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the call returned data. False for a tier wall, a missing or rejected key, or an empty result — all of which are normal states with a clear remedy, not failures. | |
| player | No | The resolved charted player. | |
| message | Yes | Human-readable summary. Identical to the text content, so either half can be used alone. | |
| coverage | No | A reminder that charting coverage is curated, not full-slate. | |
| families | No | Per-family summed numeric columns — raw sums over the player's charted Total rows. | |
| matches_charted | No | The sample every summed field covers. |