# The Odds API Sports Scraper (`parseforge/the-odds-api-sports-scraper`) Actor
Enumerate sports available on The Odds API with sport\_key, sport\_title, group, active, has\_outrights, and description. Filter by group like Soccer or American Football, or toggle active only. Useful for building odds dashboards, line shopping tools, and betting analytics pipelines.
- **URL**: https://apify.com/parseforge/the-odds-api-sports-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Automation, Integrations
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $7.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## ๐๏ธ The Odds API Sports List Scraper
> ๐ **Export every sport league supported by The Odds API in seconds, including sport_key, group, active status, outrights availability and description, straight from the public api.the-odds-api.com endpoint.**
> ๐ **Last updated:** 2026-05-29 ยท **๐ 8 fields** per record ยท 70+ leagues worldwide ยท Pre-match and outrights
The Odds API Sports Scraper pulls the canonical sports/leagues list from The Odds API. This is the lookup table that all other Odds API endpoints (events, odds, scores) reference, so it is the right starting point for any sports betting data pipeline.
| ๐ฏ Target Audience | ๐ก Primary Use Cases |
|---|---|
| ๐ฒ Sports betting analysts | Discover supported leagues |
| ๐ Sports media | Build coverage matrices |
| ๐ข Sportsbooks | Map internal IDs to Odds API keys |
| ๐ค ML researchers | Bootstrap data pipelines |
| ๐ฐ Sports journalists | Reference table for stories |
| ๐ฉโ๐ป Developers | Mirror the sports catalog |
### ๐ What The Odds API Sports List Scraper does
- Calls `https://api.the-odds-api.com/v4/sports`.
- Optionally filters by group (Soccer, American Football, Tennis, etc.) and active-only.
- Exports as CSV, Excel, JSON, JSONL, XML, RSS, or HTML.
> ๐ก **Why it matters:** Before you can pull odds you need the sport_key. This actor gives you the full lookup table in one click.
### ๐ฌ Full Demo
_๐ง Coming soon._
### โ๏ธ Input
| Field | Type | Required | Description |
|---|
maxItems | integer | No | Free 10, paid up to 1M. |
groupFilter | string | No | e.g. Soccer. |
activeOnly | boolean | No | Only sports in season. |
**Example 1:**
```json
{ "maxItems": 50 }
````
**Example 2:**
```json
{ "groupFilter": "Soccer", "activeOnly": true }
```
> โ ๏ธ **Good to Know:** The Odds API offers a generous free tier - sign up at the-odds-api.com for a free key.
### ๐ Output
| Field | Type | Description |
|---|---|---|
| ๐ `sport_key` | string | Stable key (e.g. `soccer_epl`). |
| ๐ `sport_title` | string | Human title (English Premier League). |
| ๐ท๏ธ `group` | string | High-level group (Soccer). |
| ๐ข `active` | boolean | Currently in season. |
| ๐ฏ `has_outrights` | boolean | Outrights markets available. |
| ๐ `description` | string | Long description. |
| ๐ `scrapedAt` | string | When fetched. |
| โ `error` | string | Error if upstream failed. |
**Sample record:**
```json
{
"sport_key": "soccer_epl",
"sport_title": "EPL",
"group": "Soccer",
"active": true,
"has_outrights": true,
"description": "English Premier League",
"scrapedAt": "2026-05-29T13:00:00.000Z",
"error": null
}
```
### โจ Why choose this Actor
| ๐ | Works without an API key for the /sports endpoint. |
| ๐๏ธ | 70+ leagues worldwide. |
| ๐ | Group and active-only filters. |
| ๐ | Errors surfaced cleanly. |
| ๐พ | CSV / Excel / JSON / XML / RSS / HTML. |
| ๐ | Optional secret API key field. |
### ๐ How it compares to alternatives
| Approach | Setup | Filters? | Errors? |
|---|---|---|---|
| Raw fetch | 10 min | manual | โ |
| Custom wrapper | 30 min | partial | partial |
| **This Actor** | 5 sec | โ
| โ
|
### ๐ How to use
1. Click **Try for free**.
2. Pick a group / active-only.
3. Click **Start**.
### ๐ผ Business use cases
**๐ฒ Sportsbook coverage matrices.** Map internal product IDs to Odds API keys.
**๐ผ Media coverage planning.** Decide which leagues to cover.
**๐ฐ Newsroom.** Build a reference table for sports stories.
**๐ค ML.** Bootstrap data pipelines.
### ๐ Automating The Odds API Sports List Scraper
- **Make / Zapier** to Airtable / Slack.
- **Cron schedule** native Apify.
- **Webhooks** on completion.
- **Pipe to BigQuery / Snowflake / Postgres**.
### ๐ Beyond business use cases
**๐ Education.** Sports analytics class material.
**๐งช Personal research.** Fantasy league coverage.
**๐ค Open data.** Public sports catalog mirrors.
**๐งฐ Prototyping.** Quick lookup feed.
### ๐ค Ask an AI assistant about this scraper
Drop this README into ChatGPT or Claude.
### โ Frequently Asked Questions
**โ API key?** No setup needed. The operator pre-configures upstream access for paid runs.
**โ Refresh?** Per-call snapshot.
**โ Filter?** Yes - group, active-only.
**โ Errors?** Clean `{error}` record.
**โ Schedule?** Yes.
**โ Scraping or API?** Public API.
**โ Schema stable?** Yes.
**โ Formats?** CSV, Excel, JSON, JSONL, XML, RSS, HTML.
**โ Coverage?** 70+ leagues.
**โ Cost?** Free tier covers /sports.
### ๐ Integrate with any app
Apify integrations with Make, Zapier, Slack, Discord, Google Drive, Google Sheets, Gmail, Airbyte, Keboola, Telegram, GitHub, REST/webhook.
### ๐ Recommended Actors
| Actor | What it does |
|---|---|
| [ParseForge PredictIt Markets Scraper](https://apify.com/parseforge/predictit-markets-scraper) | Political prediction markets. |
| [ParseForge Metaculus Questions Scraper](https://apify.com/parseforge/metaculus-questions-scraper) | Forecasting questions. |
| [ParseForge Stocktwits Trending Symbols Scraper](https://apify.com/parseforge/stocktwits-trending-symbols-scraper) | Retail sentiment. |
| [ParseForge Alpha Vantage Public Scraper](https://apify.com/parseforge/alpha-vantage-public-scraper) | Stocks, FX, crypto. |
> ๐ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for 900+ scrapers.
***
**Disclaimer:** This actor scrapes only publicly available data. ParseForge is not affiliated with, endorsed by, or sponsored by any of the third-party services referenced. Users are responsible for complying with the target site's terms of service and applicable law. [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp).
# Actor input Schema
## `maxItems` (type: `integer`):
Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000
## `groupFilter` (type: `string`):
Filter by sport group (e.g. Soccer, American Football, Tennis).
## `activeOnly` (type: `boolean`):
Only include sports currently in season.
## Actor input object example
```json
{
"maxItems": 10,
"activeOnly": false
}
```
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10
};
// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/the-odds-api-sports-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`๐พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "maxItems": 10 }
# Run the Actor and wait for it to finish
run = client.actor("parseforge/the-odds-api-sports-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("๐พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10
}' |
apify call parseforge/the-odds-api-sports-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=parseforge/the-odds-api-sports-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "The Odds API Sports Scraper",
"description": "Enumerate sports available on The Odds API with sport_key, sport_title, group, active, has_outrights, and description. Filter by group like Soccer or American Football, or toggle active only. Useful for building odds dashboards, line shopping tools, and betting analytics pipelines.",
"version": "0.1",
"x-build-id": "8Pg7nVqbqqSygA8iQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parseforge~the-odds-api-sports-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parseforge-the-odds-api-sports-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~the-odds-api-sports-scraper/runs": {
"post": {
"operationId": "runs-sync-parseforge-the-odds-api-sports-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~the-odds-api-sports-scraper/run-sync": {
"post": {
"operationId": "run-sync-parseforge-the-odds-api-sports-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": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
},
"groupFilter": {
"title": "Group filter (optional)",
"type": "string",
"description": "Filter by sport group (e.g. Soccer, American Football, Tennis)."
},
"activeOnly": {
"title": "Active only",
"type": "boolean",
"description": "Only include sports currently in season.",
"default": 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
}
}
}
}
}
}
}
}
}
}
```