🥅 TheSportsDB Scraper

🚀 Export TheSportsDB's open sports catalogue in seconds. Pull leagues, teams, players, upcoming and past events, league standings, and live scores across soccer, basketball, ice hockey, baseball, American football, and many more sports. No sign-up, no manual scraping, no setup.

🕒 Last updated: 2026-05-15 · 📊 30+ fields per record · 🥅 Multi-sport coverage · 🔍 10 lookup modes · 🌐 Open community catalogue

The TheSportsDB Scraper exports the crowd-sourced TheSportsDB catalogue and returns up to 30+ structured fields per record. Whether you're pulling all leagues, searching for a team or player by name, fetching upcoming and past events for a league, looking up league standings, or grabbing live scores for a sport, the Actor returns a clean structured row per entity ready for your dataset.

The catalogue covers soccer, basketball, American football, baseball, ice hockey, and many more sports, with team metadata, player bios, league structure, fixture lists, standings tables, and a continuously updated live-scores feed. This is the friendliest open sports database on the web, packaged for one-click export.

🎯 Target Audience	💡 Primary Use Cases
Sports media, fantasy app developers, hobbyist sports devs, journalists, fan communities, indie analytics teams	Multi-sport league directories, team + player lookups, fixture feeds, standings widgets, live-score tickers, content automation

---

📋 What the TheSportsDB Scraper does

Ten lookup modes in a single run:

• 🌍 All Leagues. Every league across every sport.
• 🏟️ Team Search. Resolve teams by name (e.g. "Arsenal").
• 🆔 Team Lookup. Resolve a team by canonical ID with full metadata.
• 👤 Player Search. Resolve players by name (e.g. "Messi").
• 📋 Team Roster. All players on a team by team ID.
• 📅 Upcoming Events. Next 15 events for a league by league ID.
• 🕓 Past Events. Last 15 events for a league by league ID.
• 📊 Lookup Table. League standings table for a season (e.g. 2024-2025).
• 🔴 Live Scores. Live in-progress events by sport (e.g. Soccer, Basketball, Ice Hockey).
• 🗓️ Events on a Day. All matches on a specific date, optionally filtered by sport or league.

Each record is normalised: empty fields are stripped, every row carries a scrapedAt ISO 8601 timestamp, and the original TheSportsDB field names are preserved for direct join compatibility with the catalogue.

💡 Why it matters: TheSportsDB is one of the few free, multi-sport, multi-league databases on the web. Building your own pipeline against it means handling 10 different lookup endpoints, normalising responses, and refreshing data manually. This Actor packages all of that into one click.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

---

⚙️ Input

Input	Type	Default	Behavior
mode	string	"leagues"	One of leagues, teamSearch, teamLookup, playerSearch, teamRoster, upcomingEvents, pastEvents, lookupTable, livescore, eventsday.
query	string	""	Search text for teamSearch / playerSearch.
leagueId	string	""	League ID for upcomingEvents / pastEvents / lookupTable (e.g. 4328 = English Premier League).
teamId	string	""	Team ID for teamLookup / teamRoster.
season	string	""	Season for lookupTable (e.g. 2024-2025).
sport	string	""	Sport name for livescore / eventsday (e.g. Soccer, Basketball, Ice_Hockey).
date	string	""	YYYY-MM-DD for eventsday mode.
maxItems	integer	10	Free plan caps at 10, paid plan at 1,000,000.

Example: every league in the catalogue.

{
    "mode": "leagues",
    "maxItems": 100
}

Example: English Premier League standings table for 2024-2025.

{
    "mode": "lookupTable",
    "leagueId": "4328",
    "season": "2024-2025"
}

⚠️ Good to Know: TheSportsDB's free public tier returns a fixed page size (typically 10-15 items) for some endpoints. The maxItems input still applies on the dataset side for display purposes.

---

📊 Output

Each record contains up to 30+ fields, depending on mode. Download the dataset as CSV, Excel, JSON, or XML.

🧾 Schema (leagues mode example)

Field	Type	Example
🆔 idLeague	string	"4328"
🏆 strLeague	string	"English Premier League"
⚽ strSport	string	"Soccer"
🔖 strLeagueAlternate	string	"Premier League"
🔗 slug	string	"english-premier-league-soccer"
🕒 scrapedAt	ISO 8601	"2026-05-15T00:00:00.000Z"

🧾 Schema (teamSearch / teamLookup mode)

Field	Type	Example
🆔 idTeam	string	"133604"
🏟️ strTeam	string	"Arsenal"
🏳️ strCountry	string	"England"
⚽ strSport	string	"Soccer"
🏆 strLeague	string	"English Premier League"
📅 intFormedYear	string	"1886"
🏟️ strStadium	string	"Emirates Stadium"
🖼️ strBadge	string	"https://www.thesportsdb.com/images/media/team/badge/..."
📝 strDescriptionEN	string	"Arsenal Football Club is a..."

📦 Sample record

---

✨ Why choose this Actor

	Capability
🥅	Ten lookup modes. Leagues, teams, players, fixtures, standings, live scores, day filters all in one Actor.
🌐	Multi-sport coverage. Soccer, basketball, American football, baseball, ice hockey, and more.
🖼️	Rich media. Team badges, stadium photos, player thumbs come straight from the catalogue.
📅	Fixture feeds. Next 15 + last 15 events per league, plus exact-date filters.
📊	Standings tables. Season-aware league tables with per-team metrics.
🔁	Always fresh. Every run pulls the latest catalogue state.
🚫	No sign-up. Works against the public catalogue. No login or token required.

📊 TheSportsDB is the open multi-sport reference of choice for indie devs, fantasy startups, and fan-engagement platforms.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ TheSportsDB Scraper (this Actor)	$5 free credit, then pay-per-use	Multi-sport, 10 modes	Live per run	mode, query, league, team, sport, date	⚡ 2 min
Commercial sports data vendors	$$$$/month	Full + extras	Streaming	Many	⏳ Weeks
Manual scraping	Free	Inconsistent	On demand	None	🐢 Days
Sport-specific scrapers	Free	Single league	Live	Limited	🕒 Variable

Pick this Actor when you want broad multi-sport coverage, normalised records, and zero pipeline maintenance.

---

🚀 How to use

1. 📝 Sign up. Create a free account w/ $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the TheSportsDB Scraper page on the Apify Store.
3. 🎯 Set input. Pick a mode and supply the relevant inputs (league ID, team ID, query, or date).
4. 🚀 Run it. Click Start and let the Actor collect your data.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

📺 Sports Media & Publishing Multi-sport content directories Auto-write article previews from upcoming-event feeds Live-score tickers across multiple leagues Daily fixture digests for newsletter automation	🎲 Fantasy & Indie Sports Apps Cross-league fantasy product seeding Roster catalogue caches with badges and bios League standings widgets refreshed nightly Player search-as-you-type backed by real data
🏟️ Fan Communities & Discord Bots Multi-sport "what's on tonight" channel posts Team-badge gallery commands for fan servers Postseason bracket dashboards Live-score push notifications	📊 Analytics & Research Cross-sport calendar studies League-structure datasets for academic research Multi-league benchmark comparisons Time-series pulls for sports-econ projects

---

🔌 Automating TheSportsDB Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Refresh live scores every minute, daily fixture digests, or weekly league snapshots are all one click.

---

🌟 Beyond business use cases

Multi-sport data powers more than commercial workflows. The same records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Cross-sport coursework with real catalogue data Comparative league-structure studies Sport-history dissertations grounded in standings Reproducible research pulls with cited timestamps	🎨 Personal and creative Hobbyist multi-sport tracker dashboards Discord bots for fan communities Trading-card generators with team badges Creator content automation across leagues
🤝 Non-profit and civic Local-league publicity dashboards Sport-journalism for local newsrooms Inclusion analyses across player rosters Open-data hackathons on world-sport coverage	🧪 Experimentation Train cross-sport schedule models Prototype agent pipelines that resolve team IDs Validate fan-product hypotheses with real fixtures Test live-stream UX concepts with real scores

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Pick a mode (one of the ten lookup modes), supply the relevant inputs, and click Start. The Actor pulls fresh records from the public TheSportsDB catalogue and emits a clean structured row per league, team, player, or event.

🥅 Which sports are covered?

Soccer, basketball, American football, baseball, ice hockey, and many more. Use the leagues mode to inspect every sport and league the catalogue knows about.

📅 Can I get a fixture list for a league?

Yes. Set mode to upcomingEvents (next 15 fixtures) or pastEvents (last 15 fixtures) and supply the leagueId (e.g. 4328 for the English Premier League).

📊 How do I get a league standings table?

Set mode to lookupTable, supply leagueId, and set season to a season string (e.g. 2024-2025). Leave season empty to get the current season.

🔴 Can I pull live scores?

Yes. Set mode to livescore and supply the sport name (e.g. Soccer, Basketball, Ice_Hockey). The Actor returns all in-progress events for that sport.

🗓️ Can I get matches on a specific date?

Yes. Set mode to eventsday, supply date as YYYY-MM-DD, and optionally narrow by sport or leagueId.

🔍 How do I look up a team or player?

Use teamSearch or playerSearch and supply the name in query (e.g. "Arsenal", "Messi"). Use teamLookup or teamRoster if you already have the canonical ID.

⏰ Can I schedule regular runs?

Yes. Use Apify Schedules to run this Actor every minute, hourly, or daily. The dataset always reflects the current state of the public catalogue.

⚖️ Is this data legal to use?

The TheSportsDB catalogue is published as an open community dataset. Review the source's terms of use for your specific use case, particularly if you redistribute or commercialise the content.

💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and unlocks scheduling and higher concurrency.

🔁 What happens if a run fails or gets interrupted?

Apify automatically retries transient errors. If a run still fails, you can inspect the log in the Runs tab, fix the input, and re-run. Partial datasets from failed runs are preserved so you never lose progress.

🆘 What if I need help?

Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below.

---

🔌 Integrate with any app

TheSportsDB Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get score updates in your channels
• n8n - Self-hosted workflow automation
• Pipedream - Event-driven serverless workflows
• Airbyte - Pipe sports data into your warehouse
• GitHub - Trigger runs from commits
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh fixtures into your product backend, or alert your fans in Slack when a goal is scored.

---

🔗 Recommended Actors

• 🏆 Sofascore Live Events Scraper - 13-sport live + scheduled events feed
• ⚾ MLB Stats Scraper - Schedules, teams, rosters, player stats, live game feeds
• 🏒 NHL Stats Scraper - 32-team standings, schedules, player landing
• 🛡️ CWE MITRE Scraper - Software weakness reference catalogue
• 📊 OurAirports Scraper - Global airport reference dataset

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by TheSportsDB or any of its contributors. All trademarks mentioned are the property of their respective owners. Only publicly available open sports catalogue data is collected.