Skip to content
Developer docsREST · JSON and PNG · /v1

Quickstart

Football API quickstart: fetch your first league table

Usage and access

Daily included requests are 5,000, 25,000 or 250,000 depending on your plan, resetting at midnight UTC. Additional successful requests on a metered subscription cost €0.002 each and are billed on the monthly EUR invoice. No free trial is offered. Feed access and checkout remain subject to live service activation.
  1. 1

    Create an account

    Sign up and verify your email address.

  2. 2

    Get API access

    Checkout is currently unavailable. Ask through dashboard support or the contact form about qualified service access.

  3. 3

    Generate an API key

    In Dashboard, API keys, create a key and copy the secret. It is shown once. Export it on your server: export FOOTBALLAPI_KEY=...

  4. 4

    Fetch a league table

    Feed IDs come from /api/football/catalogue. Base URL for this environment: https://footballapi.net.

    curl --fail-with-body "https://footballapi.net/api/v1/football/standings?leagueId=1204" \
  -H "X-API-Key: $FOOTBALLAPI_KEY"
  5. 5

    Read the envelope

    Successful responses contain meta and data; errors contain error, code and requestId. The shape below is illustrative, not live data.

    {
  "meta": {
    "feed": "standings",
    "leagueId": "1204"
  },
  "data": {
    "...": "normalised provider response"
  }
}
  6. 6

    Follow IDs

    Use team IDs from the table for team profiles and /api/football/media/teams/{id} crests, then player IDs from squads for player profiles.

Next: browse the API reference or try the signed-in playground.