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 **head to head endpoint** can be used to get the results of fixtures between any two teams. It provides other information such as the timestamps for full and half times, the number of goals scored by each team, and the venue of the match. Its base URI is `https://v3.football.api-sports.io/fixtures/headtohead`.

This endpoint is updated every 15 seconds.

## Query parameters
The following query parameters can be used with this endpoint:

align-center

>You can review the list of valid statuses in the [Fixtures](https://www.educative.io/courses/soccer-api-football-python/fixtures-Y54jQL1VKMK) lesson.


## Use cases
### Get results of all the head-to-head fixtures
We can use the `h2h` query parameter with this endpoint to get the record of all the fixtures between two teams. Click the “Run” button to retrieve this information.

# Query parameters
The following query parameters can be used with this endpoint:

>You can review the list of valid statuses in the [Fixtures](https://www.educative.io/courses/soccer-api-football-python/fixtures-Y54jQL1VKMK) lesson.


# Use cases
## Get results of all the head-to-head fixtures
We can use the `h2h` query parameter with this endpoint to get the record of all the fixtures between two teams. Click the “Run” button to retrieve this information.

Learn how to get the record for head-to-head fixtures.

Parameters	Type	Category	Description
`h2h`	string	required	This is the ID of the teams separated by "-". We can get the IDs of the teams using the teams endpoint.
`date`	string	optional	This is the date of the fixture. The format is "YYYY-MM-DD".
`league`	integer	optional	~~~~This is the IDof the league we want fixtures from. This ID can be obtained using the leagues endpoint.
`season`	integer	optional	This is the year we want to see the fixtures for. The format is "YYYY".
`last`	integer	optional	This indicates the number of past fixtures we want to see the stats for. It should be a 2 digit integer.
`next`	integer	optional	This indicates the number of future fixtures we want to see the information for. It should be a 2 digit integer.
`from`	string	optional	This is the start date. The format is "YYYY-MM-DD".
`to`	string	optional	This is the end date. The format is "YYYY-MM-DD".
`status`	string	optional	This indicates the status of the fixtures.
`timezone`	string	optional	This is the timezone we want to see the fixtures for. Valid timezones can be obtained using the timezone endpoint.

Introduction

Endpoints

Endpoints: Teams

Endpoints: Standings

Endpoints: Fixtures

Endpoints: Players

Widgets

Conclusion

Fixtures: Head to Head

Query parameters