---
title: "ESPN athlete"
method: GET
path: "/espn/athlete"
tags: ["ESPN"]
---

# ESPN athlete

`GET /espn/athlete`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/espn/athlete`
- Auth: API key in header `x-api-key`

Returns one athlete's bio/overview (name, position, jersey, physicals, current team). The `sport` enum accepts `football`, `basketball`, `baseball`, `hockey`, and `soccer`. The `league` enum accepts `nfl`, `college-football`, `nba`, `wnba`, `mens-college-basketball`, `womens-college-basketball`, `mlb`, `nhl`, `eng.1`, `esp.1`, `ita.1`, `ger.1`, `fra.1`, `usa.1`, and `uefa.champions`; it must be valid for the chosen sport.

## Query parameters

- `sport` 'football' | 'basketball' | 'baseball' | 'hockey' | 'soccer', required
- `league` 'nfl' | 'college-football' | 'nba' | 'wnba' | 'mens-college-basketball' | 'womens-college-basketball' | 'mlb' | 'nhl' | 'eng.1' | 'esp.1' | 'ita.1' | 'ger.1' | 'fra.1' | 'usa.1' | 'uefa.champions', required
- `athlete` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- EspnAthleteResponseDoc
  - `code` integer
  - `data` EspnAthleteResponse
    - `athlete` EspnAthlete
      - `age` integer
      - `display_height` string
      - `display_name` string
      - `display_weight` string
      - `full_name` string
      - `headshot` string
      - `id` string
      - `jersey` string
      - `position` string
      - `team` EspnTeamRef
        - `abbreviation` string: Short team code, for example `KC`.
        - `alternate_color` string: Team's secondary colour code, as ESPN gives it.
        - `color` string: Team's primary colour code, as ESPN gives it.
        - `display_name` string: Full team name, for example `Kansas City Chiefs`.
        - `id` string: ESPN team id, for example `12`. Use it as the `team` parameter of the team and roster endpoints.
        - `location` string: Team's city or region, for example `Kansas City`.
        - `logo` string: URL of the team logo image.
        - `name` string: Team nickname without the location, for example `Chiefs`.
        - `short_display_name` string: Shortened team name, for example `Chiefs`.
        - `uid` string: ESPN's unique identifier string for the team.
    - `fetched_at` string
    - `league` string
    - `source_url` string
    - `sport` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)