Skip to main content

Rankings​

This endpoint allows you to retrieve the rankings for ATP and WTA.

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated every 30 minutes.
Recommended Calls: Limit calls to 1 per hour.

Use Cases​

Get official rankings for ATP
https://tennis.sportdevs.com/rankings?type=eq.atp&class=eq.official

Get live rankings for ATP
https://tennis.sportdevs.com/rankings?type=eq.atp&class=eq.now

Get official rankings for WTA
https://tennis.sportdevs.com/rankings?type=eq.wta&class=eq.official

Get live rankings for WTA
https://tennis.sportdevs.com/rankings?type=eq.wta&class=eq.now

Query Parameters
  • type text

    Default value: eq.atp

    The type of the ranking (atp|wta)

  • class text

    Default value: eq.official

    The class of the ranking (official|now)

  • offset string

    Default value: 0

    Limiting and Pagination

  • limit string

    Default value: 50

    Limiting and Pagination

  • lang string

    Default value: en

    Multi-language

Responses

OK

Schema array
  • type text

    The type of the ranking (atp|wta)

  • class text

    The class of the ranking (official|now)

  • team_id integer

    The id of the team

  • team_name text

    The name of the team

  • team_hash_image character varying

    Possible values: <= 64 characters

    The hash image of the team

  • rank integer

    The rank of the team

  • points integer

    The points of the team

  • next_win_points integer

    The next win points of the team

  • max_points integer

    The max points of the team

  • best_rank integer

    The best rank of the team

  • previous_points integer

    The previous points of the team

  • tournaments_count integer

    The tournaments count of the team

Loading...