API publique

L'API open data Padel Snipe

Tous les clubs de padel cartographiés dans un seul fichier JSON. Sans authentification, sans pagination, sans rate-limit déraisonnable. Licence CC-BY 4.0 — vous pouvez l'utiliser librement à condition de créditer la source.

Endpoint

https://padelsnipe.com/api/world/clubs

GET — réponse JSON, cache CDN 24h, CORS ouvert

Format de réponse

{
  "license": "CC-BY-4.0",
  "license_url": "https://creativecommons.org/licenses/by/4.0/",
  "attribution": "Padel Snipe — https://padelsnipe.com/world",
  "generated_at": "2026-05-23T...",
  "count": 3680,
  "countries": ["BE", "DE", "ES", "FR", "GB", "IT", ...],
  "clubs": [
    {
      "id": "4padel-bordeaux",
      "slug": "4padel-bordeaux",
      "name": "4PADEL / Le Five - Bordeaux",
      "platform": "anybuddy",
      "country": "FR",
      "city": "Bordeaux",
      "postal_code": "33300",
      "latitude": 44.8797313,
      "longitude": -0.5584353,
      "courts": { "total": 7, "indoor": null, "outdoor": null },
      "image_url": "https://res.cloudinary.com/anybuddy/...",
      "release_pattern": { "value": "unknown", "label_en": "Unknown" },
      "is_partner": null
    }
  ]
}

Champs disponibles

idIdentifiant unique du club (tenant_id sur Playtomic, slug sur Anybuddy)
slugSlug URL (peut être null sur Playtomic)
nameNom marketing du club
platform"playtomic" ou "anybuddy"
countryCode pays ISO 3166-1 alpha-2 (FR, ES, IT…)
cityVille (peut être null)
postal_codeCode postal (peut être null)
latitude / longitudeCoordonnées GPS WGS84
courtsObjet { total, indoor, outdoor } — courts de padel
image_urlURL CDN d'une photo du club (peut être null)
release_patternPattern d'ouverture des réservations (machine + human labels)
is_partnerPartenaire Playtomic officiel (boolean)

Exemples d'usage

Bash / curl

curl -s https://padelsnipe.com/api/world/clubs | jq '.clubs | length'

JavaScript / Node

const res = await fetch('https://padelsnipe.com/api/world/clubs')
const { clubs } = await res.json()
console.log(`${clubs.length} clubs loaded`)

Python

import requests
data = requests.get('https://padelsnipe.com/api/world/clubs').json()
print(f"{len(data['clubs'])} clubs loaded")

Licence

Creative Commons Attribution 4.0 International (CC-BY 4.0). Vous pouvez copier, redistribuer et adapter ce dataset, y compris à des fins commerciales, à condition de créditer Padel Snipe et de mentionner la licence.

Attribution suggérée

Padel Snipe (2026). World padel atlas open dataset. https://padelsnipe.com/world. CC-BY 4.0.

Rate-limits

Pas de quota officiel — l'API est mise en cache via Vercel CDN, vous tapez essentiellement la copie cachée. Soyez raisonnable. En cas d'usage à très haute fréquence, ouvrez une issue GitHub.

Contact

Question, bug, ou demande de partenariat ? Écrivez à hello@padelsnipe.com ou ouvrez une issue sur GitHub.