TeamRankings Scraper - Ratings, Stats & Odds
Pricing
Pay per event
Power ratings, 1,300+ team and player stat leaderboards, betting odds, projections and situational trends for NFL, NBA, MLB, WNBA and college sports.
Pricing
Pay per event
Rating
0.0
(0)
Developer
ParseForge
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
2 days ago
Last modified
Categories
Share
You can access the TeamRankings Scraper - Ratings, Stats & Odds programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "xhvRi8n46Eogt0o9B" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~teamrankings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-teamrankings-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/parseforge~teamrankings-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-teamrankings-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/parseforge~teamrankings-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-teamrankings-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", "required": [ "sport", "dataset" ], "properties": { "sport": { "title": "League", "enum": [ "nfl", "nba", "mlb", "wnba", "ncb", "ncf" ], "type": "string", "description": "Which league to scrape. TeamRankings publishes NFL, NBA, MLB, WNBA, NCAA basketball and NCAA football. There is no NHL section — teamrankings.com/nhl/ redirects to the home page.", "default": "nfl" }, "dataset": { "title": "Dataset", "enum": [ "rankings", "team-stats", "player-stats", "odds", "schedule", "standings", "projections", "trends", "team-profiles", "odds-history", "odds-movement" ], "type": "string", "description": "Which surface to pull. Each dataset bills its own per-row event, so you only pay for the one you ask for. Rankings and team stats accept a historical date; odds and schedule accept the matchup enrichment blocks below.", "default": "rankings" }, "slugs": { "title": "Specific pages", "type": "array", "description": "Page slugs to pull for rankings / team stats / player stats, e.g. \"predictive-by-other\" or \"points-per-game\". Leave empty to take every page the league publishes, up to Max pages. A slug that does not exist is reported in the log rather than failing the run.", "items": { "type": "string" } }, "categories": { "title": "Stat categories", "type": "array", "description": "Alternative to Specific pages: take every stat in these categories. NFL/NCF use \"Scoring Offense\", \"Rushing Defense\", \"Turnovers\"… NBA/WNBA/NCB use \"Scoring\", \"Shooting\", \"Rebounding\"… MLB uses \"Team Batting\", \"Team Pitching\"… Ignored when Specific pages is set. Rankings have no categories.", "items": { "type": "string" } }, "date": { "title": "Historical snapshot date", "type": "string", "description": "YYYY-MM-DD. Rankings and team stats are rebuilt as they stood on that date — TeamRankings keeps daily snapshots going back years. Leave empty for today." }, "scheduleView": { "title": "Schedule view", "enum": [ "daily", "season" ], "type": "string", "description": "Daily returns today's slate with the site's hotness score; Season returns the full published schedule (2,430 games for MLB, 272 for NFL).", "default": "daily" }, "projectionView": { "title": "Projection view", "enum": [ "standings", "postseason-seeds" ], "type": "string", "description": "Projected standings gives projected win totals plus playoff, division, top-seed and title odds. Postseason seeds gives per-seed probabilities and is published for MLB only.", "default": "standings" }, "trendTypes": { "title": "Trend types", "type": "array", "description": "Which trend tables to pull: straight-up win records, against-the-spread records, or over/under records.", "items": { "type": "string", "enum": [ "win", "ats", "ou" ], "enumTitles": [ "Win trends", "Against the spread", "Over / under" ] }, "default": [ "win" ] }, "trendSituations": { "title": "Trend situations", "type": "array", "description": "Situational split for each trend table. Every combination of type x situation is one page, so 3 types x 5 situations is 15 pages.", "items": { "type": "string", "enum": [ "all_games", "is_after_win", "is_after_loss", "is_home", "is_away", "is_neutral", "is_fav", "is_dog", "is_home_fav", "is_home_dog", "is_away_fav", "is_away_dog", "no_rest", "one_day_off", "two_three_days_off", "four_plus_days_off", "is_doubleheader", "rest_advantage", "rest_disadvantage", "equal_rest", "is_league", "non_league", "is_division", "non_division", "is_regular_season", "is_playoff" ], "enumTitles": [ "All games", "After a win", "After a loss", "As home team", "As away team", "At neutral site", "As favorite", "As underdog", "As home favorite", "As home underdog", "As away favorite", "As away underdog", "No rest", "1 day off", "2-3 days off", "4+ days off", "Second game of doubleheader", "With rest advantage", "With rest disadvantage", "With equal rest", "League games", "Non-league games", "Division games", "Non-division games", "Regular season games", "Playoff games" ] }, "default": [ "all_games" ] }, "trendSeason": { "title": "Trend season", "type": "string", "description": "Four-digit season for the trends dataset, e.g. 2019. TeamRankings keeps trends back to 2007. Leave empty for the current season." }, "oddsHistoryView": { "title": "Odds history view", "enum": [ "results", "win", "spread", "over-under", "spread-and-over-under" ], "type": "string", "description": "Which historical study to pull. Not published for MLB.", "default": "results" }, "oddsMovementView": { "title": "Odds movement view", "enum": [ "ats-results", "ats-opening", "ats-movement", "ou-results", "ou-opening", "ou-movement" ], "type": "string", "description": "Which line-movement study to pull. Not published for MLB.", "default": "ats-movement" }, "teams": { "title": "Teams", "type": "array", "description": "Keep only rows whose team name or slug contains one of these, case-insensitive. Matches either side of a game for the odds and schedule datasets.", "items": { "type": "string" } }, "minRank": { "title": "Min rank", "minimum": 1, "type": "integer", "description": "Keep only rows ranked at or below this number (1 is best)." }, "maxRank": { "title": "Max rank", "minimum": 1, "type": "integer", "description": "Keep only rows ranked at or above this number. Set 10 to keep the top ten." }, "minValue": { "title": "Min value", "type": "number", "description": "Keep rows whose headline value (the stat value, or the rating on rankings) is at least this. Decimals are supported." }, "maxValue": { "title": "Max value", "type": "number", "description": "Keep rows whose headline value is at most this. Decimals are supported." }, "search": { "title": "Free-text search", "type": "string", "description": "Keep only rows containing this text anywhere, case-insensitive. Useful for a player name or a venue." }, "includeLineMovement": { "title": "Line movement", "type": "boolean", "description": "For odds and schedule rows: open / high / low / current for the spread, money line and total, plus the per-book history table. Three extra requests per game. Billed as line-movement.", "default": false }, "includePowerRatings": { "title": "Matchup power ratings", "type": "boolean", "description": "Both teams' eleven power ratings side by side with their league ranks and the resulting edge. One extra request per game. Billed as matchup-power-ratings.", "default": false }, "includeHeadToHead": { "title": "Head to head history", "type": "boolean", "description": "Every prior meeting since 2007 with score, who covered and the over/under result. One extra request per game. Billed as head-to-head.", "default": false }, "includeInjuries": { "title": "Injury report", "type": "boolean", "description": "Player, position, injury, status and the written detail for both teams. One extra request per game. Not billed when both teams report no injuries. Billed as injury-report.", "default": false }, "includeMatchupTrends": { "title": "Matchup trends", "type": "boolean", "description": "The situational records TeamRankings shows on the matchup trends tab. One extra request per game. Billed as matchup-trends.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Hard cap on rows written, and therefore on what the run can bill. Leave empty for no cap." }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on how many leaf pages a run fetches (stat pages, ranking pages, trend combinations, team pages). Guards against asking for all 226 NFL stat pages by accident.", "default": 40 }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel requests. 5 is safe for any run — a full 226-page sweep completed on Apify with no throttling. TeamRankings can throttle a single IP that sweeps repeatedly; the run waits that out rather than dropping pages.", "default": 5 }, "timeoutSecs": { "title": "Time budget (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Stop issuing requests after this long and flush what has been collected. The run also respects the platform timeout when that is nearer.", "default": 1500 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional and off by default, and normally unnecessary: a full 226-page NFL stat sweep ran clean from an Apify container without one. Turn it on if you sweep a whole league repeatedly from the same IP, which can trip a multi-minute HTTP 403.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for TeamRankings Scraper - Ratings, Stats & Odds from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: