Getting started

From nothing to a priced match in four calls.

1. Get a key

Sign in with Google at /login. The account is created and the key issued in the same step: no card, no trial clock. The free key is real data on every competition in the archive, for yesterday, as one whole day, at 50 calls a day.

2. Make a call

Your key goes in the X-API-Key header. There is nothing else to send.

Your first call

curl "https://api.footballsoccerapi.com/v1/countries" \
  -H "X-API-Key: $FSAPI_KEY"

3. Understand the shape

Every response has two top-level keys. data is what you asked for: an object for a single resource, an array for a list. meta always carries data_as_of so you know how old the answer is, and request_id so you can quote an exact call in a support thread. Lists also carry count and next_cursor.

4. Go deeper

The workhorse is /v1/matches: every filter composes, so you can ask for finished matches in one competition and season that carry an exchange price. From a match, /v1/matches/{id}/odds gives you the market.

Read pagination before you pull anything large, and errors before you ship.

Authentication →