Contents
API playground: build, run, and iterate in one UI
The Playground is a single place for you to build Football API requests without having to switch between documentation, Postman, and your code. You can pick a category and endpoint, add includes and filters, watch the URL update in real time, and run the request to see live JSON, all in your browser.
Here’s what you can do at a glance:
– Browse by category (fixtures, teams, predictions, squads, and more) and choose the exact endpoint.
– Add includes and filters with checkboxes and inputs, then adjust sorting and pagination.
– See the generated URL update as you build your request.
– Run the call instantly and inspect the live JSON response.
– Rerun from your history or save a request you use often.
Playground previews
Category & endpoint selector
What you’re seeing: The left panel groups endpoints by category (e.g., Fixtures, Teams, Predictions). Pick a category first, then select the endpoint you need (e.g., “Fixtures by Date Range”). This cuts down the time you spend digging through docs just to find the right path.
Includes & filters panel
What you’re seeing: Nested includes (participants, league, season, lineups, etc.) and filter fields. It mirrors our v3 request options so you can precisely shape responses and avoid over-fetching. Use this when you want to match context in one call, instead of stitching multiple requests.
Generated URL + response preview
What you’re seeing: As you toggle includes/filters, the full request URL updates live. Hit “Run” to fetch real data and verify payload structure instantly, perfect for testing a new view, confirming an include, or debugging query params.
History & saved queries
What you’re seeing: The Playground stores your last requests so you can rerun them without rebuilding. Save your favorites (“Premier League fixtures this week”, “Predictions by fixture”) and share them inside your team so everyone hits the same endpoints consistently.
Templates / Quickstart
What you’re seeing: Ready-made queries for common tasks. Use them as a starting point, then tweak includes/filters for your app and save your version to history. It’s the fastest way to go from idea to a working response.
Helpful links:
– Open the Playground: https://my.sportmonks.com/api/playground
– Getting started with API 3.0: https://docs.sportmonks.com/football/welcome/getting-started
Team rankings (beta): Daily Elo-style club strength
We have opened up Team Rankings (Beta), which gives you daily updated club rankings using a model based on the Elo system, with data going back to 2005. This is great for match previews, content based on a team’s form, and for creating your own models.
With this feature, you’ll get:
– Current rank for each team, updated every day at 00:00:00 UTC.
– A score from 0-100 for quick comparisons.
– Date-based history from 2005 to today.
– Team ID and Ranking ID for linking data together.
The documentation includes endpoints for getting all team rankings, rankings by team ID, and rankings by date, so you can get exactly what you need, for example, a club’s performance over several seasons.
To get access, mail our sales team for more information.
Coming soon: F1 API
We’re finalising our Formula 1 API and will share more details soon. Want early updates and first-access info? Ping our team: [email protected].
