# Pickleball API (`fingolfin/pickleball-data-api`) Actor An enterprise-grade Apify Actor that delivers unified, real-time pickleball data from across the official pickleball ecosystem — players, rankings, results, tournaments, leagues, and clubs — through a single, consistent interface. RESTAPI https://rapidapi.com/matepapava123/api/pickleball-live-api - **URL**: https://apify.com/fingolfin/pickleball-data-api.md - **Developed by:** [Mate Papava](https://apify.com/fingolfin) (community) - **Categories:** AI, Agents, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Pickleball Data API — Apify Actor An enterprise-grade Apify Actor that delivers unified, real-time pickleball data from across the official pickleball ecosystem — players, rankings, results, tournaments, leagues, and clubs — through a single, consistent interface. **Data sources:** - [pickleball.com](https://pickleball.com) — rankings, players, results - [pickleballtournaments.com](https://pickleballtournaments.com) — tournaments - [pickleballleagues.com](https://pickleballleagues.com) — leagues & game days - [pickleballclubs.com](https://pickleballclubs.com) — clubs & members --- ### Actions Select an action from the `action` dropdown in the Actor input. Each action has its own set of required and optional parameters described below. --- #### Rankings ##### `get_rankings` Top-10 PPA Tour player standings for a given discipline. | Parameter | Required | Default | Description | |---|---|---|---| | `discipline` | No | `WS` | `WS` · `MS` · `WD` · `MD` · `MX` · `WX` | ##### `get_rankings_full` Full ~100-entry leaderboard for a given discipline. | Parameter | Required | Default | Description | |---|---|---|---| | `discipline` | No | `WS` | Same codes as above | --- #### Players ##### `search_players` Search and filter 794,000+ registered pickleball players (20 per page). | Parameter | Required | Default | Description | |---|---|---|---| | `search` | No | | Last name search term | | `age` | No | | Age range: `0-17` · `18-29` · `30-39` · `40-49` · `50-59` · `60-69` · `70-79` · `80-100` | | `gender` | No | | `M` or `F` | | `doubles_skill` | No | | DUPR doubles range e.g. `4.0-5.0` (scale 0–8) | | `singles_skill` | No | | DUPR singles range e.g. `4.0-5.0` (scale 0–8) | | `wpr_badge` | No | | WPR tier: `TOUR PRO` · `LEGEND` · `ICON` · `TITAN` · `BALLER` · `CONTENDER` · `PLAYER` · `Top 1` · `Top 50` · `Top 100` · `Top 500` · `Top 1000` | | `country_id` | No | | Country ID integer | | `state_id` | No | | State ID integer | | `city` | No | | City name | | `page` | No | `1` | Page number | ##### `get_player_profile` Complete player profile: ratings, PPA stats, WPR badge, sponsors, biography, and tournament match history. | Parameter | Required | Default | Description | |---|---|---|---| | `slug` | Yes | | Player URL slug e.g. `aanik-lohani` | ##### `get_player_filters` Returns all available filter options (age ranges, gender, WPR badge tiers, skill scale) for `search_players`. No parameters required. --- #### Results ##### `get_results_on_date` All completed tournament and MLP team league results for a given date. | Parameter | Required | Default | Description | |---|---|---|---| | `date` | Yes | | Date in `YYYY-MM-DD` format | ##### `get_results_matchup` Full matchup data: teams, game-by-game scores, player assignments, court info. | Parameter | Required | Default | Description | |---|---|---|---| | `matchup_id` | Yes | | Matchup identifier (from `get_results_on_date`) | ##### `get_results_h2h` Head-to-head historical stats between two teams. | Parameter | Required | Default | Description | |---|---|---|---| | `team_ids` | Yes | | Two team UUIDs comma-separated e.g. `uuid1,uuid2` | ##### `get_results_tiebreaker` Point-by-point tiebreaker sequence for a specific match game. | Parameter | Required | Default | Description | |---|---|---|---| | `match_id` | Yes | | Match identifier | | `game_number` | No | `1` | Game number within the match | --- #### Tournaments ##### `search_tournaments` Search tournaments on pickleballtournaments.com with filters. | Parameter | Required | Default | Description | |---|---|---|---| | `keyword` | No | | Search keyword | | `tournament_filter` | No | `featured` | `featured` · `upcoming` · `past` · `all` · `local` · `national_tours` · `sanctioned` · `moneyball` | | `page` | No | `1` | Page number | | `place_keyword` | No | `Anywhere` | `Anywhere` · `United States` · `Canada` · `Europe` · `Pacific` · `Mountain` · `Central` · `Eastern` | ##### `get_tournament_detail` Full tournament detail by slug: name, venue, dates, entry fee, director, description. | Parameter | Required | Default | Description | |---|---|---|---| | `slug` | Yes | | Tournament URL slug | --- #### Leagues ##### `search_leagues` Search leagues from pickleballleagues.com (20 per page). | Parameter | Required | Default | Description | |---|---|---|---| | `keyword` | No | | Search keyword | | `league_status` | No | `active` | `active` · `past` · `all` | | `page` | No | `1` | Page number | ##### `get_league_game_days` All scheduled game days for a league session. | Parameter | Required | Default | Description | |---|---|---|---| | `session_id` | Yes | | League session ID (from `search_leagues`) | ##### `get_league_matches` All matches for a specific game day. | Parameter | Required | Default | Description | |---|---|---|---| | `match_date_id` | Yes | | Match date ID (from `get_league_game_days`) | --- #### Clubs ##### `get_club_detail` Club profile: uuid, name, logo URL, city, address, and counts of members, tournaments, and leagues. | Parameter | Required | Default | Description | |---|---|---|---| | `slug` | Yes | | Club URL slug | ##### `get_club_members` Paginated club member roster with full DUPR ratings and PPA stats (12 per page). | Parameter | Required | Default | Description | |---|---|---|---| | `slug` | Yes | | Club URL slug | | `member_search` | No | | Filter members by name | | `page` | No | `1` | Page number | ##### `get_club_tournaments` All tournaments affiliated with a club. | Parameter | Required | Default | Description | |---|---|---|---| | `org_uuid` | Yes | | Organization UUID (from `get_club_detail`) | | `keyword` | No | | Search keyword | ##### `get_club_leagues` All leagues affiliated with a club. | Parameter | Required | Default | Description | |---|---|---|---| | `org_uuid` | Yes | | Organization UUID (from `get_club_detail`) | | `keyword` | No | | Search keyword | --- ### Output Format Every action returns a dataset item in this envelope: ```json { "action": "search_players", "success": true, "data": { ... }, "error": null, "timestamp": "2026-06-24T10:30:00+00:00" } ```` On failure, `success` is `false`, `data` is `null`, and `error` contains the message. *** ### Typical Workflow ``` 1. search_players (search="johns") → get slugs 2. get_player_profile (slug="ben-johns") → full profile + match history 1. get_results_on_date (date="2026-01-15") → get matchup IDs 2. get_results_matchup (matchup_id="...") → full score breakdown 1. get_club_detail (slug="big-dill-pickle") → get org_uuid 2. get_club_members (slug="...") → member roster with DUPR 3. get_club_tournaments (org_uuid="...") → affiliated tournaments ``` # Actor input Schema ## `action` (type: `string`): Select the action to perform. ## `discipline` (type: `string`): REQUIRED for get\_rankings. Discipline code. ## `search` (type: `string`): OPTIONAL for search\_players. Filter by player last name. ## `age` (type: `string`): OPTIONAL for search\_players. Filter by age range. ## `gender` (type: `string`): OPTIONAL for search\_players. Filter by gender. ## `doubles_skill` (type: `string`): OPTIONAL for search\_players. Doubles skill range, e.g. '3.5-4.0'. Scale 0–8. ## `singles_skill` (type: `string`): OPTIONAL for search\_players. Singles skill range, e.g. '4.0-4.5'. Scale 0–8. ## `wpr_badge` (type: `string`): OPTIONAL for search\_players. Filter by World Pickleball Rating badge tier. ## `country_id` (type: `string`): OPTIONAL for search\_players. Country ID to filter by location. ## `state_id` (type: `string`): OPTIONAL for search\_players. State/province ID. ## `city` (type: `string`): OPTIONAL for search\_players. City name. ## `slug` (type: `string`): REQUIRED for get\_player\_profile, get\_tournament\_detail, get\_club\_detail, get\_club\_members, get\_club\_tournaments, get\_club\_leagues. URL slug identifier. ## `date` (type: `string`): REQUIRED for get\_results\_on\_date. Date in YYYY-MM-DD format. ## `matchup_id` (type: `string`): REQUIRED for get\_results\_matchup. Matchup identifier. ## `team_ids` (type: `string`): REQUIRED for get\_results\_h2h. Two team IDs separated by a comma, e.g. '123,456'. ## `match_id` (type: `string`): REQUIRED for get\_results\_tiebreaker. Match identifier. ## `game_number` (type: `integer`): REQUIRED for get\_results\_tiebreaker. Game number within the match. ## `keyword` (type: `string`): OPTIONAL for search\_tournaments, search\_leagues. Search keyword. ## `tournament_filter` (type: `string`): OPTIONAL for search\_tournaments. Tournament status filter. ## `league_status` (type: `string`): OPTIONAL for search\_leagues. League status filter. ## `session_id` (type: `string`): REQUIRED for get\_league\_game\_days, get\_league\_matches. League session identifier. ## `match_date_id` (type: `string`): REQUIRED for get\_league\_matches. Match date identifier. ## `org_uuid` (type: `string`): REQUIRED for get\_club\_tournaments, get\_club\_leagues. Club organization UUID (from get\_club\_detail). ## `member_search` (type: `string`): OPTIONAL for get\_club\_members. Filter club members by name. ## `page` (type: `integer`): OPTIONAL. Page number for paginated results (default: 1). ## Actor input object example ```json { "action": "search_players", "discipline": "WS", "game_number": 1, "tournament_filter": "featured", "league_status": "active", "page": 1 } ``` # Actor output Schema ## `results` (type: `string`): Pickleball data stored in the default dataset # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "action": "search_players", "discipline": "WS", "tournament_filter": "featured", "league_status": "active" }; // Run the Actor and wait for it to finish const run = await client.actor("fingolfin/pickleball-data-api").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "action": "search_players", "discipline": "WS", "tournament_filter": "featured", "league_status": "active", } # Run the Actor and wait for it to finish run = client.actor("fingolfin/pickleball-data-api").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "action": "search_players", "discipline": "WS", "tournament_filter": "featured", "league_status": "active" }' | apify call fingolfin/pickleball-data-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fingolfin/pickleball-data-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pickleball API", "description": "An enterprise-grade Apify Actor that delivers unified, real-time pickleball data from across the official pickleball ecosystem — players, rankings, results, tournaments, leagues, and clubs — through a single, consistent interface. RESTAPI https://rapidapi.com/matepapava123/api/pickleball-live-api", "version": "1.0", "x-build-id": "PTI6vm74YDgQ8EMbY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fingolfin~pickleball-data-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fingolfin-pickleball-data-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/fingolfin~pickleball-data-api/runs": { "post": { "operationId": "runs-sync-fingolfin-pickleball-data-api", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/fingolfin~pickleball-data-api/run-sync": { "post": { "operationId": "run-sync-fingolfin-pickleball-data-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "action" ], "properties": { "action": { "title": "Action", "enum": [ "get_rankings", "get_rankings_full", "search_players", "get_player_profile", "get_player_filters", "get_results_on_date", "get_results_matchup", "get_results_h2h", "get_results_tiebreaker", "search_tournaments", "get_tournament_detail", "search_leagues", "get_league_game_days", "get_league_matches", "get_club_detail", "get_club_members", "get_club_tournaments", "get_club_leagues" ], "type": "string", "description": "Select the action to perform." }, "discipline": { "title": "Discipline", "enum": [ "WS", "MS", "WD", "MD", "MX", "WX" ], "type": "string", "description": "REQUIRED for get_rankings. Discipline code." }, "search": { "title": "Search (Last Name)", "type": "string", "description": "OPTIONAL for search_players. Filter by player last name." }, "age": { "title": "Age Range", "enum": [ "", "0-17", "18-29", "30-39", "40-49", "50-59", "60-69", "70+" ], "type": "string", "description": "OPTIONAL for search_players. Filter by age range." }, "gender": { "title": "Gender", "enum": [ "", "M", "F" ], "type": "string", "description": "OPTIONAL for search_players. Filter by gender." }, "doubles_skill": { "title": "Doubles Skill (DUPR)", "type": "string", "description": "OPTIONAL for search_players. Doubles skill range, e.g. '3.5-4.0'. Scale 0–8." }, "singles_skill": { "title": "Singles Skill (DUPR)", "type": "string", "description": "OPTIONAL for search_players. Singles skill range, e.g. '4.0-4.5'. Scale 0–8." }, "wpr_badge": { "title": "WPR Badge", "enum": [ "", "TOUR PRO", "LEGEND", "ICON", "Top 1", "Top 5", "Top 10", "Top 25", "Top 50", "Top 100", "Top 200", "Top 500", "Top 1000" ], "type": "string", "description": "OPTIONAL for search_players. Filter by World Pickleball Rating badge tier." }, "country_id": { "title": "Country ID", "type": "string", "description": "OPTIONAL for search_players. Country ID to filter by location." }, "state_id": { "title": "State ID", "type": "string", "description": "OPTIONAL for search_players. State/province ID." }, "city": { "title": "City", "type": "string", "description": "OPTIONAL for search_players. City name." }, "slug": { "title": "Slug", "type": "string", "description": "REQUIRED for get_player_profile, get_tournament_detail, get_club_detail, get_club_members, get_club_tournaments, get_club_leagues. URL slug identifier." }, "date": { "title": "Date", "type": "string", "description": "REQUIRED for get_results_on_date. Date in YYYY-MM-DD format." }, "matchup_id": { "title": "Matchup ID", "type": "string", "description": "REQUIRED for get_results_matchup. Matchup identifier." }, "team_ids": { "title": "Team IDs (comma-separated)", "type": "string", "description": "REQUIRED for get_results_h2h. Two team IDs separated by a comma, e.g. '123,456'." }, "match_id": { "title": "Match ID", "type": "string", "description": "REQUIRED for get_results_tiebreaker. Match identifier." }, "game_number": { "title": "Game Number", "minimum": 1, "type": "integer", "description": "REQUIRED for get_results_tiebreaker. Game number within the match.", "default": 1 }, "keyword": { "title": "Keyword", "type": "string", "description": "OPTIONAL for search_tournaments, search_leagues. Search keyword." }, "tournament_filter": { "title": "Tournament Filter", "enum": [ "featured", "upcoming", "past", "all" ], "type": "string", "description": "OPTIONAL for search_tournaments. Tournament status filter." }, "league_status": { "title": "League Status", "enum": [ "active", "past", "all" ], "type": "string", "description": "OPTIONAL for search_leagues. League status filter." }, "session_id": { "title": "Session ID", "type": "string", "description": "REQUIRED for get_league_game_days, get_league_matches. League session identifier." }, "match_date_id": { "title": "Match Date ID", "type": "string", "description": "REQUIRED for get_league_matches. Match date identifier." }, "org_uuid": { "title": "Organization UUID", "type": "string", "description": "REQUIRED for get_club_tournaments, get_club_leagues. Club organization UUID (from get_club_detail)." }, "member_search": { "title": "Member Search", "type": "string", "description": "OPTIONAL for get_club_members. Filter club members by name." }, "page": { "title": "Page Number", "minimum": 1, "type": "integer", "description": "OPTIONAL. Page number for paginated results (default: 1).", "default": 1 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```