Files

Deeman 4ae00b35d1 refactor: flatten padelnomics/padelnomics/ → repo root

git mv all tracked files from the nested padelnomics/ workspace
directory to the git repo root. Merged .gitignore files.
No code changes — pure path rename.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-02-22 00:44:40 +01:00

28 KiB

Raw Blame History

Padel Market Intelligence — Data Sources Inventory

Compiled: 2026-02-21 Purpose: Identify data sources to feed a DuckDB analytics pipeline for padel business intelligence.

Priority Summary Table

Sorted by Priority (High first), then by category.

Source	Category	Access Method	Priority	Notes
OpenStreetMap / Overpass API	Court Locations	Public API	High	Free, global, `sport=padel` tag, no auth
Playtomic API (read-only)	Court Locations / Pricing	Public API	High	Some endpoints unauthenticated; official API needs club credentials
Eurostat Statistics API	Demographics	Public API	High	Free, no auth, NUTS city-level data
US Census Bureau API	Demographics	Public API	High	Free with API key, comprehensive
ONS Beta API	Demographics	Public API	High	Free, no auth, 120 req/10 s limit
FIP World Padel Report	Market Reports	Open Download	High	Free PDF; 2024 and 2025 editions available
Playtomic Global Padel Report	Market Reports	Open Download	High	Free PDF; co-produced with PwC/Strategy&
Sport England Active Lives	Demographics	Open Download	High	Free download; UK sports participation data
USPA Court Directory	Court Locations	Scrape	High	Website scrape; 100+ member clubs listed
DPV Standorte (Germany)	Court Locations	Scrape	High	German federation venue page, small dataset
LTA Padel Venue Finder	Court Locations	Scrape	High	UK venue registry; The Padel Directory also available
PadelAPI.org	Tournament Data	Public API	High	Free tier: 50k req, last 6 months of data
padelapi.org MCP server	Tournament Data	Public API	High	AI-accessible padel tournament & player stats
Google Maps Places API	Court Locations	Public API	Medium	$200 free/mo credit; text search for padel courts
Playtomic third-party API	Pricing / Bookings	Public API	Medium	Club credential required; read-only; 1 req/min
ImmoScout24 API	Real Estate	Public API	Medium	Developer portal; commercial use; auth required
Immowelt API	Real Estate	Public API	Medium	API documented; aggregator EstateSync also available
planning.data.gov.uk	Regulatory	Public API	Medium	UK planning data portal; some endpoints open
FEP (Spanish federation)	Market Reports	Manual	Medium	Annual statistics published as press releases
Statista (padel topic page)	Market Reports	Subscription	Low	Some charts free; full data requires subscription
Playskan.com	Pricing / Bookings	Scrape	Low	No public API; consumer site; ToS unclear
CoStar / LoopNet	Real Estate	Subscription	Low	No public API; subscription only; scraping violates ToS
Rightmove Commercial API	Real Estate	Subscription	Low	ADF partner program only; not open to arbitrary developers
JLL / CBRE Reports	Real Estate	Manual	Low	Published reports only; no API
Court Metrics	Pricing / Utilisation	Subscription	Low	Aggregated padel club competitive intelligence platform
Shovels.ai	Regulatory	Subscription	Low	US building permit intelligence; paid
Matchi	Court Locations	Scrape	Low	No documented public API; consumer app

1. Court Location & Registry Data

1.1 OpenStreetMap — Overpass API

Field	Value
URL	https://overpass-turbo.eu / https://overpass-api.de/api/
Data Type	Geographic — padel court locations, geometry, names, addresses
Access Method	Public API
Update Frequency	Continuous (community-edited)
License / TOS	ODbL — open use with attribution
Priority	High

OSM uses the tag sport=padel on leisure=sports_centre or leisure=pitch nodes. The Overpass API is free, unauthenticated, and globally scoped. Query example:

[out:json];
(
  node["sport"="padel"];
  way["sport"="padel"];
  relation["sport"="padel"];
);
out body;

Limitations: coverage is community-driven and incomplete in newer markets (Germany, US). Spain and UK coverage is reasonable. Data can be downloaded in bulk as .osm.pbf files from Geofabrik for a full DuckDB load.

OSM wiki: https://wiki.openstreetmap.org/wiki/Tag:sport=padel

1.2 Playtomic API

Field	Value
URL	https://third-party.playtomic.io / https://api.playtomic.io/v1
Data Type	Venues (tenants), court availability, pricing slots
Access Method	Public API (some endpoints); club credentials (official third-party API)
Update Frequency	Real-time
License / TOS	Playtomic ToS — data may not be redistributed; read-only API
Priority	High (unauthenticated availability), Medium (official API)

Two access tiers exist:

Unauthenticated endpoints (confirmed via reverse engineering, March 2025):

GET /v1/availability?sport_id=PADEL&start_min=...&start_max=...&tenant_id=... — max 25 h window per request
GET /v1/tenants?sport_ids=PADEL&... — tenant (venue) search by geo-bounds; no auth required

Official Third-Party API (credential-based):

Credentials generated in Playtomic Manager → Settings → Developer Tools
Requires Champion or Master subscription plan per tenant
Read-only; rate limit ~1 call/minute
Auth: POST https://api.playtomic.io/oauth/token with client_id, client_secret, grant_type

External API docs (Notion): https://playtomicio.notion.site/Playtomic-External-API-Documentation-v1-5-57430603e8324c7c9f69bb2c9327eb98

Playtomic covers 16,000+ courts globally. The platform is dominant in Spain, UK, France, Germany, and expanding in the US.

1.3 DPV — Deutscher Padel Verband Standorte

Field	Value
URL	https://www.dpv-padel.de/standorte-2/
Data Type	German federation-registered padel venues
Access Method	Scrape
Update Frequency	Periodic (federation-managed)
License / TOS	No explicit open data license; scrape for internal use only
Priority	High

The DPV "Standorte" page lists DPV-registered venues in Germany. No API exists. The dataset is small (Germany has ~875 courts as of end 2025) and can be scraped as a one-time or periodic snapshot.

1.4 LTA Padel Venue Finder (UK)

Field	Value
URL	https://www.ltapadel.org.uk/play/find-a-padel-court/
Data Type	UK padel venue registry; court count, location, facilities
Access Method	Scrape
Update Frequency	Ongoing (LTA maintains registration program)
License / TOS	No public API or data license; scrape for internal use
Priority	High

The LTA runs a venue registration program. As of July 2025, the UK has 1,000+ courts across 325 venues. The Padel Directory (https://www.thepadeldirectory.co.uk/) is an alternative aggregator with filtering. Neither offers a public API.

1.5 USPA US Padel Club Directory

Field	Value
URL	https://padelusa.org/us-padel-clubs/
Data Type	US padel club registry; name, city, state
Access Method	Scrape
Update Frequency	Periodic
License / TOS	No explicit license; internal use scrape
Priority	High

The USPA lists 100+ member clubs with city/state. The dataset is small enough for a one-time scrape plus quarterly refresh. Only USPA member clubs are listed — not comprehensive for all US courts.

1.6 Google Maps Places API

Field	Value
URL	https://developers.google.com/maps/documentation/places/web-service/overview
Data Type	Business name, address, coordinates, ratings, opening hours
Access Method	Public API (paid)
Update Frequency	Real-time
License / TOS	Google Maps Platform ToS — data cannot be stored beyond caching limits without a license
Priority	Medium

Text Search ("padel court" + city) returns POI data including address and rating. Pricing from March 2025: Essentials tier free up to 10,000 events/month; Text Search (Basic) ~$0.04/request beyond that. Storing results in a database requires a Maps Data Export license agreement.

Use case: gap-fill where OSM or federation data is absent, particularly for US venues.

1.7 World Padel Rating

Field	Value
URL	https://app.worldpadelrating.com/tournaments
Data Type	Player rankings, tournament venues
Access Method	Scrape
Update Frequency	After each tournament
License / TOS	No public API documented
Priority	Low

Tournament venue data, not a comprehensive court registry. Limited utility for location intelligence.

1.8 Matchi (Racket Sports Booking)

Field	Value
URL	https://www.matchi.se
Data Type	Venue listings, court availability (Scandinavia, some EU)
Access Method	Scrape
Update Frequency	Real-time
License / TOS	No public API; ToS prohibits scraping
Priority	Low

Matchi is a Playtomic competitor popular in Sweden and northern Europe. Used by Playskan as a data source. No documented public API found.

2. Pricing & Revenue Data

2.1 Playtomic — Public Availability & Pricing

(See 1.2 above for API details.)

The unauthenticated /v1/availability endpoint returns time slots with prices visible to consumers. This enables per-venue, per-city price benchmarking without club credentials. Max 25 h window per request; rate limit must be respected.

2.2 Playskan.com

Field	Value
URL	https://www.playskan.com
Data Type	Aggregated court availability + price ranges across Playtomic, Matchi, Padel Mates (UK-focused)
Access Method	Scrape
Update Frequency	Real-time (consumer UI)
License / TOS	No public API; built on FastAPI + DynamoDB internally; ToS unclear
Priority	Low

Playskan is the world's first padel booking aggregator (UK + some EU), described as "Skyscanner for padel courts." The platform itself aggregates Playtomic, Matchi, and Padelmates data. It offers a calendar view with availability counts and price ranges. No public API; the backend is internal. Going directly to source APIs (Playtomic, Matchi) is preferred.

2.3 Court Metrics

Field	Value
URL	https://courtmetrics.io
Data Type	Estimated booking revenue, pricing, utilisation signals, Google Maps reputation per club
Access Method	Subscription
Update Frequency	Ongoing
License / TOS	Commercial SaaS; data derived from public booking platform signals
Priority	Low

Court Metrics is a padel-specific competitive intelligence SaaS that aggregates publicly visible pricing and availability data plus Google Maps signals. It provides estimated revenue per competitor club. Useful as a benchmark check but adds cost as a dependency. Data source is ultimately the same public Playtomic/booking signals.

3. Market Growth & Industry Reports

3.1 FIP World Padel Report

Field	Value
URL	https://www.padelfip.com/world-padel-report-2025/
Data Type	Global court counts, player numbers, federation membership by country, tournament stats
Access Method	Open Download (PDF)
Update Frequency	Annual (December)
License / TOS	FIP copyright; citations permitted
Priority	High

Published annually by the International Padel Federation. The 2025 edition (released December 2025) reports 77,300 courts globally (+15.2%), 35M+ players, 100 member federations. The 2024 edition PDF is available directly from the Danish Padel Federation and other mirrors.

Direct PDF (2024): https://padelfip.com/pdf/WORLD_PADEL_REPORT_2024_FIP.pdf

3.2 Playtomic Global Padel Report

Field	Value
URL	https://playtomic.com/global-padel-report
Data Type	Global court counts, club growth rates, booking patterns, country-level breakdowns
Access Method	Open Download (PDF)
Update Frequency	Annual
License / TOS	Playtomic/PwC copyright; citations permitted
Priority	High

Co-produced with PwC's Strategy& arm. The 2025 report covers 50,000+ courts globally, 3,282 new clubs in 2024 (avg 9/day), 92% player return rate. Free download at playtomic.com/global-padel-report.

PDF mirror: https://www.padeladdict.com/wp-content/uploads/2025/07/PLAYTOMIC_GLOBAL-_PADEL_REPORT_2025.pdf

3.3 Playtomic Global Padel Report 2023 (Deloitte)

Field	Value
URL	https://www.scribd.com/document/714549135/202306-Global-Padel-Report-2023
Data Type	Market valuation (€1.775B global padel club market as of 2023), growth projections
Access Method	Open Download (PDF)
Update Frequency	One-time (2023 edition)
License / TOS	Playtomic/Deloitte copyright
Priority	Medium

Earlier edition co-produced with Deloitte. Contains baseline market valuation data useful for DuckDB time series.

3.4 Statista — Padel Topic Page

Field	Value
URL	https://www.statista.com/topics/12528/padel/
Data Type	Market size, equipment revenue, country stats, consumer survey results
Access Method	Subscription (some charts free)
Update Frequency	Irregular
License / TOS	Statista commercial license required for data export
Priority	Low

The padel topic page aggregates third-party data (FIP, Playtomic, national federations). The underlying data is available from primary sources for free; Statista adds presentation but no original data collection.

Field	Value
URL	https://newsletter.padelbusinessmagazine.com
Data Type	Market statistics digests, court count updates, industry news
Access Method	Open (newsletter / web)
Update Frequency	Weekly
License / TOS	Editorial content; no API
Priority	Medium

Regularly aggregates and re-publishes FIP/Playtomic data with added context. Useful for tracking new report releases. No structured data.

3.6 Misitrano Consulting — State of Padel in the US 2025

Field	Value
URL	https://www.misitranoconsulting.com/us-padel-report
Data Type	US market size, court counts by state, investment trends
Access Method	Manual (form download)
Update Frequency	Annual
License / TOS	Commercial consulting report
Priority	Medium

US-specific market sizing. Gated but free download. Useful supplement to FIP for the US segment.

4. Commercial Real Estate Data

4.1 ImmoScout24 API (Germany)

Field	Value
URL	https://api.immobilienscout24.de
Data Type	Commercial property listings; rent/price per sqm by location
Access Method	Public API (requires registration + commercial use agreement)
Update Frequency	Real-time (listings)
License / TOS	Commercial use only; API ToS prohibits redistribution
Priority	Medium

ImmoScout24 has a documented developer portal with Import/Export API, search API, and a Market Data endpoint. Sandbox access is available via registration. The Market Data API provides price/rent indices. Authentication via OAuth 1.0/2.0. Primarily targets real estate agents and portals, but market data endpoints are accessible to analytics users with a commercial account.

4.2 Immowelt API (Germany)

Field	Value
URL	https://www.immowelt.de/anbieten/gewerbe/apitechdoku
Data Type	Commercial rental listings; warehouse and industrial space
Access Method	Public API (requires partner registration)
Update Frequency	Real-time
License / TOS	Partner/commercial agreement required
Priority	Medium

Immowelt documents an API for commercial listings. EstateSync (https://estatesync.com/en/) provides a wrapper REST API for both ImmoScout24 and Immowelt. Useful for tracking warehouse/industrial rental rates as a proxy for padel hall fit-out costs.

4.3 Rightmove Commercial Listings API (UK)

Field	Value
URL	https://api-docs.rightmove.co.uk/docs/property-feed-api-product/1/overview
Data Type	Commercial property listings; rents, sizes, locations
Access Method	Subscription (ADF partner program)
Update Frequency	Real-time
License / TOS	Rightmove ADF partner agreement; not open to arbitrary developers
Priority	Low

Rightmove's API (ADF format) is restricted to partner estate agents and portals. Contact adfsupport@rightmove.co.uk for access. Not practically accessible for a startup analytics pipeline without a commercial relationship.

4.4 LoopNet / CoStar (US + UK)

Field	Value
URL	https://www.loopnet.com / https://www.costar.com
Data Type	Commercial real estate listings, market analytics
Access Method	Subscription
Update Frequency	Real-time
License / TOS	Proprietary; no public API; scraping violates ToS
Priority	Low

CoStar acquired LoopNet and operates both as subscription services. No public API exists. A previous government-mandated data sharing arrangement (post-LoopNet acquisition) with Xceligent collapsed after copyright violations. For US commercial rent benchmarks, manual extraction or a CoStar institutional subscription is the only legitimate path.

4.5 JLL / CBRE Market Reports

Field	Value
URL	https://www.jll.com/en-de/insights / https://www.cbre.com/insights
Data Type	Commercial real estate market indices; industrial/warehouse rents; European market outlook
Access Method	Manual (PDF reports)
Update Frequency	Quarterly
License / TOS	Copyright; no API; PDF/HTML reports only
Priority	Low

JLL and CBRE publish free quarterly market reports for Germany, UK, and other EU markets covering industrial/warehouse rents. These are manually downloaded PDFs — no structured data export. Useful for one-time benchmarks to seed DuckDB reference tables.

JLL Germany Q4 2025 Investment Market: https://www.jll.com/en-de/insights/market-dynamics/germany-investment

5. Demographics & Socioeconomics

5.1 Eurostat Statistics API

Field	Value
URL	https://ec.europa.eu/eurostat/web/user-guides/data-browser/api-data-access/api-introduction
Data Type	Population, income, sports participation (EHIS), NUTS city-level
Access Method	Public API
Update Frequency	Annual to multi-year (survey-dependent)
License / TOS	CC BY 4.0 — free use with attribution
Priority	High

Eurostat's Statistics API (SDMX 3.0 + REST) is free and unauthenticated. Base URL: https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/data/{datasetCode}.

Key datasets:

sprt_pcs — sport participation by country (from EHIS; wave 4 expected 2025/26)
urb_cpop1 — city population statistics (NUTS LAU)
ilc_di03 — median equivalised net income by NUTS2

The R eurostat package and Python eurostat library provide typed wrappers. Data is queryable at NUTS2/NUTS3 and city level using geoLevel=city.

5.2 US Census Bureau API

Field	Value
URL	https://www.census.gov/data/developers.html
Data Type	Population, income, age distribution (ACS 5-year), geographic boundaries
Access Method	Public API (free API key)
Update Frequency	Annual (ACS)
License / TOS	Public domain (US federal government data)
Priority	High

The American Community Survey (ACS) API provides city and tract-level demographics. Free API key required (no cost). Endpoint pattern: https://api.census.gov/data/2023/acs/acs5?get=B01003_001E,NAME&for=place:*&in=state:12.

Relevant for US market expansion analysis.

5.3 ONS Beta API (UK)

Field	Value
URL	https://developer.ons.gov.uk
Data Type	UK city/MSOA demographics, income, population
Access Method	Public API
Update Frequency	Annual
License / TOS	Open Government Licence v3 — free use
Priority	High

The ONS Beta API at https://api.beta.ons.gov.uk/v1 is open and unauthenticated. Rate limit: 120 requests/10 s, 200/min. Datasets include population estimates, deprivation indices, and 2021 census variables at MSOA/LAD level. Sports participation specifically comes from Sport England (see 5.4), not ONS directly.

5.4 Sport England — Active Lives Survey

Field	Value
URL	https://www.sportengland.org/research-and-data/data/active-lives
Data Type	UK sports participation rates by sport, age, geography (local authority level)
Access Method	Open Download (CSV/Excel)
Update Frequency	Annual (April publication)
License / TOS	Open Government Licence v3
Priority	High

Active Lives is the UK's primary sports participation survey (~200,000 respondents/year). The November 2023–24 report was published April 2025. Data tables are downloadable from Sport England's website. The UK Data Service also holds microdata for detailed analysis. Sports classification does not yet include padel as a standalone category, but racket sports and physical activity levels at local authority level are relevant for site selection.

Interactive explorer: https://activelives.sportengland.org/

5.5 Statista (Sports Market Data)

(See 3.4 above — same platform, subscription required for export.)

6. Regulatory & Zoning

6.1 UK Planning Data Portal

Field	Value
URL	https://www.planning.data.gov.uk
Data Type	Planning applications, permissions, land use data (England)
Access Method	Public API
Update Frequency	Ongoing
License / TOS	Open Government Licence v3
Priority	Medium

MHCLG's Planning Data service provides an API for planning applications across England. The API documentation is at https://www.planning.data.gov.uk/docs. Third-party services like Landhawk (https://www.landhawk.uk/api/planning-application-data/) and Searchland provide enhanced APIs with historical data back to 1990. The London Planning Datahub (https://www.london.gov.uk/programmes-strategies/planning/digital-planning/planning-london-datahub) provides London-specific real-time planning data.

Use case: identify commercial/industrial sites with planning permission for sports use, or track padel-related applications.

6.2 GovData — Germany Open Data Portal

Field	Value
URL	https://www.govdata.de
Data Type	German federal/state open data (CKAN catalog); building permits at aggregate level
Access Method	Public API (CKAN REST)
Update Frequency	Varies by dataset
License / TOS	CKAN ODbL / individual dataset licenses
Priority	Medium

GovData hosts 1,200+ high-value datasets from German federal, state, and local governments. Building permit data is available at aggregate statistical level (monthly counts by type, from Destatis). Individual permit records are not centralised — they remain with local Bauämter (building offices). The CEIC database publishes aggregated Germany Building Permits indicators: https://www.ceicdata.com/en/indicator/germany/building-permits.

6.3 Shovels.ai (US Building Permits)

Field	Value
URL	https://www.shovels.ai
Data Type	US building permit records; commercial construction activity
Access Method	Subscription
Update Frequency	Ongoing
License / TOS	Commercial SaaS
Priority	Low

Shovels aggregates US local building permit databases into a searchable API. Relevant for tracking new sports facility construction in the US. Paid subscription; pricing not publicly listed.

7. Tournament & Professional Circuit Data

7.1 PadelAPI.org

Field	Value
URL	https://padelapi.org / https://docs.padelapi.org
Data Type	Professional tournament draws, results, player stats, rankings (Premier Padel + WPT archive)
Access Method	Public API
Update Frequency	Real-time during tournaments
License / TOS	Free tier available (50k requests, last 6 months); paid tiers for full history
Priority	High

Token-based REST API. Free tier includes 50k requests/month and last 6 months of match data. Covers Premier Padel and 2023 WPT events. Includes an MCP server for AI assistant integration. Useful for correlating major tournament venues with local market demand signals.

8. DuckDB Integration Notes

Recommended ingestion patterns

Source	Ingestion Pattern
Eurostat API	`httpfs` + JSON → staging table; run weekly
Overpass API / OSM	Bulk `.osm.pbf` download via Geofabrik → DuckDB spatial extension; run monthly
Playtomic unauthenticated API	Paginated scraper per city bounding box → Parquet; run nightly
FIP / Playtomic PDFs	Manual parse → CSV seed files; run annually
US Census ACS	`httpfs` REST → staging; run annually
ONS Beta API	`httpfs` REST → staging; run annually
Sport England CSV	Manual download → seed file; run annually
ImmoScout24 / Immowelt	API → staging (requires partner account); run monthly
planning.data.gov.uk	REST API → staging; run weekly for new permissions

Key technical constraints

Playtomic: availability endpoint limited to 25 h windows per call; ~1 req/min recommended on the official API. The unauthenticated tenant search endpoint has no documented rate limit but should be throttled (1 req/2 s).
Eurostat: no rate limit documented for the Statistics API; the SDMX API supports bulk dataset downloads.
ONS Beta API: 120 req/10 s hard limit; back off on 429.
Google Maps Places: storage of query results beyond the caching window requires a Maps Data Export license.
CoStar/LoopNet/Rightmove: no legitimate automated access path without partner agreements. Avoid scraping — ToS explicitly prohibit it and CoStar has a history of pursuing copyright enforcement.

28 KiB Raw Blame History Unescape Escape