Yallashoot APIyallashoot.com ↗
Get live football and basketball scores, match status, kick-off times, and league data from yallashoot.com via a simple two-endpoint API.
What is the Yallashoot API?
The Yallashoot API provides live and upcoming match data from yallashoot.com across two endpoints, returning up to 10 matches per page with fields covering team names, current scores, match status, live minute, kick-off times, and league logos. The list_matches endpoint lets you filter by sport or league, while get_match delivers full detail for any individual match using identifiers returned from the listing.
curl -X GET 'https://api.parse.bot/scraper/88e42002-103f-478e-a0bc-2f854078f581/list_matches?sport=football' \ -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 yallashoot-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: YallaShoot SDK — live scores and upcoming matches."""
from parse_apis.yallashoot_com_api import YallaShoot, Sport, MatchNotFound
client = YallaShoot()
# Browse today's football matches (capped to 5 items total).
for match in client.matches.list(sport=Sport.FOOTBALL, limit=5):
print(match.home_team, match.home_score, "-", match.away_score, match.away_team,
f"[{match.status}]")
# Drill into the first match across all sports and refresh its detail.
match = client.matches.list(limit=1).first()
if match is not None:
try:
detail = match.refresh()
except MatchNotFound:
print("match disappeared (ended or removed)")
detail = None
else:
print(detail.league, detail.home_team, "vs", detail.away_team,
detail.home_score, "-", detail.away_score)
if detail.live_minute is not None:
print("minute:", detail.live_minute)
# Filter by league name discovered from the first hit.
if match is not None and detail is not None:
for m in client.matches.list(league=detail.league, limit=3):
print(m.match_id, m.home_team, "vs", m.away_team)
print("exercised: matches.list / match.refresh / Sport enum")
Lists matches shown on the site, 10 per page, ordered live matches first then upcoming matches by kick-off time. Each row is one match with league, both teams, current score (0 - 0 for matches not yet started), status LIVE or UPCOMING, the live minute when live, and the kick-off time as the site displays it (MM/DD HH:MM in the site's own clock, which `site_time` also reports; no year is published). Filter by sport (football or basketball) or by exact league name as it appears in `league` (e.g. English Premier League) — the two filters are mutually exclusive. `page` defaults to 1; `has_more`/`next_page` tell the caller whether another page exists, and a page past the end returns an empty `matches` array. `total_matches` is the site's published count for the selected filter. The site lists only live and upcoming matches; finished results are not published, so a match disappears once it ends.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based page number, 10 matches per page. |
| sport | string | Restrict to one sport. Omitted = all sports. Cannot be combined with league. |
| league | string | Exact league name as shown in the `league` field of match rows. An unknown name returns an empty list. Cannot be combined with sport. |
{
"type": "object",
"fields": {
"page": "integer, the page returned",
"matches": "array of match rows: match_id, sport_id (both strings, pass unchanged to get_match), sport, league, league_logo, status (LIVE|UPCOMING), live_minute (integer when LIVE else null), start_time (MM/DD HH:MM site clock, null when LIVE), home_team, away_team, home_logo, away_logo, home_score, away_score (integers)",
"has_more": "boolean, another page exists",
"next_page": "integer page number or null",
"site_time": "HH:MM clock shown by the site, the reference zone for start_time",
"total_matches": "integer, site-published total for the selected filter"
},
"sample": {
"data": {
"page": 1,
"matches": [
{
"sport": "football",
"league": "Argentine Division 1",
"status": "LIVE",
"match_id": "5554949",
"sport_id": "202",
"away_logo": "https://oss.yalla-shoot-admin.com/team/202d3fe41935df1c05e4f7ff10fe83d4cd3.png",
"away_team": "Club Atletico Tigre",
"home_logo": "https://oss.yalla-shoot-admin.com/team/2021d26e6cbb793f9b90407b9793a0c4d47.png",
"home_team": "Independiente Rivadavia",
"away_score": 2,
"home_score": 2,
"start_time": null,
"league_logo": "https://oss.yalla-shoot-admin.com/league/202d45f5d4193eb1fedb97d599b4d3eae46.png",
"live_minute": 0
},
{
"sport": "football",
"league": "English Premier League",
"status": "UPCOMING",
"match_id": "5546325",
"sport_id": "202",
"away_logo": "https://oss.yalla-shoot-admin.com/team/2027e33f58fc78c1323513f2c654548c1a7.png",
"away_team": "Manchester United",
"home_logo": "https://oss.yalla-shoot-admin.com/team/2028c015aae78525e41c152eaccf4b323d1.png",
"home_team": "Leeds United",
"away_score": 0,
"home_score": 0,
"start_time": "10/18 21:00",
"league_logo": "https://oss.yalla-shoot-admin.com/league/202b9961fb7412df4ce9c7de5832200119a.png",
"live_minute": null
}
],
"has_more": true,
"next_page": 2,
"site_time": "06:32",
"total_matches": 1423
},
"status": "success"
}
}About the Yallashoot API
What the API Returns
The API covers football and basketball matches as listed on yallashoot.com. list_matches returns a paginated array of match rows, each containing match_id, sport_id, sport, league, league_logo, status (either LIVE or UPCOMING), the current home_score and away_score, a live_minute integer when a match is in progress, and a start_time in the site's own clock zone. The response also includes total_matches, has_more, and next_page to support sequential pagination.
Filtering and Pagination
list_matches accepts three optional parameters: page (1-based, 10 matches per page), sport to restrict results to football or basketball, and league to filter by an exact league name as it appears in a league field from a previous response. The sport and league filters cannot be combined. Passing an unrecognized league name returns an empty match array rather than an error, so callers should validate league names against live results first. The site_time field in each response indicates the reference timezone for all start_time values.
Per-Match Detail
get_match accepts match_id and sport_id, both of which come directly from list_matches rows and must be passed unchanged. It returns the same core fields as the listing — league, status, home_score, away_score, start_time, live_minute — scoped to a single match. There is no additional historical or statistical data beyond what the match detail page on the site exposes.
The Yallashoot API is a managed, monitored endpoint for yallashoot.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when yallashoot.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 yallashoot.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?+
- Display a live score ticker for football and basketball matches filtered by a specific league.
- Build a match schedule widget that surfaces upcoming kick-off times using
start_timefromlist_matches. - Trigger notifications when a match
statustransitions from UPCOMING to LIVE by pollinglist_matches. - Show in-match progress by reading the
live_minutefield during active games. - Aggregate league logos and names from
league_logoresponses for a sports directory UI. - Monitor specific match outcomes by passing
match_idandsport_idtoget_matchat regular intervals. - Separate football and basketball feeds using the
sportfilter parameter.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does yallashoot.com offer an official developer API?+
What does `list_matches` return for a match that has not started yet?+
home_score and away_score are both returned as 0 and live_minute is null. The start_time field carries the scheduled kick-off in the site's clock, and site_time in the response shows the current reference clock so you can calculate time-to-kickoff.Can I filter matches by both sport and league at the same time?+
sport and league parameters on list_matches are mutually exclusive. You can use one or the other per request but not both together. To narrow by sport within a league, filter client-side using the sport field present on every returned match row.Does the API return historical match results or player-level statistics?+
How fresh is the live score data, and does the API cover all leagues on the site?+
league filter requires an exact league name as it appears in a list_matches response; leagues that the site does not currently list will return an empty result. Coverage is limited to the sports and leagues yallashoot.com surfaces at the time of each call.