search

Soccer

hashtag
Areas

Return the list of all available areas for all active seasons (supported by at least two data sources).

Credit Consumption: 2 API call credit per request

Endpoint: GET /v2/sport/soccer/areas

Query Parameters:

  • name(string) – Area name (Optional parameters). Example: Germany

  • code(string) – Area code (Optional parameters). Example: DEU

Sample Request

curl -X GET "http://api-ai-oracle.apro.com/v2/sport/soccer/areas"
curl -X GET "http://api-ai-oracle.apro.com/v2/sport/soccer/areas?name=Germany"
curl -X GET "http://api-ai-oracle.apro.com/v2/sport/soccer/areas?code=DEU"
curl -X GET "http://api-ai-oracle.apro.com/v2/sport/soccer/areas?name=Germany,Spain&code=DEU,ESP"

Sample Response

{
    "status": {
        "timestamp": 1768877186508,
        "code": 200,
        "message": ""
    },
    "data": {
        "areas": [
            {
                "id": "155706d349a7195340f9e003e85d0754f9f040f514cf2993d05da806833db7db",
                "name": "Germany",
                "code": "DEU"
            }
        ],
        "provider_areas": [
            {
                "provider_name": "apisports",
                "areas": [
                    {
                        "name": "Germany",
                        "code": "DEU",
                        "raw_name": "Germany",
                        "raw_code": "DE",
                        "raw_flag": "https://media.api-sports.io/flags/de.svg"
                    }
                ],
                "count": 1
            },
            {
                "provider_name": "footballdata",
                "areas": [
                    {
                        "id": "2088",
                        "name": "Germany",
                        "code": "DEU",
                        "raw_name": "Germany",
                        "raw_code": "DEU",
                        "raw_flag": "https://crests.football-data.org/759.svg"
                    }
                ],
                "count": 1
            },
            {
                "provider_name": "sportradar",
                "areas": [
                    {
                        "id": "sr:category:30",
                        "name": "Germany",
                        "code": "DEU",
                        "raw_name": "Germany",
                        "raw_code": "DEU"
                    }
                ],
                "count": 1
            }
        ],
        "total_areas": 1,
        "timestamp": "2026-01-20T02:46:26.441581774Z",
        "signatures": [
            {
               "signer": "0x...",                
                "hash": "0x...",            
                "signature": "0x...",
                "timestamp": 1768877186419
            }
        ]
    }
}

hashtag
Leagues

Get the list of leagues, with support for filtering by area, name, and season

Credit Consumption: 3 API call credit per request

Endpoint: GET /v2/sport/soccer/leagues

Query Parameters:

  • area(string) – Area name (Optional parameters). Example: Germany

  • name(string) – League name (Optional parameters). Example: Bundesliga

  • season(string) – League season (Optional parameters). Example: 2025/2026

Currently, only this is supported.Sample Request

Sample Response

hashtag
Teams

Get the list of teams for a specified league and season (supported by at least two data sources)

Credit Consumption: 3 API call credit per request

Endpoint: GET /v2/sport/soccer/teams

Query Parameters:

  • league / league_id – League name or ID (Required parameters). Example:La Liga b8009fed94586e5882889634d90245253643533fefb3279dead4ac1e9a40009d

  • season / season_id – Season name or ID (Required parameters). Example: 2025/2026 1d4374999c4c09741175bb04c05298d63bfc7f628d494cb1642cd6f3cc78ee61

  • name – Team name (fuzzy match) (Optional parameters). Example: Alaves

  • code – Team code (exact match) (Optional parameters). Example: ALA

Sample Request

Sample Response

hashtag
Games

Get the match data for a specified league and season (with support for multiple filtering options).

Credit Consumption: 5 API call credit per request

Endpoint: GET /v2/sport/soccer/games

Query Parameters:

  • league / league_id – League name or ID (Required parameter). Example: La Liga b8009fed94586e5882889634d90245253643533fefb3279dead4ac1e9a40009d

  • season / season_id – Season name or ID (Required parameter). Example: 2025/2026 1d4374999c4c09741175bb04c05298d63bfc7f628d494cb1642cd6f3cc78ee61

  • game_id – Match ID (hash) (Optional parameter). Example: c83c21752c87ac28e24d9dd91578609a243e4d53a8a15564316966e342d1f4ba

  • team – Team name or code (matches home or away team) (Optional parameter). Example: Alaves / ALA

  • date – Match date (format: YYYY-MM-DD) (Optional parameter). Example: 2025-08-15

  • round – Round (Optional parameter). Example: Regular Season - 1

  • live – Whether the match is currently live (true/false) (Optional parameter). Example: true

Sample Request

Sample Response

PreviousNBANextContact Info

Last updated