{ "openapi": "3.0.1", "info": { "title": "NCAA College Sports Schedules & Scores API", "description": "Export official NCAA schedules and game results by sport, division, and date with teams, scores, state, and source URLs.", "version": "0.1", "x-build-id": "637UBfzDUGtrwUUKr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~ncaa-college-sports-data-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-ncaa-college-sports-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/automation-lab~ncaa-college-sports-data-api/runs": { "post": { "operationId": "runs-sync-automation-lab-ncaa-college-sports-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/automation-lab~ncaa-college-sports-data-api/run-sync": { "post": { "operationId": "run-sync-automation-lab-ncaa-college-sports-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": [ "sport", "division" ], "properties": { "sport": { "title": "Sport", "enum": [ "football", "basketball-men", "basketball-women", "baseball", "softball", "soccer-men", "soccer-women", "fieldhockey", "volleyball-women", "volleyball-men", "icehockey-men", "icehockey-women", "lacrosse-men", "lacrosse-women", "waterpolo-men", "waterpolo-women", "beach-volleyball" ], "type": "string", "description": "NCAA scoreboard sport slug.", "default": "football" }, "division": { "title": "Division or subdivision", "enum": [ "fbs", "fcs", "d1", "d2", "d3" ], "type": "string", "description": "Use fbs or fcs for Division I football; use d1, d2, or d3 for other supported combinations. The Actor rejects combinations NCAA does not expose.", "default": "fbs" }, "dateMode": { "title": "Date selection", "enum": [ "explicit", "today", "yesterday" ], "type": "string", "description": "Use Explicit dates to export the start/end dates below. Use Today (UTC) or Yesterday (UTC) for scheduled runs: the Actor resolves one UTC calendar day when the run starts, fetches only that day, and ignores Start date and End date. UTC can differ from the local US date for late-evening games, so Yesterday (UTC) is the safer choice for completed results.", "default": "explicit" }, "startDate": { "title": "Start date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "First scoreboard date to export, in YYYY-MM-DD format, when Date selection is Explicit dates. Ignored for Today and Yesterday. Defaults to 2025-09-06 when omitted. Historical and scheduled dates are supported when NCAA exposes them.", "default": "2025-09-06" }, "endDate": { "title": "End date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional inclusive end date in YYYY-MM-DD format, used only with Explicit dates. Defaults to Start date. Ranges are limited to 31 days. Ignored for Today and Yesterday." }, "status": { "title": "Game state", "enum": [ "all", "scheduled", "live", "final" ], "type": "string", "description": "Return all games or only scheduled, live, or completed games.", "default": "all" }, "school": { "title": "School filter", "minLength": 1, "maxLength": 100, "type": "string", "description": "Optional case-insensitive substring matched against either team's NCAA short name or URL slug, for example Iowa St. or ohio-st. Leading/trailing spaces are ignored. Note that Iowa also matches Iowa St." }, "maxItems": { "title": "Maximum games", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of game records saved and charged across the whole run, after state/school filters and de-duplication. The run stops requesting further dates once this limit is reached.", "default": 100 }, "maxRequestRetries": { "title": "Request retries", "minimum": 0, "maximum": 4, "type": "integer", "description": "Retries per scoreboard date for network errors, timeouts, HTTP 429, and HTTP 5xx responses. Rejected requests (other HTTP 4xx), non-JSON responses, GraphQL errors, and missing scoreboard data fail immediately because retrying cannot fix them.", "default": 2 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }