/v1/players

Find players by name or country.

GEThttps://api.tabletennisapi.com/v1/players

Plans:Free keyLiveArchiveComplete

Parameters

Name	In	Type	Required	What it does	Example
`q`	query	string	optional	Part of the name, at least 2 letters	`Harimoto`
`country`	query	string	optional	Three letters (CHN, JPN)	`CHN`

Run it live

GET /v1/playersA real call to the API, from your browser

qcountry

Your key stays in this page: it is sent only to api.tabletennisapi.com and never stored. Left empty, the call runs on a free key with its dates and fields, 20 calls a minute.

GEThttps://api.tabletennisapi.com/v1/players

Not run yet

Press Run it to see the answer here.

Response

A real answer from the data, two rows shown. Every field is described in the manual.

200 OKapplication/json

{
    "data": [
        {
            "id": "pl_51t63nz3",
            "name": "Harimoto Miwa",
            "country": "JPN"
        },
        {
            "id": "pl_mc5w19rn",
            "name": "Harimoto Tomokazu",
            "country": "JPN"
        }
    ],
    "meta": {
        "count": 2,
        "next_cursor": null,
        "page": 1,
        "per_page": 2,
        "total": 2,
        "total_pages": 1,
        "next_page": null,
        "prev_page": null
    }
}

Example

curl

curl https://api.tabletennisapi.com/v1/players \
  -H "Authorization: Bearer $TT_KEY"

Python

import os, requests
res = requests.get("https://api.tabletennisapi.com/v1/players",
    headers={"Authorization": "Bearer " + os.environ["TT_KEY"]}).json()

Answers come back as data and meta; errors as error. See Errors and Pagination.