Description
Returns the records of the team queried
Request rate: 120/min
Request rate: 120/min
Access
- Request
GET https://api.sports.csap.ai/api/v1/teams/records/detail- Auth
- Header X-API-Key: <your key> (Authorization: Bearer <key> also works; ?key= is still accepted but discouraged, because the key ends up in URLs and logs)
- External keys
- Available (scoped)External keys can call it, but only data inside the open scope is returned.
- Rate limits
- 3000 per minute · 200000 per day · Set per key (rate_per_min and quota_daily returned by /api/v1/account are authoritative; the numbers above are a trial key's). Beyond them the answer is 429. In addition, heavy requests such as whole-table snapshots and statistics lists without a match id are processed 2 at a time for the whole platform; a request that cannot get a slot receives 429 with Retry-After. Responses do not carry X-RateLimit-* headers for now. See the general guide
Request parameters 2
| Parameter | Type | required | Example | Description |
|---|---|---|---|---|
| ids | string | required | Several ids, comma separated, 200 at most | |
| type | string | required | Record type: 1 youngest goalscorer, 2 oldest goalscorer, 3 goals conceded record |
Example request
curl "https://api.sports.csap.ai/api/v1/teams/records/detail" \ -H "X-API-Key: YOUR_API_KEY"
Try it
Example response
{
"code": 0,
"data": [
{
"age": null,
"goals": null,
"id": 51,
"matches": null,
"owner_id": "281",
"player_id": "174694",
"player_name": "Rony Lopes",
"record": null,
"record_type": "youngest_scorer",
"scope": "team",
"season_id": null,
"source": "S6",
"team_id": "281",
"time": 1357344000,
"updated_at": 1793900581565,
"value": null
},
{
"age": null,
"goals": null,
"id": 52,
"matches": null,
"owner_id": "281",
"player_id": "1513598",
"player_name": "Ron Frost",
"record": null,
"record_type": "youngest_scorer",
"scope": "team",
"season_id": null,
"source": "S6",
"team_id": "281",
"time": -185500800,
"updated_at": 1793900581565,
"value": null
}
],
"message": "success",
"success": true
}Response fields 16
agestringnullableAge
Example: "17/2/23"goalsnullnullableGoals
idintegerRecord id; paging cursor (the id parameter returns records >= this value). In match endpoints it is the platform match id (gmid)
Example: 51matchesnullnullableMatches
owner_idstringId of the owning team / competition
Example: "281"player_idstringPlayer id
Example: "174694"player_namestringPlayer name
Example: "Rony Lopes"recordnullnullableTeam record list
record_typestringRecord type
Example: "youngest_scorer"scopestringScope
Example: "team"season_idnullnullableSeason id
sourcestringSource code (S1, S2…)
Example: "S6"team_idstringTeam id
Example: "281"timeintegerTime / minute
Example: 1357344000updated_atintegerLast update time (UTC, ISO 8601; incremental sync with the time parameter goes by it)
Example: 1793900581565valuenullnullableValue
Errors
| HTTP | message | When |
|---|---|---|
| 401 | missing API key / unauthorized | No X-API-Key, or the key is invalid or disabled |
| 400 | bad param … | Malformed parameter (e.g. id is neither a number nor u<uid>) |
| 301 | match merged into <gmid> | Queried by an old match id that has been merged into a new gmid: Location points to the new address and the body carries moved_to |
| 404 | not found | The match / team / competition does not exist, or is outside what this key can see (external keys see only matches inside the open coverage) |
| 429 | rate limit exceeded / daily quota exceeded | The key's per-minute rate or daily quota is exceeded |
| 429 | server busy, retry later | The server's concurrency slots are full (only 2 heavy requests at a time); retry after Retry-After seconds |
| 500 | query error | The query failed on the server; you may retry |