---
title: "SofaScore league draft picks"
method: GET
path: "/sofascore/draft-picks"
tags: ["SofaScore"]
---

# SofaScore league draft picks

`GET /sofascore/draft-picks`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/draft-picks`
- Auth: API key in header `x-api-key`

Returns one round of a league draft: each pick with the overall and in-round number, the drafting team, and the drafted prospect (name, position, college or club, top-prospect flag and the player id when SofaScore has one), plus the teams that hold no pick in that round. The `league` enum accepts `nba` (rounds 1 and 2) and `nfl` (rounds 1 to 7); other rounds return 400. Get `year` from the draft endpoint's `draft.year` and `previous_draft.year`; SofaScore keeps only recent drafts, so an older year returns 404. Returns 404 when SofaScore has no picks for that year and round.

## Query parameters

- `league` 'nba' | 'nfl', required
- `year` string, required
- `round` integer, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreDraftPicksResponseDoc
  - `code` integer
  - `data` SofascoreDraftPicksResponse
    - `count` integer
    - `fetched_at` string
    - `league` string
    - `picks` SofascoreDraftPick[]
      - `overall_pick` integer
      - `pick_in_round` integer
      - `prospect` SofascoreDraftProspect
        - `first_name` string
        - `is_top_prospect` boolean
        - `last_name` string
        - `name` string
        - `player` SofascorePlayerBrief
          - `id` integer
          - `jersey_number` string
          - `name` string
          - `position` string
          - `short_name` string
          - `slug` string
        - `position` string
        - `school` SofascoreTeamRef
          - `country` string: Country the team belongs to.
          - `id` integer: SofaScore team id. Use it with the team endpoints.
          - `name` string: Full team name.
          - `national` boolean: True for a national team.
          - `short_name` string: Shortened team name.
          - `slug` string: URL slug of the team on SofaScore.
        - `school_name` string
      - `round` integer
      - `team` SofascoreTeamRef
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
    - `round` integer
    - `source_url` string
    - `teams_without_round_pick` SofascoreTeamRef[]
      - `country` string: Country the team belongs to.
      - `id` integer: SofaScore team id. Use it with the team endpoints.
      - `name` string: Full team name.
      - `national` boolean: True for a national team.
      - `short_name` string: Shortened team name.
      - `slug` string: URL slug of the team on SofaScore.
    - `year` integer
  - `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/028417aa35bb?raw)