← Back to API docs

GET/api/v1/player/summary

Player career summary (appearances, goals, ability ratings, honours)
Platform extensionsactivebetacoreAvailable

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

ParameterTyperequiredExampleDescription
gpidintegerrequired6917Platform player id (required)
competition_idintegeroptional287Only one competition
limitintegeroptional2Number 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

Real response with an external key at 09/11/2026, 14:29 UTC: HTTP 200, 1 rows, 105 ms (data cut to 2 rows)

{
  "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

HTTPmessageWhen
401missing API key / unauthorizedNo X-API-Key, or the key is invalid or disabled
429rate limit exceeded / daily quota exceededThe key's per-minute rate or daily quota is exceeded
429server busy, retry laterThe server's concurrency slots are full (only 2 heavy requests at a time); retry after Retry-After seconds
500query errorThe query failed on the server; you may retry