get_head_to_head

2 creditsBasic lookupPOST /v1/get_head_to_head

Two clubs' meetings: record, goals and every result

Use it when you want two clubs' record against each other and their meetings, newest first.

Parameters

teamstringrequired: Club id, abbreviation or name.
opponentstringrequired: The other club.
limitintegeroptional: Max results listed (default 20); the summary counts every meeting.

Notes

Over MCP, ask for it in plain English and the client calls get_head_to_head itself. Point any MCP client at https://mcp.strikerapi.com/mcp?key=YOUR_API_KEY.
Each call costs 2 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.strikerapi.com/v1/get_head_to_head \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "team": "ARS",
  "opponent": "TOT",
  "limit": 3
}'

Response

json

{
  "teams": [
    {
      "team_id": "359",
      "abbrev": "ARS",
      "name": "Arsenal"
    },
    {
      "team_id": "367",
      "abbrev": "TOT",
      "name": "Tottenham Hotspur"
    }
  ],
  "summary": {
    "meetings": 50,
    "team_wins": 24,
    "draws": 16,
    "opponent_wins": 10,
    "team_goals": 98,
    "opponent_goals": 68,
    "first_meeting": "2001-11-17"
  },
  "games": [
    {
      "game_id": "740865",
      "season": 2025,
      "stage": "Regular Season",
      "date": "2026-02-22",
      "starts_at": "2026-02-22T16:30:00.000Z",
      "status": "final",
      "status_detail": "FT",
      "home": {
        "team_id": "367",
        "abbrev": "TOT",
        "name": "Tottenham Hotspur",
        "score": 1
      },
      "away": {
        "team_id": "359",
        "abbrev": "ARS",
        "name": "Arsenal",
        "score": 4
      },
      "result": "A",
      "neutral_site": null,
      "venue": "Tottenham Hotspur Stadium",
      "city": "London",
      "attendance": 61439
    },
    {
      "game_id": "740714",
      "season": 2025,
      "stage": "Regular Season",
      "date": "2025-11-23",
      "starts_at": "2025-11-23T16:30:00.000Z",
      "status": "final",
      "status_detail": "FT",
      "home": {
        "team_id": "359",
        "abbrev": "ARS",
        "name": "Arsenal",
        "score": 4
      },
      "away": {
        "team_id": "367",
        "abbrev": "TOT",
        "name": "Tottenham Hotspur",
        "score": 1
      },
      "result": "H",
      "neutral_site": null,
      "venue": "Emirates Stadium",
      "city": "London",
      "attendance": 60345
    },
    {
      "game_id": "704485",
      "season": 2024,
      "stage": "Regular Season",
      "date": "2025-01-15",
      "starts_at": "2025-01-15T20:00:00.000Z",
      "status": "final",
      "status_detail": "FT",
      "home": {
        "team_id": "359",
        "abbrev": "ARS",
        "name": "Arsenal",
        "score": 2
      },
      "away": {
        "team_id": "367",
        "abbrev": "TOT",
        "name": "Tottenham Hotspur",
        "score": 1
      },
      "result": "H",
      "neutral_site": null,
      "venue": "Emirates Stadium",
      "city": "London",
      "attendance": 60287
    }
  ],
  "count": 50
}