NCAA Stats & Scores: Leaderboards, Polls & Standings: MCP config, n8n workflow and API

{
  "mode": "teamStats",
  "sport": "basketball-men",
  "division": "d1",
  "statCategory": "Scoring Offense",
  "season": "current",
  "pollSlug": "di-mens-basketball-associated-press",
  "conference": "all",
  "finalOnly": false,
  "includeGameDetails": false,
  "includeBoxscore": false,
  "includePlayByPlay": false,
  "maxItems": 3
}

---
name: ncaa-team-and-player-leaderboards-polls
description: "Official NCAA.com stats and scores: team and player leaderboards, ranking polls, conference standings, school directory entries, schedules/scores, full team season schedules, championship / March Madness bracket games, game details (venue, linescores, box score, play-by-play), championship history, and the listOptions capability catalog. Runs the Apify Actor nimbryxo-studio/ncaa-team-and-player-leaderboards-polls. Use when the user needs NCAA Stats data with fields such as recordType, optionType, value, title, rank, team and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "nimbryxo-studio/ncaa-team-and-player-leaderboards-polls"
  store-url: "https://apify.com/nimbryxo-studio/ncaa-team-and-player-leaderboards-polls"
---

# NCAA Stats & Scores: Leaderboards, Polls & Standings

Use this skill to fetch NCAA Stats data with the Apify Actor `nimbryxo-studio/ncaa-team-and-player-leaderboards-polls` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | string, required | What to scrape from NCAA.com. `listOptions` returns the valid modes, sports, divisions, categories, polls, and conferences from the built-in catalog (optionally scoped with `sport`/`division`) without making any NCAA.com requests. |
| `sport` | string | NCAA sport to scrape. Required for the sport-specific modes; ignored by `mode=teams` and `mode=gameDetail`; optional scope for `mode=listOptions`. |
| `division` | one of `d1`, `d2`, `d3`, `fbs`, `fcs`, `nc` | NCAA competition division. Football uses FBS/FCS; men's volleyball and women's ice hockey use `nc` (National Collegiate) for polls and history. The actor maps women's ice hockey `nc` schedules to NCAA.com's d1 scoreboard page. |
| `statCategory` | string | (mode=teamStats or individualStats) The statistic to rank by. Every NCAA.com category is listed; the valid set depends on the chosen sport and mode. |
| `season` | string | (mode=teamStats, individualStats, teamSchedule, or brackets) Season/year. `Current season` follows whichever season NCAA.com is actively showing. |
| `pollSlug` | string | (mode=rankings) Which NCAA-hosted poll to scrape. The valid set depends on the chosen sport and division. |
| `gameIds` | array | (mode=gameDetail) NCAA game IDs or game-page URLs, e.g. `6649632` or `https://www.ncaa.com/game/6649632`. |
| `conference` | string | (mode=standings or schedules) Optional conference filter. Standings are fetched from the chosen conference's own page; schedules keep games involving a team from that conference. Not every conference is offered for every sport. |
| `finalOnly` | boolean | (mode=schedules) Keep only games whose status is final. Records without a final status are excluded. |
| `includeGameDetails` | boolean | (mode=schedules or teamSchedule) Add venue, city/state, linescores, records, and hasBoxscore/hasPbp to each game. Adds one game-page request plus one game-detail request per record. |
| `includeBoxscore` | boolean | (mode=gameDetail) Include team and player box-score blocks when NCAA.com publishes them. |
| `includePlayByPlay` | boolean | (mode=gameDetail) Include the play-by-play timeline when NCAA.com publishes it. This can make each record large. |
| `maxItems` | integer | Hard cap on the number of records emitted in this run, 1-5,000. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "teamStats",
  "sport": "basketball-men",
  "division": "d1",
  "statCategory": "Scoring Offense",
  "season": "current",
  "pollSlug": "di-mens-basketball-associated-press",
  "conference": "all",
  "finalOnly": false,
  "includeGameDetails": false,
  "includeBoxscore": false,
  "includePlayByPlay": false,
  "maxItems": 3
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~ncaa-team-and-player-leaderboards-polls/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/nimbryxo-studio~ncaa-team-and-player-leaderboards-polls/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `recordType`, `optionType`, `value`, `title`, `rank`, `team`, `playerName`, `school`, `conference`, `statCategory`, `statValue`, `statLabel`, `season`, `seasonLabel`, `seasonYear`, `date`, `homeTeam`, `awayTeam`, `pollSlug`, `requestedPoll`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.