How-to use Sportmonks' APIs in Postman
Welcome to the how-to guide about using Postman for our APIs. In our various tutorials, how-to guides and getting started pages, we recommended you use Postman. This is because Postman has our entire library of endpoints. Everything has been set-up and is ready for you to use. It’s extremely simple. In this how-to guide, we’re going to show you how you can make API requests with Postman. We'll show you various GIFs for visual guidance besides text. You’re going to need the following:
Sportmonks API token
Postman account
Step 1: Download the Sportmonks API collection
In, case you don’t have a Postman account. No worries, you can simply create a Postman account when you’re directed to that link.
Open the GIFs in a new tab, for the full resolution versions.
Step 2: Insert your API token into Postman
The API token will be added automatically to every request you make in the future, which is super convenient. Your requests will always be authenticated this way.
Step 3: Make your first request
Now to test whether you successfully added the API token or not, we’re going to make a request in Postman. Go to our Soccer API collection and choose an endpoint. For this guide, we’ve chosen the teams by id endpoint. For your convenience, we have already added an example team id for you. The example ids will always be of a team, season, or player that is available in our Free Plan. Other than that, you can freely add includes. Simply click on the include query parameter and then insert a value.
Hit the blue 'send button' and it will send your request!
Step 4: Check explanations and include
We offer extra information about the endpoint, which includes are available, how many nested includes you can use and whether the endpoint contains pagination or not. You can check out our API reference guide for this info.
Step 5: Use filters
We include standard filter options. You can simply check a filter and then type what you want to filter on. For example, with the fixture by id endpoint, you can filter on the parameter 'markets' and 'bookmakers'.
Simply check market and then add any value you would like at the value bar.
Step 6: Example response
Step 7: Save code
Step 8: Save request
Step 9: Choose code output
We’ve also made it possible for you to make API requests via a plethora of coding languages. Simply click on the ‘code’ button on the top right corner, directly down below ‘save’.
We hope the gifs are helpful in assisting you with navigating through our Postman collection. If you happen to have any questions, feel free to contact our technical team!
Last updated