PadelFIP Scraper

An Apify Actor that scrapes padel data from PadelFIP.com, including world rankings, player profiles, tournament information, live scores, news articles, and circuit statistics.

Features

• Get world rankings with gender, category, year, and country filters
• Search players by name
• Get detailed player profiles with stats, bio, partner, titles
• Get circuit performance statistics
• Get titles and finals leaderboard
• Get CUPRA FIP Tour statistics
• Get all currently live tournament scores
• Get live scores for a specific tournament
• Browse news articles with category filter
• Get full news article content
• List tournaments with circuit and year filters
• Get tournament details
• Get country/federation reference data

Actions

1. get_rankings

Get paginated world rankings.

Parameters:

• gender (optional): "male" or "female" (default: "male")
• category (optional): "master" or "junior" (default: "master")
• year (optional): Ranking year (defaults to current)
• week (optional): Ranking week number (defaults to current)
• country (optional): 3-letter country code (e.g., "ESP", "ARG")
• page (optional): Page number (default: 1)
• limit (optional): Items per page (default: 20)
• language (optional): "en" or "es" (default: "en")

Example Input:

{
    "action": "get_rankings",
    "gender": "male",
    "category": "master",
    "country": "ARG",
    "page": 1
}

2. search_players

Search players by name.

Parameters:

• query (required): Player name to search
• page (optional): Page number (default: 1)
• limit (optional): Items per page (default: 20)
• language (optional): "en" or "es" (default: "en")

Example Input:

{
    "action": "search_players",
    "query": "tapia"
}

3. get_player_profile

Get full player profile by slug.

Parameters:

• slug (required): Player slug (e.g., "agustin-tapia")

Example Input:

{
    "action": "get_player_profile",
    "slug": "agustin-tapia"
}

4. get_circuit_stats

Get circuit performance statistics.

Parameters:

• player_id (optional): Player ID (e.g., "P000285")
• gender (optional): "male" or "female"
• circuit (optional): Circuit slug filter
• year (optional): Year filter
• page (optional): Page number (default: 1)
• limit (optional): Items per page (default: 20)
• exclude (optional): Exclude filter
• language (optional): "en" or "es" (default: "en")

Example Input:

{
    "action": "get_circuit_stats",
    "player_id": "P000285",
    "year": 2026
}

5. get_titles_stats

Get titles and finals leaderboard.

Parameters:

• gender (optional): "male" or "female" (default: "male")
• page (optional): Page number (default: 1)
• limit (optional): Items per page (default: 20)
• language (optional): "en" or "es" (default: "en")

Example Input:

{
    "action": "get_titles_stats",
    "gender": "male"
}

6. get_cupra_stats

Get CUPRA FIP Tour statistics.

Parameters:

• gender (optional): "male" or "female" (default: "male")
• page (optional): Page number (default: 1)
• limit (optional): Items per page (default: 20)
• language (optional): "en" or "es" (default: "en")

Example Input:

{
    "action": "get_cupra_stats",
    "gender": "female"
}

7. get_live_scores

Get all currently live tournaments with scores.

Parameters: None

Example Input:

{
    "action": "get_live_scores"
}

8. get_live_tournament

Get live scores for a specific tournament.

Parameters:

• tournament_id (required): Tournament widget ID (e.g., "FIP-2026-1204")

Example Input:

{
    "action": "get_live_tournament",
    "tournament_id": "FIP-2026-1204"
}

9. get_news

Get paginated news article list.

Parameters:

• page (optional): Page number (default: 1)
• limit (optional): Items per page (default: 20)
• news_category (optional): News category slug

Example Input:

{
    "action": "get_news",
    "page": 1
}

10. get_news_article

Get a single news article by slug.

Parameters:

• slug (required): Article slug

Example Input:

{
    "action": "get_news_article",
    "slug": "fip-tour-2026-season-preview"
}

11. get_tournaments

List tournaments with filters.

Parameters:

• circuit (optional): Event category slug (e.g., "cupra-fip-tour", "fip-beyond")
• year (optional): Year filter (2021-2026)
• page (optional): Page number (default: 1)
• limit (optional): Items per page (default: 20)

Example Input:

{
    "action": "get_tournaments",
    "year": 2026,
    "circuit": "cupra-fip-tour"
}

12. get_tournament_detail

Get tournament details by slug.

Parameters:

• slug (required): Tournament/event slug

Example Input:

{
    "action": "get_tournament_detail",
    "slug": "fip-beyond-b3-grosseto"
}

13. get_countries

Get list of countries/federations.

Parameters:

• language (optional): "en" or "es" (default: "en")

Example Input:

{
    "action": "get_countries",
    "language": "en"
}

Output Format

All actions return data in a consistent format:

{
    "action": "action_name",
    "success": true,
    "data": { ... },
    "error": null,
    "timestamp": "2026-01-01T00:00:00.000Z"
}

On error:

{
    "action": "action_name",
    "success": false,
    "data": null,
    "error": "Error message",
    "timestamp": "2026-01-01T00:00:00.000Z"
}

Typical Workflows

Player Research

1. search_players with a name query
2. get_player_profile with the player's slug
3. get_circuit_stats with the player's ID

Tournament Tracking

1. get_tournaments to browse upcoming/past events
2. get_tournament_detail for specific event info
3. get_live_scores during live events

Rankings Analysis

1. get_rankings with gender/category filters
2. Filter by country to see national rankings
3. get_titles_stats for historical title data

Notes

• Uses curl_cffi with Chrome TLS fingerprint impersonation (required to bypass CDN bot protection)
• Rankings for positions 1-40 are scraped from HTML; deeper pages use the REST API
• Player profiles combine WP REST API data with HTML scraping for complete information
• Live scores are scraped from the Crionet widget embedded on PadelFIP
• Some data supports English and Spanish via the language parameter