HIhighlightly
American Football.Head 2 Head

Get head 2 head games

Retrieve a list of the last ten head 2 head games between two teams. Compare the two teams to find out who is stronger based on their past match results.

Specify teamIdOne and teamIdTwo query parameters to retrieve the data. The order of team ids does not matter.

Below is an example of what you can achieve with the data:

H2H example

get/american-football/head-2-head

Request

Query parameters

teamIdOnenumber required
Example:92730
teamIdTwonumber required
Example:92731

Headers

x-rapidapi-hoststring required

sport-highlights-api.p.rapidapi.com

x-rapidapi-keystring required

Rapid API Token

Response

idnumber required
roundstring required
datestring required
leaguestring required
seasonnumber required

Example response

[
  {
    "id": 1,
    "round": "Regular Season - 32",
    "date": "2023-05-20T15:30:00.000Z",
    "league": "NFL",
    "season": 2023,
    "awayTeam": {
      "id": 1,
      "logo": "https://example.com/logos/team/111.png",
      "name": "Saints",
      "displayName": "New Orleans Saints",
      "abbreviation": "NO"
    },
    "homeTeam": {
      "id": 1,
      "logo": "https://example.com/logos/team/111.png",
      "name": "Saints",
      "displayName": "New Orleans Saints",
      "abbreviation": "NO"
    },
    "state": {
      "period": 2,
      "clock": 8,
      "description": "In progress",
      "score": {
        "current": "21 - 7",
        "firstPeriod": "0 - 0",
        "secondPeriod": "7 - 7",
        "thirdPeriod": "7 - 0",
        "fourthPeriod": "7 - 0",
        "firstOvertimePeriod": "7 - 0",
        "secondOvertimePeriod": "7 - 0"
      },
      "report": "Final"
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.