Matches Statistics

This endpoint allows you to retrieve the statistics from matches.

Types of the statistics: Receiver points won, Aces, Points won, Timeouts, Max points in a row, Service errors, Service points won.

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated every minute. Recommended Calls: Limit calls to 1 every minute.

Use Cases

Get statistics from a specific match_id
https://beach-volleyball.sportdevs.com/matches-statistics?match_id=eq.{match_id}

Query Parameters

• match_id integer

  Default value: eq.1

  The id of the match

• offset string

  Default value: 0

  Limiting and Pagination

• limit string

  Default value: 50

  Limiting and Pagination

• lang string

  Default value: en

  Multi-language

Responses

• 200

---

OK

application/json

• Schema
• Example (from schema)

---

Schema array

• match_id integer

  The id of the match

  Note: This is a Foreign Key to matches-live.id.

• statistics jsonb

  The statistics of the match

[
  {
    "match_id": 1,
    "statistics": [
      {
        "type": "Aces",
        "period": "1ST",
        "category": "Attacking",
        "away_team": "2",
        "home_team": "0"
      },
      {
        "type": "Aces",
        "period": "2ND",
        "category": "Attacking",
        "away_team": "1",
        "home_team": "2"
      },
      {
        "type": "Aces",
        "period": "3RD",
        "category": "Attacking",
        "away_team": "0",
        "home_team": "1"
      },
      {
        "type": "Aces",
        "period": "ALL",
        "category": "Attacking",
        "away_team": "3",
        "home_team": "3"
      },
      {
        "type": "Max points in a row",
        "period": "1ST",
        "category": "Attacking",
        "away_team": "2",
        "home_team": "3"
      },
      {
        "type": "Max points in a row",
        "period": "2ND",
        "category": "Attacking",
        "away_team": "2",
        "home_team": "3"
      },
      {
        "type": "Max points in a row",
        "period": "3RD",
        "category": "Attacking",
        "away_team": "3",
        "home_team": "6"
      },
      {
        "type": "Max points in a row",
        "period": "ALL",
        "category": "Attacking",
        "away_team": "3",
        "home_team": "6"
      },
      {
        "type": "Points won",
        "period": "1ST",
        "category": "Attacking",
        "away_team": "21",
        "home_team": "18"
      },
      {
        "type": "Points won",
        "period": "2ND",
        "category": "Attacking",
        "away_team": "16",
        "home_team": "21"
      },
      {
        "type": "Points won",
        "period": "3RD",
        "category": "Attacking",
        "away_team": "15",
        "home_team": "17"
      },
      {
        "type": "Points won",
        "period": "ALL",
        "category": "Attacking",
        "away_team": "52",
        "home_team": "56"
      },
      {
        "type": "Receiver points won",
        "period": "1ST",
        "category": "Attacking",
        "away_team": "11/18 (61%)",
        "home_team": "11/21 (52%)"
      },
      {
        "type": "Receiver points won",
        "period": "2ND",
        "category": "Attacking",
        "away_team": "14/21 (67%)",
        "home_team": "14/16 (88%)"
      },
      {
        "type": "Receiver points won",
        "period": "3RD",
        "category": "Attacking",
        "away_team": "9/17 (53%)",
        "home_team": "9/15 (60%)"
      },
      {
        "type": "Receiver points won",
        "period": "ALL",
        "category": "Attacking",
        "away_team": "34/56 (61%)",
        "home_team": "34/52 (65%)"
      },
      {
        "type": "Service errors",
        "period": "1ST",
        "category": "Attacking",
        "away_team": "2",
        "home_team": "2"
      },
      {
        "type": "Service errors",
        "period": "2ND",
        "category": "Attacking",
        "away_team": "2",
        "home_team": "1"
      },
      {
        "type": "Service errors",
        "period": "3RD",
        "category": "Attacking",
        "away_team": "4",
        "home_team": "0"
      },
      {
        "type": "Service errors",
        "period": "ALL",
        "category": "Attacking",
        "away_team": "8",
        "home_team": "3"
      },
      {
        "type": "Service points won",
        "period": "1ST",
        "category": "Attacking",
        "away_team": "10/21 (48%)",
        "home_team": "7/18 (39%)"
      },
      {
        "type": "Service points won",
        "period": "2ND",
        "category": "Attacking",
        "away_team": "2/16 (13%)",
        "home_team": "7/21 (33%)"
      },
      {
        "type": "Service points won",
        "period": "3RD",
        "category": "Attacking",
        "away_team": "6/15 (40%)",
        "home_team": "8/17 (47%)"
      },
      {
        "type": "Service points won",
        "period": "ALL",
        "category": "Attacking",
        "away_team": "18/52 (35%)",
        "home_team": "22/56 (39%)"
      },
      {
        "type": "Timeouts",
        "period": "1ST",
        "category": "Other",
        "away_team": "1",
        "home_team": "1"
      },
      {
        "type": "Timeouts",
        "period": "2ND",
        "category": "Other",
        "away_team": "1",
        "home_team": "0"
      },
      {
        "type": "Timeouts",
        "period": "3RD",
        "category": "Other",
        "away_team": "1",
        "home_team": "1"
      },
      {
        "type": "Timeouts",
        "period": "ALL",
        "category": "Other",
        "away_team": "3",
        "home_team": "2"
      }
    ]
  }
]

Loading...