WNBA Stats Scraper

Collect structured public WNBA data from ESPN's public WNBA JSON API for sports analysts, dashboards, and AI workflows. The actor supports three modes:

• scoreboard: game events, scores, status, venue, and competitors
• teams: WNBA team directory and logos
• roster: players for a team, using an ESPN team abbreviation or ID

The default input collects the WNBA team directory so the prefill produces useful records year-round. For a historical scoreboard, pass date as YYYY-MM-DD and optionally season (for example, 2025). For roster mode, pass team such as NY or 20.

Pricing

Pay per event: $0.01 per structured record written to the dataset. No result means no result event is charged. Set a maximum run cost in Apify before starting a paid run.

Each dataset record includes recordType, source URL, source name, and scrape timestamp. Run diagnostics and no-match warnings are written to the SUMMARY key-value record. This actor uses public ESPN endpoints and does not bypass authentication, paywalls, or access controls.

What data does WNBA Stats Scraper return?

Field	Type	Description
recordType	string	Value returned as recordType.
eventId	string or null	Value returned as eventId.
teamId	string or null	Value returned as teamId.
athleteId	string or null	Value returned as athleteId.
displayName	string or null	Value returned as displayName.
teamName	string or null	Value returned as teamName.
abbreviation	string or null	Value returned as abbreviation.
name	string or null	Value returned as name.
date	string or null	Value returned as date.
season	integer or null	Value returned as season.
status	object or null	Value returned as status.
competitors	array	Value returned as competitors.
stats	object or null	Value returned as stats.
source	string	Value returned as source.
sourceUrl	string	Value returned as sourceUrl.
scrapedAt	string	Value returned as scrapedAt.

Use cases

• Supply structured public data to AI, RAG, enrichment, or evaluation workflows.
• Add a repeatable structured-data step to applications, agents, and automation pipelines.
• Run a one-off research job and export the structured result as JSON, CSV, Excel, XML, or RSS from Apify.
• Schedule the same input to monitor changes over time and send completed datasets to a webhook or integration.
• Feed schema-shaped records into a database, spreadsheet, BI tool, or AI workflow with the source URL retained for verification.

Input

Field	Type	Description
mode	string	Choose scoreboard games, the team directory, or a team roster. The default team directory returns records reliably even when there are no games today.
date	string	Optional scoreboard date in YYYY-MM-DD or YYYYMMDD format. Leave blank for the current scoreboard.
season	integer	Optional season year for scoreboard requests, for example 2025.
team	string	Required only for roster mode. Use an ESPN team abbreviation or ID, such as NY or 20.
maxResults	integer	Maximum number of records to write. Defaults to 100.

Input example

{
  "mode": "teams",
  "maxResults": 100
}

Output example

{
  "recordType": "Example recordType",
  "eventId": "Example eventId",
  "teamId": "Example teamId",
  "athleteId": "Example athleteId",
  "displayName": "Example displayName",
  "teamName": "Example teamName",
  "abbreviation": "Example abbreviation",
  "name": "Example name",
  "date": "Example date",
  "season": 1,
  "status": {},
  "competitors": []
}

The exact fields depend on the selected input and what the public source exposes. Use the dataset schema as the machine-readable contract and retain source URLs for verification.

Run WNBA Stats Scraper with the Apify API

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/wnba-stats-scraper').call({
  "mode": "teams",
  "maxResults": 100
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

You can also run the Actor from Apify Console, schedules, webhooks, the REST API, Make, Zapier, n8n, or the hosted Apify MCP server.

Responsible use

Use this Actor only for data you are authorized to access. Follow the target website's terms, robots and access policies, and applicable privacy, database, copyright, anti-spam, and data-protection laws. Do not use it to bypass authentication or other access controls, collect private data, harass people, or make high-impact decisions without independent verification.

Frequently asked questions

Can I schedule WNBA Stats Scraper?

Yes. Use an Apify schedule to run the same saved input at a chosen interval, then connect a webhook or integration to process the dataset when the run finishes.

How should I test a new input?

Begin with the prefilled example or a small limit. Confirm that the output fields, source coverage, runtime, and live charges match your workflow before increasing the scope.

How do I export the results?

Open the run's default dataset in Apify Console and export JSON, CSV, Excel, XML, or RSS. Applications can retrieve the same records through the Apify API client or REST dataset endpoint.

Can an AI agent call this Actor?

Yes. Add muhammadafzal/wnba-stats-scraper through the hosted Apify MCP server or call it through the API. The Actor's input and dataset schemas help agents construct valid requests and interpret returned records.