Skip to content

51 guides / 36 endpoint-specific

Tutorials for building with football data.

Step-by-step guides with request flows, working code and links to the exact reference entries. Pick a task, follow the steps, ship it.

All 51 guides
  1. Getting startedBeginner8 min

    Find leagues and use their IDs in API requests

    Find football leagues by country or name, copy league IDs and request examples, save Starter choices and display league data safely on your website.

    1. Find
    2. Check access
    3. Request
    4. Display
    5 sectionsRead guide
  2. Getting startedBeginner9 min

    Make your first FootballAPI.net request

    Create an account, activate the right football plan, keep your API key server-side and make a first authenticated scores request with cURL or PHP.

    1. Account
    2. Private key
    3. Server request
    4. Your website
    5 sectionsRead guide
  3. Getting startedBeginner8 min

    Understand football IDs and response shapes

    Learn static fixture IDs, competition and stage mappings, object-or-array collections and null-safe normalisation for football API responses.

    1. Competition
    2. Fixture
    3. Participants
    4. Display model
    5 sectionsRead guide
  4. Performance and operationsIntermediate12 min

    Save requests with shared football API caches

    Design server-side caching, request coalescing, prewarming and usage budgets so football pages load quickly without unnecessary API calls.

    1. Visitors
    2. Shared cache
    3. One refresh
    4. API
    5 sectionsRead guide
  5. Build a football productIntermediate11 min

    Build a fast football match centre

    Combine fixtures, live states, summary events, statistics, formations, images and odds into one preloaded football match-centre model.

    1. Fixtures
    2. Live updates
    3. Detail store
    4. Match centre
    5 sectionsRead guide
  6. Performance and operationsIntermediate9 min

    Prepare dates and retain football history

    Build a fast fixture calendar with timezone-safe dates, bounded imports, saved football history and correction-aware background refreshes.

    1. Discover
    2. Import
    3. Persist
    4. Reconcile
    5 sectionsRead guide
  7. Build a football productIntermediate10 min

    Build formations, ratings and heatmap views

    Use confirmed team positions, match-specific ratings and verified heatmap coordinates without confusing predictions, season averages or tracking coverage.

    1. Squad
    2. Match teams
    3. Player stats
    4. Heatmaps
    5 sectionsRead guide
  8. Build a football productIntermediate9 min

    Deliver team crests and player portraits fast

    Decode supplied football images, save team crests and player portraits by ID, and serve fast public visuals without exposing customer API keys.

    1. Discover IDs
    2. Import image
    3. Save asset
    4. Deliver
    5 sectionsRead guide
  9. Build a football productIntermediate10 min

    Build odds comparisons and saved daily tips

    Understand odds dictionaries, account activation, market identity, quote caching and probability calculations without making unnecessary price requests.

    1. Dictionaries
    2. Saved quotes
    3. Comparison
    4. Tips
    5 sectionsRead guide
  10. Widgets and integrationsBeginner11 min

    Design and install a WordPress football widget

    Customise the football widget, register one website, verify its installation key and publish scheduled, live, results and prediction shortcodes.

    1. Design
    2. Register
    3. Install
    4. Publish
    6 sectionsRead guide
  11. Widgets and integrationsIntermediate8 min

    Prepare ball tracking and live connections

    Understand account activation, outbound IP approval, server-side relays and the distinction between ball tracking, commentary, heatmaps and live odds.

    1. Activation
    2. Server egress
    3. Relay
    4. Visitors
    5 sectionsRead guide
  12. Performance and operationsIntermediate9 min

    Diagnose API errors and missing football data

    Handle authentication, entitlement, validation, rate limits, temporary failures and empty collections with bounded retries and useful diagnostics.

    1. Status
    2. Scope
    3. Content
    4. Recovery
    5 sectionsRead guide
  13. Account and supportBeginner8 min

    Manage plans, trials, API keys and daily usage

    Understand GBP plans, Starter's seven-day trial, daily allowances, metered overages, league selection and safe account support workflows.

    1. Plan
    2. Keys
    3. Usage
    4. Billing
    5 sectionsRead guide
  14. Widgets and integrationsIntermediate7 min

    Connect AI to your football data with MCP

    Use the Pro-plan read-only MCP connection, review consent and available tools, and keep AI client access separate from billing and account controls.

    1. Pro access
    2. Consent
    3. Tools
    4. Revoke
    5 sectionsRead guide
  15. Account and supportBeginner6 min

    Use the FootballAPI.net affiliate programme

    Find the affiliate application, understand approval and referral tracking, and keep programme reporting separate from customer API access.

    1. Apply
    2. Review
    3. Share
    4. Report
    5 sectionsRead guide
  16. Endpoint tutorialsIntermediate6 min

    Build a scoreboard with scores and results

    Fetch today's football scores, interpret match states and minutes, join static match IDs and share a five-second scoreboard cache across visitors.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    scoresRead guide
  17. Endpoint tutorialsIntermediate6 min

    Integrate the newer scores snapshot

    Use the newer scores endpoint as a server-side snapshot, validate match IDs and dates, and avoid duplicate collectors for the same scoreboard.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    scores-newRead guide
  18. Endpoint tutorialsIntermediate6 min

    Show only currently live football matches

    Build a live-only football view with real match states, shared polling, careful minute displays and correct transitions to finished results.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    liveRead guide
  19. Endpoint tutorialsIntermediate6 min

    Import recent results by day offset

    Read recent football results using offsets from one to seven days, validate actual fixture dates and retain a durable results archive.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    recent-resultsRead guide
  20. Endpoint tutorialsIntermediate6 min

    Prepare fixtures before visitors arrive

    Load upcoming football schedules with the supported day offsets, prewarm your calendar and reconcile fixture changes without repeated page-load requests.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    upcomingRead guide
  21. Endpoint tutorialsIntermediate6 min

    Discover football competition identifiers

    Build a competition selector using stable league IDs, separate stage mappings and season metadata, then reuse the directory throughout your integration.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    competitionsRead guide
  22. Endpoint tutorialsIntermediate6 min

    Keep a current-season competition selector

    Use the current competition mapping to refresh active football selections while preserving historical IDs and season records.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    current-competitionsRead guide
  23. Endpoint tutorialsIntermediate6 min

    Choose valid seasons for historical requests

    Discover season values, translate display labels into accepted historical query syntax and build a stable football season selector.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    seasonsRead guide
  24. Endpoint tutorialsIntermediate6 min

    Build a season fixture calendar

    Import football season fixtures, use leagueId and paired date filters correctly, and prewarm date pages from a shared fixture store.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    fixturesRead guide
  25. Endpoint tutorialsIntermediate6 min

    Open a single fixture by its durable match ID

    Retrieve a football fixture using leagueId and matchId, distinguish fixture data from detailed statistics and share one saved match record.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    fixtureRead guide
  26. Endpoint tutorialsIntermediate6 min

    Create a historical fixture and result archive

    Request past-season football fixtures with correct season syntax, validate returned dates and retain reusable result snapshots.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    historical-fixturesRead guide
  27. Endpoint tutorialsIntermediate6 min

    Add consistent short team names

    Use the team abbreviation directory for compact football interfaces and mobile scoreboards without matching clubs by ambiguous short names.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    abbreviationsRead guide
  28. Endpoint tutorialsIntermediate6 min

    Import a competition's football squads

    Save squad players by team and player IDs, distinguish squad membership from confirmed starting line-ups and refresh rosters efficiently.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    squadsRead guide
  29. Endpoint tutorialsIntermediate6 min

    Collect competition-wide match statistics

    Fetch football match detail by competition, normalise statistics and player records, and share one background collection across all match tabs.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    match-statisticsRead guide
  30. Endpoint tutorialsIntermediate6 min

    Retrieve football statistics for a past date

    Use fixture-derived dates to request historical match statistics, filter actual returned records and save reusable match detail archives.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    historical-statisticsRead guide
  31. Endpoint tutorialsIntermediate6 min

    Build match summary, stats and line-up tabs

    Use the exact id and league parameters for single-match detail, join player IDs and display confirmed formations and optional ratings.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    matchRead guide
  32. Endpoint tutorialsIntermediate6 min

    Integrate heatmaps with verified coverage

    Discover heatmap coverage flags, retrieve the correct competition collection and validate actual coordinates before building player visualisations.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    player-heatmapsRead guide
  33. Endpoint tutorialsIntermediate6 min

    Display and label predicted football line-ups

    Read predicted football lineup collections, check actual record dates and label forecasts separately from match-confirmed starting teams.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    predicted-lineupsRead guide
  34. Endpoint tutorialsIntermediate6 min

    Add injury information to team and match pages

    Normalise football injury records, preserve dates and player IDs, and avoid presenting historical injury entries as current diagnoses.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    injuriesRead guide
  35. Endpoint tutorialsIntermediate6 min

    Build a current league table

    Render current football standings with positions, points, groups and supplied tie-break ordering using a shared competition cache.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    standingsRead guide
  36. Endpoint tutorialsIntermediate6 min

    Add past-season football league tables

    Retrieve historical standings with league and season parameters, retain group structure and prevent old tables overwriting current rankings.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    historical-standingsRead guide
  37. Endpoint tutorialsIntermediate6 min

    Create a football top-scorers leaderboard

    Display competition scoring leaders with supplied ordering, player identities and portrait joins without recalculating unsupported rankings.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    scorersRead guide
  38. Endpoint tutorialsIntermediate6 min

    Build an assist-leaders table

    Read competition assist leaders, preserve the supplied assist definition and share player profiles and image caches across leaderboard views.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    assistsRead guide
  39. Endpoint tutorialsIntermediate6 min

    Display football disciplinary leaderboards

    Use the cards leaderboard for competition disciplinary rankings while keeping yellow cards, red cards and match events distinct.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    cardsRead guide
  40. Endpoint tutorialsIntermediate6 min

    Create a football team profile

    Fetch one football club profile by team ID, join fixtures and saved team crests, and avoid using display names as identity keys.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    teamRead guide
  41. Endpoint tutorialsIntermediate6 min

    Batch football team profile lookups

    Retrieve up to 50 football team profiles per batch, deduplicate IDs and reduce profile-import requests across a fixture schedule.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    teamsRead guide
  42. Endpoint tutorialsIntermediate6 min

    Build a football player profile

    Look up a football player by stable ID and distinguish career or season profile data from a rating for a specific fixture.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    playerRead guide
  43. Endpoint tutorialsIntermediate6 min

    Import player profiles in batches

    Batch up to 50 player profile IDs, retain stable identity joins and reduce requests when preparing squads and confirmed match line-ups.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    playersRead guide
  44. Endpoint tutorialsIntermediate6 min

    Refresh changed team records efficiently

    Use updated-team identifiers as import hints, fetch changed club profiles in bounded batches and preserve successful sync checkpoints.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    updated-teamsRead guide
  45. Endpoint tutorialsIntermediate6 min

    Update a player database with changed-ID hints

    Use updated-player lists to refresh profiles in batches, avoid unnecessary imports and retain stable player and portrait identities.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    updated-playersRead guide
  46. Endpoint tutorialsIntermediate6 min

    Add team head-to-head context

    Request football head-to-head data with two team IDs, label home/away orientation and keep historical context separate from predictions.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    head-to-headRead guide
  47. Endpoint tutorialsIntermediate6 min

    Resolve pre-match betting market identifiers

    Cache the pregame betting market dictionary and use stable market IDs, outcomes and line values to compare like-for-like football odds.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    pregame-marketsRead guide
  48. Endpoint tutorialsIntermediate6 min

    Map bookmaker IDs to readable names and links

    Build a bookmaker selector from the pregame dictionary and join saved odds and configured outbound links by bookmaker ID.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    pregame-bookmakersRead guide
  49. Endpoint tutorialsIntermediate6 min

    Join football fixture IDs to in-play mappings

    Understand the football in-play mapping directory without confusing identifier mapping with activated live odds or settlement delivery.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    inplay-mappingRead guide
  50. Endpoint tutorialsIntermediate6 min

    Save and display football team crests

    Retrieve a football team crest as a base64 JSON image, decode it server-side and cache it by stable team ID for fast website delivery.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    team-imagesRead guide
  51. Endpoint tutorialsIntermediate6 min

    Cache player portraits by player ID

    Retrieve player portraits as base64 JSON images, save them under stable player IDs and prepare line-up images before visitors open the match.

    1. Identify
    2. Request
    3. Validate
    4. Reuse
    player-imagesRead guide

Useful next steps