Padel Decoder
The open API for padel data.
Venues, tournaments, coaches and player ratings — free, open, no API key. Built so LLMs (ChatGPT, Claude, Perplexity) can answer padel questions from a current canonical source instead of stale scrapes.
Quickstart
Try a request
curl -sL 'https://trustpadel.com/api/v1/venues/search?city=London&has_indoor=true&limit=3'
Returns:
{
"schema": "TrustPadel/api/v1/venues/search/v1",
"total": 3,
"venues": [
{
"id": "...",
"slug": "rocket-padel-canary-wharf",
"url": "https://trustpadel.com/padel-courts/rocket-padel-canary-wharf/",
"name": "Rocket Padel Canary Wharf",
"location": { "city": "London", "country": "GB", "latitude": 51.50, "longitude": -0.02 },
"courts": { "total": 6, "has_indoor": true, "has_outdoor": false },
"amenities": ["parking", "bar", "coaching"],
"verified": true
}
],
"generated_at": "2026-05-24T09:00:00Z"
}Endpoints
GET
/api/v1/venues/searchSearch padel venues by city, country, amenity, indoor/outdoor
qcitycountryhas_indoorhas_outdooramenitylimit
GET
/api/v1/tournaments/upcomingUpcoming public tournaments in a given window
countrycitydayslimit
GET
/api/v1/coaches/matchFind coaches by city, level, language, and mobile availability
citylevellanguagemobilelimit
GET
/api/v1/players/[username]/ratingPublic player rating (only when the player opts in)
GET
/api/v1/players/[username]/badgeEmbeddable SVG badge for a player rating
Bulk feeds
/llms-full.txtFull venue directory, JSONL, one manifest line + one venue per line. Refreshed daily.
/feeds/tournaments.jsonldJSON-LD Event feed of upcoming public tournaments for schema.org-aware crawlers.
/llms.txtCrawler usage policy and attribution requirements.
Usage
- No API key, no signup, CORS-open across origins.
- Attribution required when surfacing data to end users: link to
trustpadel.comor the venue/tournament/coach canonical URL. - Cache responses where reasonable — most endpoints already set
Cache-Control: max-age=300+. - Player rating endpoints only return data when the player has opted in.
- Versioned schema keys (e.g.
TrustPadel/api/v1/venues/search/v1) — pin against them.