SportInfo Public API

A REST API for FIFA World Cup data — match schedules, live scores, team rosters, player stats, and group standings. All responses are standard JSON with Bearer token authentication.

Base URL

All Public API endpoints live under:

url

https://your-domain.com/api/public/v1

Authentication

The Public API uses Bearer Token authentication. Include your API key in the Authorization header on every request:

http header

Authorization: Bearer sk_live_xxxxxxxxxxxxx

ℹ️

API keys are created from the Developer Dashboard. Each key is shown only once — store it securely. Keys are prefixed with sk_live_ for easy identification.

Response format

All responses follow a consistent JSON structure:

json — success (list)

{
  "data": [...],
  "meta": { "page": 1, "per_page": 20, "total": 100 }
}

json — error

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 60 seconds.",
    "status": 429
  }
}

Rate limits

Rate limits are enforced per API key. Response headers include rate limit metadata:

X-RateLimit-LimitRequests per minute

X-RateLimit-RemainingRemaining requests in window

X-RateLimit-ResetUnix timestamp when window resets

API Reference

Every endpoint uses stable public IDs (e.g. team_8f3k2a) and supports pagination, filtering, and sorting.

🏟️

Competitions

List all competitions (seasons) with year, name, and host information.

📅

Matches

List all matches with filters. Fetch events, lineups, and stats for any match.

🏳️

Teams

List all qualified teams with flags, codes, and confederation data.

👤

Players

Search and paginate players. Fetch individual profiles with positions and stats.

📊

Standings

Group-stage standings with points, goal difference, and rank for each team.

Next steps

Head to the Quickstart to make your first API call, or jump directly into any API reference above.

Next →Quickstart

Hesgoals: FIFA World Cup 2026 scores, live results, standings