Padel Snipe

API pubblica

L'API open data di Padel Snipe

Tutti i circoli di padel mappati in un unico file JSON. Nessuna autenticazione, nessuna paginazione, nessun rate-limit irragionevole. La licenza CC-BY 4.0 ti permette di usarlo liberamente, a condizione di citare la fonte.

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

GET — risposta JSON, cache CDN 24h, CORS aperto

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

CSV, idéal pour les data journalists, Kaggle ou data.gouv

Formato della risposta

{
  "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
    }
  ]
}

Campi disponibili

  • idIdentificativo univoco del circolo (tenant_id su Playtomic, slug su Anybuddy)
  • slugSlug URL (può essere null su Playtomic)
  • nameNome marketing del circolo
  • platform"playtomic" o "anybuddy"
  • countryCodice paese ISO 3166-1 alpha-2 (FR, ES, IT…)
  • cityCittà (può essere null)
  • postal_codeCodice postale (può essere null)
  • latitude / longitudeCoordinate GPS WGS84
  • courtsOggetto { total, indoor, outdoor } — campi da padel
  • image_urlURL CDN di una foto del circolo (può essere null)
  • release_patternPattern di apertura delle prenotazioni (etichette machine + human)
  • is_partnerPartner ufficiale Playtomic (boolean)

Esempi di utilizzo

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")

Licenza

Creative Commons Attribution 4.0 International (CC-BY 4.0). Puoi copiare, ridistribuire e adattare questo dataset, anche per scopi commerciali, a condizione di citare Padel Snipe e di menzionare la licenza.

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

Rate limit

Nessuna quota formale. L'API è in cache sul CDN Vercel, quindi accedi soprattutto alla copia in cache. Mantieniti ragionevole. Per un uso ad altissima frequenza, apri una issue su GitHub.

Contatto

Domanda, bug, o richiesta di partnership? Scrivi a hello@padelsnipe.com o apri una issue su GitHub.