SPsportsdata
NFL v3 Headshots

Headshots

USA Today/IMAGN cropped action headshots for all active NFL players, delivered shortly after the season starts.

get/v3/nfl/headshots/{format}/Headshots

Request

Path parameters

format'JSON' | 'XML' required

Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.

Response

Success

PlayerIDinteger

The unique PlayerID of the player as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career

Namestring nullable

The player's full name

TeamIDinteger nullable

The unique ID of the team

Teamstring nullable

The abbreviation [Key] of the team

Positionstring nullable

The primary position of the player. Possible Values: C; CB; DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB; RB; S; SS; T; TE; WR

PreferredHostedHeadshotUrlstring nullable

The player's preferred hosted headshot URL. This returns the headshot with transparent background, if available.

PreferredHostedHeadshotUpdatedstring nullable

The last updated date of the player's preferred hosted headshot.

HostedHeadshotWithBackgroundUrlstring nullable

The player's hosted headshot URL.

HostedHeadshotWithBackgroundUpdatedstring nullable

The last updated date of the player's hosted headshot.

HostedHeadshotNoBackgroundUrlstring nullable

The player's transparent background hosted headshot URL.

HostedHeadshotNoBackgroundUpdatedstring nullable

The last updated date of the player's transparent background hosted headshot.

Changes

No recorded changes to this operation across all 2 revisions of this API.