Tennis

Ranking Movers Between Published Lists

Climbers, fallers, new entries and drop-outs between a published list and the one before it. The two lists can be weeks apart when the archive has gaps, which is why both dates are in the response. movement = previous_rank - rank; both dates are named so the number can be checked.

get/tennis/rankings/movers

Request

  • Base URL: https://api.citoapi.com/api/v1
  • URL: https://api.citoapi.com/api/v1/tennis/rankings/movers
  • Auth: API key in header x-api-key

Query parameters

tourstring

ATP or WTA

circuitstring

Synonym for tour, matching the /rankings/{circuit} path form: ATP or WTA

datestring date

Ranking date to compare against its predecessor (default: latest)

limitinteger

Rows per list

page_sizeinteger

Alias for limit, matching the paginated routes

withininteger

Only players inside the top N on either list

directionstring

up (climbers), down (fallers), or both (largest absolute change)

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.