AiScore APIaiscore.com ↗
Access AiScore football data via 2 endpoints. Retrieve scheduled fixtures by date and last-5-match team form stats including goals scored, conceded, and first-half averages.
What is the AiScore API?
The AiScore API provides 2 endpoints for retrieving football fixture schedules and team form statistics. Use get_scheduled_fixtures to pull all matches for any date, complete with match IDs, team slugs, competition names, and kickoff times. Use those identifiers to call get_match_team_form, which returns per-team averages across the last 5 completed matches for goals scored, goals conceded, and first-half goal figures.
curl -X GET 'https://api.parse.bot/scraper/4159e902-84d5-4812-bcee-311effc7486d/get_scheduled_fixtures?date=20260728' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace aiscore-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: AiScore SDK — bounded, re-runnable; every call capped."""
from parse_apis.aiscore_com_api import AiScore, ParseError
client = AiScore()
# List scheduled fixtures for a date, capped at 3.
for fixture in client.fixtures.list(date="20260725", limit=3):
print(fixture.home_team, "vs", fixture.away_team, "-", fixture.competition)
# Drill down: get team form for the first fixture.
first = client.fixtures.list(date="20260725", limit=1).first()
if first:
try:
form = first.team_form()
print(form.home_team, "stats:", form.home_team_stats.goals_scored_per_game, "GS/G,",
form.home_team_stats.goals_conceded_per_game, "GC/G")
print(form.away_team, "stats:", form.away_team_stats.goals_scored_per_game, "GS/G,",
form.away_team_stats.goals_conceded_per_game, "GC/G")
for match in form.home_team_last_5[:3]:
print(" ", match.home_team, match.ft_score, match.away_team, "HT:", match.ht_score)
except ParseError as e:
print("error:", e)
print("exercised: fixtures.list / fixture.team_form")
Retrieves all scheduled football fixtures for a given date. Returns match IDs, team names with URL slugs, competition names, and kickoff times. Results are returned in a single response. Each fixture provides the identifiers needed to retrieve team form data.
| Param | Type | Description |
|---|---|---|
| daterequired | string | Date in YYYYMMDD format (e.g. 20260725). |
{
"type": "object",
"fields": {
"total": "integer count of scheduled fixtures",
"fixtures": "array of fixture objects with match_id, competition, home/away team names and slugs, match_time"
},
"sample": {
"total": 1081,
"fixtures": [
{
"match_id": "zrkn6i48321swql",
"away_team": "Barracas Central",
"home_team": "River Plate",
"match_time": 1785060600,
"competition": "Argentine Division 1",
"away_team_slug": "barracas-central",
"home_team_slug": "river-plate"
}
]
}
}About the AiScore API
Scheduled Fixtures
get_scheduled_fixtures accepts a single date parameter in YYYYMMDD format and returns every scheduled football match for that day. Each fixture object includes a match_id, home and away team names and URL slugs, the competition name, and the match_time. The response also includes a total count of fixtures. The match_id, home_slug, and away_slug fields from this endpoint are the required inputs for the team form endpoint.
Team Form and Match Statistics
get_match_team_form takes a match_id, home_slug, and away_slug and returns form data for both teams. The home_team_stats and away_team_stats objects each contain four calculated averages over the team's last 5 finished matches: goals_scored_per_game, goals_conceded_per_game, first_half_goals_scored_per_game, and first_half_goals_conceded_per_game. Alongside the aggregated stats, home_team_last_5 and away_team_last_5 arrays list the individual match results with scores and per-match details.
Coverage and Data Shape
All statistics are calculated from exactly 5 most-recent completed matches. The endpoint does not expose standings, player-level data, odds, or live in-play scores — it is scoped to pre-match team form and fixture scheduling. Both endpoints return a single response with no pagination.
The AiScore API is a managed, monitored endpoint for aiscore.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when aiscore.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official aiscore.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a daily football fixture list by date using
get_scheduled_fixtureswith thedateparameter. - Compare home and away team attacking output using
goals_scored_per_gamefromget_match_team_form. - Identify defensively vulnerable teams by sorting on
goals_conceded_per_gameacross multiple fixtures. - Analyze first-half scoring tendencies using
first_half_goals_scored_per_gamefor both teams before a match. - Populate a pre-match dashboard with team slugs, competition names, and kickoff times from fixture data.
- Feed form averages into a prediction model using the last-5-match stats from
home_team_statsandaway_team_stats. - Cross-reference
home_team_last_5andaway_team_last_5arrays for head-to-head context alongside team averages.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does AiScore have an official developer API?+
What does `get_match_team_form` return exactly?+
get_match_team_form returns four averaged statistics for each team — goals_scored_per_game, goals_conceded_per_game, first_half_goals_scored_per_game, and first_half_goals_conceded_per_game — calculated over the team's last 5 completed matches. It also returns the raw home_team_last_5 and away_team_last_5 arrays with individual match scores, and the home_team and away_team name strings.