Skip to content
Get a key
API reference / Tennis
GET/tennis/rankings

Tennis singles ranking

The ATP or WTA singles ranking, read daily, by rank; optionally the players of one country (nationality as in the ranking, "Italy").

In the plans that cover this sportPay per call without a key: $0.002 in USDC

Parameters

  • tourstring · queryrequired

    atp or wta

  • limitinteger · query

    Maximum results (1-500)

    Default: 100
  • offsetinteger · query

    Results to skip

    Default: 0
  • countrystring · query

    Only players of this country

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataarray of object
  • movementstring

    up, down or same since the last list

  • namestring
  • nationalitystring
  • photo_urlstring
  • player_idinteger
  • pointsinteger
  • rankinteger
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
400INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
403FORBIDDENThe sport or feature is not in your plan (FEATURE_NOT_IN_PLAN for Insights and other plan features).

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?