{"id":19635489,"url":"https://github.com/henrygd/ncaa-api","last_synced_at":"2025-04-06T13:08:58.934Z","repository":{"id":219616330,"uuid":"749471129","full_name":"henrygd/ncaa-api","owner":"henrygd","description":"Free API to retrieve live scores, stats, standings, and other college sports data from ncaa.com","archived":false,"fork":false,"pushed_at":"2025-01-16T00:46:53.000Z","size":54,"stargazers_count":119,"open_issues_count":2,"forks_count":20,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-03-30T12:06:40.791Z","etag":null,"topics":["api","college-basketball","college-football","ncaa"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/henrygd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-28T17:21:25.000Z","updated_at":"2025-03-28T13:55:14.000Z","dependencies_parsed_at":"2024-06-29T02:43:14.148Z","dependency_job_id":"9aeaab68-7712-4ae9-852d-cefb1b33d13b","html_url":"https://github.com/henrygd/ncaa-api","commit_stats":null,"previous_names":["henrygd/ncaa-api"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henrygd%2Fncaa-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henrygd%2Fncaa-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henrygd%2Fncaa-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/henrygd%2Fncaa-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/henrygd","download_url":"https://codeload.github.com/henrygd/ncaa-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247485287,"owners_count":20946398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","college-basketball","college-football","ncaa"],"created_at":"2024-11-11T12:25:33.771Z","updated_at":"2025-04-06T13:08:58.906Z","avatar_url":"https://github.com/henrygd.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NCAA API\n\nFree API to return consumable data from ncaa.com.\n\nWorks with scores, stats, rankings, standings, schedules, history, and game details (box score, play by play, scoring summary, team stats).\n\n## Usage\n\nMake a GET request using the same path as the URL on ncaa.com. You'll get a JSON response with the data.\n\nYou can test using the demo API below. [Host your own](#deployment) if you need it to be reliable long term.\n\nhttps://ncaa-api.henrygd.me/rankings/football/fbs/associated-press\n\n\u003e Note: The public API is limited to 5 requests per second per IP.\n\n## Parameters\n\nThe following URL parameters are supported:\n\n| Parameter | Description                 |\n| --------- | --------------------------- |\n| `page`    | Page number. Defaults to 1. |\n\n## Routes\n\n### Scores\n\nFetches live scores for a given sport, division, and date.\n\nWebsite: https://www.ncaa.com/scoreboard/football/fbs/2023/13/all-conf\n\n`GET /scoreboard/football/fbs/2023/13/all-conf`\n\n```json\n{\n  \"inputMD5Sum\": \"946b0d7ecce3877d6cd036a19daf95ed\",\n  \"instanceId\": \"52aa051f77b7475da1baba2df45d5e98\",\n  \"updated_at\": \"01-19-2024 23:50:30\",\n  \"hideRank\": false,\n  \"games\": [\n    {\n      \"game\": {\n        \"away\": {\n          \"score\": \"24\",\n          \"names\": {\n            \"char6\": \"OHIOST\",\n            \"short\": \"Ohio St.\",\n            \"seo\": \"ohio-st\",\n            \"full\": \"The Ohio State University\"\n          },\n          \"winner\": false,\n          \"seed\": \"\",\n          \"description\": \"(11-1)\",\n          \"rank\": \"2\",\n          \"conferences\": [\n            {\n              \"conferenceName\": \"Big Ten\",\n              \"conferenceSeo\": \"big-ten\"\n            },\n            {\n              \"conferenceName\": \"Top 25\",\n              \"conferenceSeo\": \"top-25\"\n            }\n          ]\n        },\n        \"home\": {\n          \"score\": \"30\",\n          \"names\": {\n            \"char6\": \"MICH\",\n            \"short\": \"Michigan\",\n            \"seo\": \"michigan\",\n            \"full\": \"University of Michigan\"\n          },\n          \"winner\": true,\n          \"seed\": \"\",\n          \"description\": \"(12-0)\",\n          \"rank\": \"3\",\n          \"conferences\": [\n            {\n              \"conferenceName\": \"Big Ten\",\n              \"conferenceSeo\": \"big-ten\"\n            },\n            {\n              \"conferenceName\": \"Top 25\",\n              \"conferenceSeo\": \"top-25\"\n            }\n          ]\n        },\n        \"gameID\": \"3146430\",\n        \"finalMessage\": \"FINAL\",\n        \"bracketRound\": \"\",\n        \"title\": \"Michigan Ohio St.\",\n        \"contestName\": \"\",\n        \"url\": \"/game/6154104\",\n        \"network\": \"\",\n        \"liveVideoEnabled\": false,\n        \"startTime\": \"12:00PM ET\",\n        \"startTimeEpoch\": \"1700931600\",\n        \"bracketId\": \"\",\n        \"gameState\": \"final\",\n        \"startDate\": \"11-25-2023\",\n        \"currentPeriod\": \"FINAL\",\n        \"videoState\": \"\",\n        \"bracketRegion\": \"\",\n        \"contestClock\": \"0:00\"\n      }\n    },\n    ...\n  ]\n}\n```\n\n### Stats\n\nWebsite: https://www.ncaa.com/stats/football/fbs/current/team/28\n\n`GET /stats/football/fbs/current/team/28`\n\n```json\n{\n  \"sport\": \"Football\",\n  \"title\": \"Scoring Defense\",\n  \"updated\": \"Monday, January 08, 2024 11:52 pm - Through games Monday, January 08, 2024\",\n  \"page\": 1,\n  \"pages\": 3,\n  \"data\": [\n    {\n      \"Rank\": \"1\",\n      \"Team\": \"Michigan\",\n      \"G\": \"15\",\n      \"TDs\": \"17\",\n      \"Opp XP\": \"15\",\n      \"2PT\": \"0\",\n      \"Opp DXP\": \"0\",\n      \"Opp FGM\": \"13\",\n      \"Opp Saf\": \"0\",\n      \"Pts\": \"156.00\",\n      \"Avg\": \"10.40\"\n    },\n    {\n      \"Rank\": \"2\",\n      \"Team\": \"Ohio St.\",\n      \"G\": \"13\",\n      \"TDs\": \"15\",\n      \"Opp XP\": \"14\",\n      \"2PT\": \"0\",\n      \"Opp DXP\": \"0\",\n      \"Opp FGM\": \"14\",\n      \"Opp Saf\": \"0\",\n      \"Pts\": \"146.00\",\n      \"Avg\": \"11.23\"\n    },\n    ...\n  ]\n}\n```\n\nWebsite: https://www.ncaa.com/stats/football/fbs/current/individual/750\n\n`GET /stats/football/fbs/current/individual/750`\n\n```json\n{\n  \"sport\": \"Football\",\n  \"title\": \"Rushing TDs\",\n  \"updated\": \"Monday, January 08, 2024 11:52 pm - Through games Monday, January 08, 2024\",\n  \"page\": 1,\n  \"pages\": 6,\n  \"data\": [\n    {\n      \"Rank\": \"1\",\n      \"Name\": \"Blake Corum\",\n      \"Team\": \"Michigan\",\n      \"Cl\": \"Sr.\",\n      \"Position\": \"RB\",\n      \"G\": \"15\",\n      \"Rush TD\": \"27\"\n    },\n    {\n      \"Rank\": \"2\",\n      \"Name\": \"Ollie Gordon\",\n      \"Team\": \"Oklahoma St.\",\n      \"Cl\": \"So.\",\n      \"Position\": \"RB\",\n      \"G\": \"14\",\n      \"Rush TD\": \"21\"\n    },\n    ...\n  ]\n}\n```\n\n### Rankings\n\nWebsite: https://www.ncaa.com/rankings/football/fbs/associated-press\n\n`GET /rankings/football/fbs/associated-press`\n\n```json\n{\n  \"sport\": \"Football\",\n  \"title\": \"College football rankings: Associated Press Top 25\",\n  \"updated\": \"Through Games JAN. 8, 2024\",\n  \"page\": 1,\n  \"pages\": 1,\n  \"data\": [\n    {\n      \"RANK\": \"1\",\n      \"SCHOOL\": \"Michigan (61)\",\n      \"POINTS\": \"1525 \",\n      \"PREVIOUS\": \"1\",\n      \"RECORD\": \"15-0\"\n    },\n    {\n      \"RANK\": \"2\",\n      \"SCHOOL\": \"Washington\",\n      \"POINTS\": \"1459\",\n      \"PREVIOUS\": \"2\",\n      \"RECORD\": \"14-1\"\n    },\n    ...\n  ]\n}\n```\n\n### Standings\n\nWebsite: https://www.ncaa.com/standings/basketball-women/d1\n\n`GET /standings/basketball-women/d1`\n\n```json\n{\n  \"sport\": \"Women's Basketball\",\n  \"title\": \"ALL CONFERENCES\",\n  \"updated\": \"Feb 03, 2024 05:08 AM EDT\",\n  \"page\": 1,\n  \"pages\": 1,\n  \"data\": [\n    {\n      \"conference\": \"ASUN\",\n      \"standings\": [\n        {\n          \"School\": \"FGCU\",\n          \"Conference W\": \"9\",\n          \"Conference L\": \"0\",\n          \"Conference PCT\": \"1.000\",\n          \"Overall W\": \"19\",\n          \"Overall L\": \"4\",\n          \"Overall PCT\": \"0.826\",\n          \"Overall STREAK\": \"Won 12\"\n        },\n        {\n          \"School\": \"Central Ark.\",\n          \"Conference W\": \"7\",\n          \"Conference L\": \"1\",\n          \"Conference PCT\": \"0.875\",\n          \"Overall W\": \"15\",\n          \"Overall L\": \"6\",\n          \"Overall PCT\": \"0.714\",\n          \"Overall STREAK\": \"Won 4\"\n        },\n        ...\n      ]\n    },\n    ...\n  ]\n}\n```\n\n### History\n\nWebsite: https://www.ncaa.com/history/bowling/nc\n\n`GET /history/bowling/nc`\n\n```json\n{\n  \"sport\": \"Bowling\",\n  \"title\": \"Championship History\",\n  \"updated\": \"\",\n  \"page\": 1,\n  \"pages\": 1,\n  \"data\": [\n    {\n      \"Year\": \"2023\",\n      \"Champion\": \"Vanderbilt\",\n      \"Coach\": \"John Williamson\",\n      \"Games\": \"3\",\n      \"Runner-Up\": \"Arkansas State\",\n      \"Host/Site\": \"Las Vegas, NV\"\n    },\n    {\n      \"Year\": \"2022\",\n      \"Champion\": \"McKendree\",\n      \"Coach\": \"Shannon O'Keefe\",\n      \"Games\": \"0\",\n      \"Runner-Up\": \"Stephen F. Austin\",\n      \"Host/Site\": \"Columbus, OH\"\n    },\n    ...\n  ]\n}\n```\n\n### Schedule\n\nReturns game dates for a given sport, division, and date range.\n\nThis is the only route that doesn't exactly match a website URL. The website doesn't have schedule pages, but the sport and division are consistent with other URLs.\n\nIt also requires different dates for different sports. Football uses YYYY, while basketball, hockey, and others use YYYY/MM.\n\n`GET /schedule/basketball-men/d1/2023/02`\n\n```json\n{\n  \"division\": \"d1\",\n  \"inputMD5Sum\": \"ba47f9e21af54d3d4b5f81fc38048e29\",\n  \"month\": \"02\",\n  \"conference_name\": \"all-conf\",\n  \"created_at\": \"08-07-2023 15:32:05\",\n  \"season\": \"2022\",\n  \"sport\": \"MBB\",\n  \"gameDates\": [\n    {\n      \"contest_date\": \"02-01-2023\",\n      \"year\": \"2023\",\n      \"weekday\": \"Wed\",\n      \"games\": 47,\n      \"season\": \"2022\",\n      \"day\": \"01\"\n    },\n    {\n      \"contest_date\": \"02-02-2023\",\n      \"year\": \"2023\",\n      \"weekday\": \"Thu\",\n      \"games\": 75,\n      \"season\": \"2022\",\n      \"day\": \"02\"\n    },\n    ...\n  ]\n}\n```\n\n### Game\n\nProvides details of a single game.\n\nWebsite: https://www.ncaa.com/game/6305900\n\n- `GET /game/6305900` returns general information\n- `GET /game/6305900/boxscore` returns box score\n- `GET /game/6305900/play-by-play` returns play by play\n- `GET /game/6305900/scoring-summary` returns scoring summary if available\n- `GET /game/6305900/team-stats` returns team stats if available\n\n### Schools Index\n\nReturns a list of all schools.\n\nWebsite: https://www.ncaa.com/schools-index\n\n`GET /schools-index`\n\n## Deployment\n\nUse the included [docker-compose.yml](/docker-compose.yml) or run directly with docker:\n\n```bash\ndocker run --rm -p 3000:3000 henrygd/ncaa-api\n```\n\nThe app should be available at [http://localhost:3000](http://localhost:3000/history/bowling/nc).\n\n## Limiting Access\n\nIf you host your own instance, you may specify a custom header value to be present in all requests as a way to restrict access to the API. This isn't the most secure method, but it's better than nothing.\n\nTo do this, set the `NCAA_HEADER_KEY` environment variable to the desired value and include the header `x-ncaa-key` in your requests. See the [docker-compose.yml](/docker-compose.yml) for an example.\n\n## Development\n\nThis is a minimal [ElysiaJS](https://elysiajs.com/) app. To start the development server run:\n\n```bash\nbun run dev\n```\n\nTo run tests:\n\n```bash\nbun test\n```\n\nContributions welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhenrygd%2Fncaa-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhenrygd%2Fncaa-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhenrygd%2Fncaa-api/lists"}