Skip to content
datasportsAPI

No. 09 · Pitch & field · Fixture sport

American FootballDown, distance and the drive in between.

NFL and college football with down and distance, field position, quarters and playoff brackets.

Get a free key See the 13 endpoints
09Pitch & field
American Football13 endpoints · fixtures

Scouting report

What you get for American Football

American football fixtures carry the state between snaps: down, yards to go, which side has the ball, where it sits and whether it is goal to go. Scores break down by quarter, and playoff games sit inside their bracket.

Lineups cover covered games, the best players of a match are measured in yards, and the draft endpoint walks the NFL draft pick by pick, with each prospect's position and college.

First request

Every american football match in play, one call.

The live board filtered to american football: each match with its score, status and clock. The same request in four forms; pick yours.

  1. 1Create a key in the dashboard. Free gives you 1,000 requests a day during the beta.
  2. 2Put it in DATASPORTSAPI_API_KEY so the SDKs and the dsa command find it.
  3. 3Call /v2/livescores?sport=american-football.
curl -H "Authorization: Bearer dsa_live_…" \
  "https://api.datasportsapi.com/v2/livescores?sport=american-football"

The catalog

American Football, endpoint by endpoint

Its own detail first, then the shared spine every fixture sport answers on. Each row opens the endpoint’s reference page.

All 116 endpoints

Where american football goes deeper

3 endpoints with detail specific to the sport.

  1. GETLineups/v2/fixtures/{id}/lineupsTeam lineups and formations plus unavailable players, with every player carrying a match rating and statistics.All plans
  2. GETDraft/v2/leagues/{id}/draftReturns a single round of a league’s draft — the NBA, the NFL and any other league whose draft our data source tracks.All plans
  3. GETCup trees/v2/leagues/{id}/cup-treesKnockout brackets for a season, such as a cup’s knockout phase, a playoff tree or a tennis draw.All plans

The shared spine

10 endpoints that behave the same for every fixture sport.

  1. GETLive scores/v2/livescoresReturns every live fixture across all sports, or a single sport’s in-play board when ?sport= is given.All plans
  2. GETFixtures by date/v2/fixturesLists the fixtures that start on a given UTC date.All plans
  3. GETFixture/v2/fixtures/{id}Everything we hold on one fixture.All plans
  4. GETEvents/v2/fixtures/{id}/eventsThe match’s incidents in chronological order, oldest first: goals, cards, substitutions, period markers and added-time announcements.All plans
  5. GETStatistics/v2/fixtures/{id}/statisticsTeam statistics for the match, organised by period and by category.All plans
  6. GETHead to head/v2/fixtures/{id}/h2hThe two teams’ head-to-head record as tallied by the source, seen from this fixture’s home / away point of view.All plans
  7. GETStandings/v2/leagues/{id}/standingsLeague tables for a single season.All plans
  8. GETTeam/v2/teams/{id}Returns a team’s profile — sport, country, venue, colours, logo, gender, whether it is a club or a national team, kind (team / individual / pair), manager and founding date (foundedOn, pres…All plans
  9. GETLeague/v2/leagues/{id}Returns a league’s profile: its tier (where it sits in the national pyramid), gender, the reigning champion with its title count, the clubs holding the most titles, the divisions directly a…All plans
  10. GETSearch/v2/searchA single search over teams (individual competitors included), players, managers, referees, leagues, fixtures, venues, racing series and races.All plans

What comes back

Fixture, as served

The in-play fields of a fixture: second and six, the away side driving from its own 34.

GET/v2/fixtures/{id}All plans

Sample from the docs, trimmed with …

GET /v2/fixtures/{id}
{ "data": { …,
    "downAndDistance": { "down": 2, "yardsToGo": 6, "possession": "away", "ballOn": "away", "yardLine": 34,
      "goalToGo": false, "playType": "scrimmage" },
    … } }

Switch sport

Coverage across all 24

Same family · Pitch & field

The rest of the table

American Football is one query string away.

Swap ?sport=american-football for any other fixture sport and the same code keeps working. Free key, no card.

Get a free key Read the quickstart