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.
- 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.
- Find
- Check access
- Request
- Display
5 sectionsRead guide - 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.
- Account
- Private key
- Server request
- Your website
5 sectionsRead guide - 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.
- Competition
- Fixture
- Participants
- Display model
5 sectionsRead guide - 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.
- Visitors
- Shared cache
- One refresh
- API
5 sectionsRead guide - 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.
- Fixtures
- Live updates
- Detail store
- Match centre
5 sectionsRead guide - 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.
- Discover
- Import
- Persist
- Reconcile
5 sectionsRead guide - 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.
- Squad
- Match teams
- Player stats
- Heatmaps
5 sectionsRead guide - 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.
- Discover IDs
- Import image
- Save asset
- Deliver
5 sectionsRead guide - 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.
- Dictionaries
- Saved quotes
- Comparison
- Tips
5 sectionsRead guide - 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.
- Design
- Register
- Install
- Publish
6 sectionsRead guide - 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.
- Activation
- Server egress
- Relay
- Visitors
5 sectionsRead guide - 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.
- Status
- Scope
- Content
- Recovery
5 sectionsRead guide - 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.
- Plan
- Keys
- Usage
- Billing
5 sectionsRead guide - 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.
- Pro access
- Consent
- Tools
- Revoke
5 sectionsRead guide - 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.
- Apply
- Review
- Share
- Report
5 sectionsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
scoresRead guide - 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.
- Identify
- Request
- Validate
- Reuse
scores-newRead guide - 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.
- Identify
- Request
- Validate
- Reuse
liveRead guide - 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.
- Identify
- Request
- Validate
- Reuse
recent-resultsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
upcomingRead guide - 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.
- Identify
- Request
- Validate
- Reuse
competitionsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
current-competitionsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
seasonsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
fixturesRead guide - 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.
- Identify
- Request
- Validate
- Reuse
fixtureRead guide - 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.
- Identify
- Request
- Validate
- Reuse
historical-fixturesRead guide - 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.
- Identify
- Request
- Validate
- Reuse
abbreviationsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
squadsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
match-statisticsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
historical-statisticsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
matchRead guide - 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.
- Identify
- Request
- Validate
- Reuse
player-heatmapsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
predicted-lineupsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
injuriesRead guide - 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.
- Identify
- Request
- Validate
- Reuse
standingsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
historical-standingsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
scorersRead guide - 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.
- Identify
- Request
- Validate
- Reuse
assistsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
cardsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
teamRead guide - 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.
- Identify
- Request
- Validate
- Reuse
teamsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
playerRead guide - 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.
- Identify
- Request
- Validate
- Reuse
playersRead guide - 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.
- Identify
- Request
- Validate
- Reuse
updated-teamsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
updated-playersRead guide - 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.
- Identify
- Request
- Validate
- Reuse
head-to-headRead guide - 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.
- Identify
- Request
- Validate
- Reuse
pregame-marketsRead guide - 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.
- Identify
- Request
- Validate
- Reuse
pregame-bookmakersRead guide - 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.
- Identify
- Request
- Validate
- Reuse
inplay-mappingRead guide - 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.
- Identify
- Request
- Validate
- Reuse
team-imagesRead guide - 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.
- Identify
- Request
- Validate
- Reuse
player-imagesRead guide