Skip to main content
Esta guía está escrita en español para estudiantes de universidades hispanohablantes. El resto de la documentación de Padel API está disponible en inglés.

¿Por qué datos de pádel para tu proyecto?

Si estás buscando un dataset deportivo para tu TFG o TFM, probablemente ya has visto que todo el mundo hace proyectos con datos de fútbol. Los datasets de La Liga, Premier League o Champions están explotados: hay cientos de trabajos académicos prediciéndolos con las mismas técnicas y los mismos datos. El pádel profesional te ofrece algo distinto:
  • Originalidad. No hay prácticamente datasets públicos de pádel. Tu trabajo será uno de los primeros en explotar estos datos, algo que un tribunal valora.
  • Datos limpios y accesibles. Padel API te da acceso estructurado vía REST API. Sin web scraping, sin limpiar HTMLs, sin que se rompa el scraper a mitad de proyecto.
  • Scope acotado. El circuito profesional tiene un volumen de datos manejable para un TFG/TFM, suficiente para análisis significativos sin necesitar infraestructura de Big Data.
  • Deporte de dobles. El pádel se juega en parejas, lo que añade una dimensión analítica que no existe en tenis: cambios de pareja, compatibilidad entre jugadores, dinámicas de equipo.
  • Deporte en crecimiento. El pádel es el deporte de raqueta con mayor crecimiento global. Contextualizar tu trabajo en un deporte con relevancia actual refuerza la motivación del proyecto.

Qué datos ofrece Padel API

Padel API cubre el circuito profesional: Premier Padel (Major, P1, P2, Finals) y el histórico de World Padel Tour y Padel Pro Tour. Estos son los tipos de datos disponibles:

Jugadores

Perfiles completos: nombre, nacionalidad, fecha de nacimiento, posición de juego (drive/revés), mano dominante y foto.

Rankings

Rankings oficiales actualizados con posición, puntos y categoría (masculino/femenino). Histórico por temporada.

Torneos

Todos los torneos del circuito con fechas, nivel, ubicación y cuadros completos.

Partidos

Resultados de partidos con marcador, ronda, parejas y fecha. Incluye cuadros completos de cada torneo.

Estadísticas

Estadísticas detalladas de partido: puntos ganados, winners, errores no forzados, break points, aces y más.

Punto a punto

Secuencia completa de puntos de cada partido disponible para torneos Major, P1, P2 y Finals.
Consulta la referencia completa de la API para ver todos los endpoints, parámetros y formatos de respuesta disponibles.

Ideas de proyecto

Estas son ideas concretas de proyectos que puedes desarrollar con datos de Padel API, organizadas por tipo de técnica.

Predicción y clasificación

Sistemas de rating

El sistema ELO para dobles es especialmente interesante como TFG porque adaptar ELO de un deporte individual (ajedrez) a un deporte de parejas con cambios frecuentes de compañero es un problema no trivial. Requiere decidir cómo repartir el rating entre los dos jugadores de una pareja, lo que da pie a comparar múltiples enfoques.

Aprendizaje no supervisado

Series temporales y regresión

Análisis de redes y grafos

El análisis de redes de parejas es un proyecto muy original y específico del pádel. No existe equivalente en tenis u otros deportes individuales, y los cambios frecuentes de pareja en el circuito profesional generan grafos interesantes para analizar.

Visualización y dashboards


Cómo empezar con Python

1. Crea tu cuenta y obtén un API token

  1. Regístrate en padelapi.org/register
  2. Ve a API Tokens y crea un token
  3. Guarda el token. No podrás verlo de nuevo
No subas tu token a GitHub ni lo incluyas directamente en el código de tu TFG. Usa variables de entorno o un archivo .env que esté en tu .gitignore.

2. Tu primera llamada a la API

3. Recopilar datos con paginación

La API devuelve resultados paginados (15 por defecto, máximo 50). Para obtener todos los resultados necesitas recorrer las páginas:

4. Exportar a CSV

Descarga los datos una vez y trabaja con los CSV localmente. Así no dependes de la conexión a internet, no consumes tu cuota de requests innecesariamente y garantizas la reproducibilidad de tu análisis.

Cómo incluir Padel API en tu TFG/TFM

Sección de metodología

Tu TFG/TFM necesita explicar cómo has obtenido los datos. Aquí tienes una plantilla que puedes adaptar:
Los datos utilizados en este trabajo se han obtenido a través de Padel API (https://padelapi.org), una API REST que proporciona acceso estructurado a datos del circuito profesional de pádel, incluyendo torneos Premier Padel y World Padel Tour. Los datos incluyen [rankings de jugadores / resultados de partidos / estadísticas detalladas / …] correspondientes a las temporadas [2023-2026]. La recopilación de datos se realizó mediante peticiones HTTP autenticadas a los endpoints de la API, procesando las respuestas en formato JSON con la librería pandas de Python. Se recopilaron un total de [N] registros de [partidos / jugadores / torneos / …]. Los datos fueron almacenados localmente en formato CSV para garantizar la reproducibilidad del análisis, de acuerdo con las condiciones de uso de la API.

Cómo citar Padel API

Formato APA:
Formato IEEE:

Planes y precios

Padel API ofrece un plan gratuito que incluye acceso a jugadores, rankings y torneos, suficiente para muchos proyectos académicos. Para acceder a estadísticas detalladas de partidos y datos punto a punto, necesitarás un plan de pago. Consulta los planes disponibles en padelapi.org.
Si eres estudiante y necesitas acceso a datos avanzados para tu TFG/TFM, contacta en ferran@padelapi.org indicando tu universidad y una breve descripción de tu proyecto.

Siguientes pasos

Tu primera llamada a la API

Guía paso a paso para autenticarte y hacer tu primera petición

Referencia de la API

Documentación completa de todos los endpoints disponibles