Quickstart
Make your first request to the HesGoals Public API in under two minutes. All you need is an API key.
Get your API key
Go to the Developer Dashboard to create an account and generate your API key. Keys are prefixed with sk_live_ for easy identification.
Your API key is shown only once when created. Store it securely — you cannot retrieve it later.
Send your first request
Pass your API key in the Authorization header as a Bearer token. Here are examples in different languages:
# Make your first request curl https://hesgoals1.co.uk/api/public/v1/matches?per_page=2 \ -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx"
const API_KEY = 'sk_live_xxxxxxxxxxxxx';
const res = await fetch('/api/public/v1/matches?per_page=5', {
headers: { Authorization: `Bearer ${API_KEY}` },
});
const { data, meta } = await res.json();
console.log(`Found ${meta.total} matches`);
console.log(data);import requests
API_KEY = "sk_live_xxxxxxxxxxxxx"
headers = {"Authorization": f"Bearer {API_KEY}"}
res = requests.get(
"https://hesgoals1.co.uk/api/public/v1/matches",
headers=headers,
params={"per_page": 5}
)
data = res.json()
print(f"Found {data['meta']['total']} matches")
for match in data["data"]:
print(f" {match['home_team']['name']} vs {match['away_team']['name']}")Read the response
Responses are standard JSON. List endpoints include a data array and a meta object with pagination info.
{
"data": [
{
"id": "match_8f3k2a",
"match_number": 1,
"competition": {
"id": "season_UCUznkuK",
"name": "FIFA World Cup 2026",
"year": 2026
},
"home_team": {
"id": "team_Nb8itbVl",
"name": "Mexico",
"code": "MEX"
},
"away_team": {
"id": "team_4SetK8JF",
"name": "United States",
"code": "USA"
},
"status": "scheduled",
"home_score": 0,
"away_score": 0,
"scheduled_at": "2026-06-11T20:00:00.000Z",
"venue": {
"name": "Estadio Azteca",
"city": "Mexico City"
}
}
],
"meta": {
"page": 1,
"per_page": 5,
"total": 104
}
}Check your usage
Monitor your API usage with the /v1/usage endpoint or through the Developer Dashboard. Rate limit info is included in every response header.
Explore the API
That's it! Head into the API references to see all available endpoints, query parameters, and response schemas.