Welcome

Here you will find everything you need to know about Sports Buddha Football API.

Getting Started

To get started you will need a Api Token. When you sign up to Sports Buddha football api package this token will be automatically generated and can be seen in My Account section.

Base url is https://api.sportsbuddha.com/v1

Example Api Token
9269c568bad611edafa10242ac120002

Api tokens need to be passed in request headerX-Auth-Token.

Example request

curl --header "X-Auth-Token: 9269c568bad611edafa10242ac120002" https://api.sportsbuddha.com/v1/competitions/PL

Have a look at the endpoints section for more detail on resources available and expected responses.

Rate Limiting

Depending on the package you have subscribed to it will come with maximum requests allowed per minute. The free plan has 5 requests per minute. If you feel you need more, you can upgrade your package on sportsbuddha.com

How does the rate limit work?

The limit depends on the package you have. The rate limit starts counting when you make the first of X requests and is refreshed every minute. For example: If you make the first of X requests at 12:18 UTC it will be reset at 12:19. Please note that X stands for the number of API calls in your plan.

Find the information about your rate limit in My Account section

What happens when I hit the rate limit?

Once you’ve hit the rate limit, you will receive a 429 response. The rate limit kicks in after the first request has been made. The rate limit will be set to 0 when an minute has passed. You will not be able to request data until the minute has passed.