Reference — Images, Caching, Errors

Image / Logo URLs

Looking for the football statistic ID mapping? It is served as a machine-readable dictionary at GET /reference/football/stat-ids (no API key, quota-free, cached 1 hour). See Match Team Stats.

All logo / image / photo fields in V6 responses are filenames, not full URLs — for example "logo": "3315dd709ea94735a8a138478133a2a3.png!w80". Fetch the asset from the authenticated V6 image endpoint:

GET https://api.sportsapipro.com/v6/{sport}/images/{type}/{filename}
     -H "x-api-key: YOUR_API_KEY"

{type} is one of teams, competitions, tournaments, players, coaches, referees, venues, countries. Pass the filename exactly as it appears in the response, including any !w80 thumbnail suffix.

Asset	Request
Team logo	`/v6/football/images/teams/3315dd709ea94735a8a138478133a2a3.png`
Team logo (80 px thumbnail)	`/v6/football/images/teams/3315dd709ea94735a8a138478133a2a3.png!w80`
Competition logo	`/v6/football/images/competitions/161a36970ea4ee8e37f2604c6550501d.png`
Country flag	`/v6/football/images/countries/3ad08396dc5afa78f34f548eea3c1d64.png`
Player photo	`/v6/football/images/players/{filename}`

If you would rather not classify the field, omit the type — /v6/{sport}/images/{filename} — and we resolve the asset type for you.

curl -H "x-api-key: $KEY" \
  "https://api.sportsapipro.com/v6/football/images/teams/3315dd709ea94735a8a138478133a2a3.png!w80" \
  -o team.png

The old https://img.sportsapipro.com/{filename} host is retired and no longer serves traffic. Use the endpoint above.

Notes:

Requests require x-api-key and count against your daily quota, the same as V2 images. V1 images (/v1/{sport}/images/...) remain free if you need high-volume logo serving without spending quota.
Responses are cached for 24 hours (Cache-Control: public, max-age=86400). Filenames change when the asset changes, so you can cache aggressively on your side.
A filename that no longer exists upstream returns 404 {"success": false, "error": "Image not found upstream"}. An unknown {type} returns 400.
Because the endpoint is authenticated, do not put the URL straight into a public <img src> with your key. Proxy it from your backend or cache the bytes on your own CDN.

Caching Behavior

V6 ships an internal cache to absorb upstream rate limits. Every response includes a cacheHit: boolean flag.

Bucket	Endpoints	TTL
Live (5 s)	`/team-stats`, `/commentary`, `/ball-by-ball`	5 seconds
Near-live (30 s)	`/odds`, `/odds/{companyId}`, `/predictions`	30 seconds
Per-match (60 s)	`/match/{id}`, `/match/{id}/incidents`, `/match/{id}/stats`, `/match/{id}/lineups`, `/match/{id}/h2h`, `/match/{id}/history`, `/match/{id}/tables`, `/match/{id}/scorecards`	60 seconds
Reference (10 min)	Competitions, teams, players, transfers, world-cup endpoints	10 minutes
Static (1 hour)	`/fifa/rankings`, `/rankings`, `/countries`, `/sports`, `/counts`	1 hour

You can inspect the cache via:

GET /api/v1/cache/stats

Error Handling

V6 errors are always JSON, wrapped in { success: false, error: "..." }. Common cases:

HTTP	`error` body	Cause
401	`{ "success": false, "error": "Unauthorized" }`	Missing or invalid `x-api-key`
404	`{ "success": false, "error": "Match not found" }`	Match ID is wrong, expired, or from a different sport
429	`{ "success": false, "error": "Rate limit exceeded" }`	Your daily / per-minute quota tripped
5xx	`{ "success": false, "error": "Upstream timeout" }`	AiScore protobuf upstream was slow — retry with backoff

Key Differences vs. Other Versions

Capability	V1 (365scores)	V2 (Football-data)	V6 (AiScore)
Live scores	✅	✅	✅
Incidents with player IDs	Partial	✅	✅
Multi-bookmaker odds	❌	❌	✅ (3 formats)
3D animation widget	❌	❌	✅
Transfers (global)	❌	Partial	✅ (13.4k+ paginated)
FIFA rankings history	❌	❌	✅ (348 pubTimes)
World Cup archive 1930→	❌	Partial	✅
Esports stats	❌	❌	✅
Player salary + top earners	❌	❌	✅

Pick V6 when you need deep historical archives, multi-bookmaker odds, and AiScore-specific assets (animation widget, transfers feed, FIFA ranking timeline).

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Reference — Images, Caching, Errors

Image / Logo URLs

Caching Behavior

Error Handling

Key Differences vs. Other Versions

​Image / Logo URLs

​Caching Behavior

​Error Handling

​Key Differences vs. Other Versions

Image / Logo URLs

Caching Behavior

Error Handling

Key Differences vs. Other Versions