API_key

Gain insights into using API-Football in Python to retrieve soccer data, including setting up an account, using endpoints, and integrating widgets into applications or websites.

Getting Soccer Data with API-Football in Python.png

​​This course is a hands-on guide for programmatically using API-Football to retrieve the required association football (soccer) data. Here, you’ll learn about the different resources that API-Football provides, including endpoints and widgets. 

You’ll review the basics, like setting up an account and getting the required API key. Then, you’ll learn about different endpoints and how to use each one. You’ll also learn about widgets and how to use them directly in any application or website.

Getting Soccer Data with API-Football in Python

The API endpoints discussed so far only give us platform-related information and are of no practical use for the front-end. In the following lessons, we will discuss endpoints that will provide information we can use at the front-end.

The **teams endpoint** provides the list of available teams. The base URI for this endpoint is `https://v3.football.api-sports.io/teams`.
## Query parameters
We can use the following query parameters for this endpoint: 

align-center

>We need to use at least one of these parameters with this endpoint. Calling this endpoint without any query parameters will return an error.
## Use cases
### Get a team’s information using the team name
The code in the widget below shows how we can use the `GET` request to retrieve a team’s information using the team name. We use `name` as a query parameter in **line 5**. Click the “Run” button to get the team’s information.

The API endpoints discussed so far only give us platform-related information and are of no practical use for the front-end. In the following lessons, we will discuss endpoints that will provide information we can use at the front-end.

The **teams endpoint** provides the list of available teams. The base URI for this endpoint is `https://v3.football.api-sports.io/teams`.
# Query parameters
We can use the following query parameters for this endpoint: 

>We need to use at least one of these parameters with this endpoint. Calling this endpoint without any query parameters will return an error.
# Use cases
## Get a team’s information using the team name
The code in the widget below shows how we can use the `GET` request to retrieve a team’s information using the team name. We use `name` as a query parameter in **line 5**. Click the “Run” button to get the team’s information.

Learn how to get a team's information using API-Football.

Parameters	Type	Category	Description
`id`	integer	optional	This is the ID of the team we want to search for.
`name`	string	optional	This is the name of the team.
`league`	integer	optional	This contains the ID of the league we want to search for. It can be retrieved using the leagues endpoint.
`season`	integer	optional	This is the season of the league. The format is "YYYY".
`country`	string	optional	This is the name of the country whose team we want to search for.
`search`	string	optional	These are the initials for the team or the country name. They should be a minimum of 3 characters.

Introduction

Endpoints

Endpoints: Teams

Endpoints: Standings

Endpoints: Fixtures

Endpoints: Players

Widgets

Conclusion

Teams Information

Query parameters