Quick Start - AnySport

New API version, base URL https://data.anysport.io/v1/soccer

Step 1 — Get an API Key

Go to dashboard.anysport.io and sign up for an account.
After verifying your email, you’ll be automatically redirected to the dashboard.
Your API key is shown on the dashboard home page — copy it.

Step 2 — Authentication method

Pass the API key in the HTTP request header apikey. This is the only supported method — passing the key as a query parameter is not supported, and the legacy X-API-Key header name is no longer used. See Authentication for details.

curl -H "apikey: YOUR_API_KEY" \
  "https://data.anysport.io/v1/soccer/matches?date=2026-07-20"

Step 3 — Make your first request

query today’s fixtures:

curl -H "apikey: YOUR_API_KEY" \
  "https://data.anysport.io/v1/soccer/matches?date=2026-07-20&lang=zh-CN"

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://data.anysport.io/v1/soccer';

const res = await fetch(`${BASE_URL}/matches?date=2026-07-20&lang=zh-CN`, {
  headers: { 'apikey': API_KEY }
});
const { data } = await res.json();
console.log(data);

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://data.anysport.io/v1/soccer'

r = requests.get(
    f'{BASE_URL}/matches',
    params={'date': '2026-07-20', 'lang': 'zh-CN'},
    headers={'apikey': API_KEY}
)
r.raise_for_status()
matches = r.json()['data']

Example response Using the standard response envelope success / data / meta / traceId; full field descriptions in Matches:

{
  "success": true,
  "data": [
    {
      "match_id": "as_37f0da0520bb4e9a9588f80994cefc5b",
      "date": "2026-07-20",
      "time": "19:00",
      "status": "FT",
      "league": "World Cup",
      "league_id": "asl_62db9cfc3ebf4b87a44570b16668b23e",
      "season": "2026",
      "home": {
        "name": "England",
        "team_id": "ast_13e4e7eccd7640de91c13cffcf0c3ff2"
      },
      "away": {
        "name": "Argentina",
        "team_id": "ast_9137ee449e3b40a68149ca319373adaf"
      },
      "ht_score": "1-0",
      "ft_score": "2-1",
      "venue": ""
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 50,
    "total_pages": 1,
    "timestamp": "2026-07-20T10:00:00.000Z"
  },
  "traceId": "f11f21f6-0b68-438d-94b7-c8622470176f"
}

Step 4 — Discover in-progress matches and get live scores

The new /livescore endpoint queries a single match by match_id, so you first need to “discover” a match before fetching its score — this is a two-step process: 1) Query today’s fixtures using relative dates, and check the status value to determine which matches are in progress (see Recent Matches for details):

curl -H "apikey: YOUR_API_KEY" \
  "https://data.anysport.io/v1/soccer/matches/window?from_days=0&to_days=0"

A status of a plain numeric minute value or HT means the match is in progress; note down that match’s match_id. 2) Use the retrieved match_id to query the live score (see Live Score for details):

curl -H "apikey: YOUR_API_KEY" \
  "https://data.anysport.io/v1/soccer/livescore?match_id=as_3b37c382f39a4235aa93705f053b2da4"

async function getLiveScore(matchId) {
  const res = await fetch(
    `${BASE_URL}/livescore?match_id=${matchId}`,
    { headers: { 'apikey': API_KEY } }
  );
  const { data } = await res.json();
  return data[0];
}

To check whether a match has finished, always use phase == "finished" (this endpoint does not return a status field). For more granular, event-by-event data (goalscorers, yellow cards, corners, etc.), use Live Match Stats instead.

Next steps

For the complete authentication rules (header name, error codes), see Authentication.
Check the Endpoint Index: all 19 endpoints are organized by category — “Base Data → Fixtures & Matchups → Live Feeds → System/Metadata” — with a recommended integration order.
Need multi-language display? First call Localization to get the currently available lang values, then pass the lang parameter to each endpoint.
Want to integrate odds markets? Use Pre-Match Odds for pre-match odds and In-play Odds for live in-play markets.
For cross-cutting rules such as common error codes, ID prefix conventions, and *_label localization field rules, see the “Common Reference” section at the bottom of the index page.

​Step 1 — Get an API Key

​Step 2 — Authentication method

​Step 3 — Make your first request

​Step 4 — Discover in-progress matches and get live scores

​Next steps

Step 1 — Get an API Key

Step 2 — Authentication method

Step 3 — Make your first request

Step 4 — Discover in-progress matches and get live scores

Next steps