{ "openapi": "3.0.1", "info": { "title": "NFL Scores, Standings, Teams & Rosters Scraper", "description": "Scrape NFL game scores by week or date, conference and division standings, all 32 teams and full rosters. Get matchups, scores, records, ties, streaks, seeds, odds, box scores and player bios. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "47IMUQdiEtmNKPjUQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~nfl-scores-standings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-nfl-scores-standings-scraper", "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/scrapers_lat~nfl-scores-standings-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-nfl-scores-standings-scraper", "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/scrapers_lat~nfl-scores-standings-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-nfl-scores-standings-scraper", "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", "properties": { "mode": { "title": "What to scrape", "enum": [ "scores", "standings", "teams", "roster" ], "type": "string", "description": "Choose the kind of NFL data to collect: game scores for a week or date, the league standings, the list of teams, or a team's roster.", "default": "standings" }, "season": { "title": "Season (year)", "minimum": 1920, "maximum": 2100, "type": "integer", "description": "Scores mode. NFL season year (for example 2025 for the 2025 season). Combine with Week and Season type to select a slate. Standings and teams reflect the current season by default." }, "week": { "title": "Week (scores mode)", "minimum": 1, "maximum": 25, "type": "integer", "description": "Scores mode. Week number within the chosen season type (1 to 18 for the regular season). Combine with Season and Season type." }, "seasonType": { "title": "Season type (scores mode)", "enum": [ "pre", "reg", "post" ], "type": "string", "description": "Scores mode. Which part of the season to pull: preseason, regular season or postseason." }, "date": { "title": "Date (scores mode)", "type": "string", "description": "Scores mode only. A single day in YYYY-MM-DD format (for example 2025-09-07). Overrides Season/Week. Leave empty to use Season + Week, or return the current slate." }, "teamAbbrev": { "title": "Team abbreviation (roster mode)", "type": "string", "description": "Roster mode only. Team abbreviation such as KC, PHI, DAL, BUF, SF. Used to select which team's players to return." }, "teamId": { "title": "Team ID (roster mode)", "type": "string", "description": "Roster mode only. Numeric team ID (alternative to Team abbreviation). If both are set, Team ID wins." }, "includeBoxScore": { "title": "Include box score (scores mode add-on)", "type": "boolean", "description": "Scores mode only, paid plans only. Fetch the full team box score for each game (total yards, passing, rushing, first downs, third-down efficiency, turnovers, possession) plus per-side passing/rushing/receiving leaders. Billed per game only when a real box score is returned.", "default": false }, "aiMatchupSummary": { "title": "AI matchup summary (scores mode add-on)", "type": "boolean", "description": "Scores mode only, paid plans only. Add an AI-written storyline, key players and prediction for each game. Billed per game only when usable AI output is produced.", "default": false }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of records to collect (games, standings rows, teams or players). Free Apify plans are capped at 10 per run." } } }, "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 } } } } } } } } } }