GET/api/v1/player/summary
Player career summary (appearances, goals, ability ratings, honours)
Access
- Request
GET https://api.sports.csap.ai/api/v1/player/summary- 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
- AvailableAny valid API key can call this endpoint.
- 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 3
| Parameter | Type | required | Example | Description |
|---|---|---|---|---|
| gpid | integer | required | 6917 | Platform player id (required) |
| competition_id | integer | optional | 287 | Only one competition |
| limit | integer | optional | 2 | Number of recent appearances |
Example request
curl "https://api.sports.csap.ai/api/v1/player/summary?gpid=6917&limit=2" \ -H "X-API-Key: YOUR_API_KEY"
Try it
Example response
{
"code": 0,
"data": {
"profile": {
"birthday": null,
"contract_until": null,
"gpid": 6917,
"height": null,
"name_zh": "索兹尔",
"name_zht": null,
"nationality": null,
"position": "D",
"position_id": 4,
"position_zh": "后卫",
"preferred_foot": null,
"shirt_number": "12",
"weight": null,
"name": "Guille González"
},
"summary": {
"apps": 1,
"assists": 0,
"avg_rating": null,
"goals": 0,
"minutes": 46
}
},
"message": "success",
"success": true
}Response fields 2
profileobject· 14
summaryobject· 5
Errors
| HTTP | message | When |
|---|---|---|
| 401 | missing API key / unauthorized | No X-API-Key, or the key is invalid or disabled |
| 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 |