🏟️ 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:

{ "maxItems": 50 }

Example 2:

{ "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:

{
  "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	Political prediction markets.
ParseForge Metaculus Questions Scraper	Forecasting questions.
ParseForge Stocktwits Trending Symbols Scraper	Retail sentiment.
ParseForge Alpha Vantage Public Scraper	Stocks, FX, crypto.

💡 Pro Tip: browse the complete ParseForge collection 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.