API Documentation

The NFLArrest.com public API is now live! All endpoints return NFL Arrest data in JSON format. The base url for the first version of the api is http://nflarrest.com/api/v1/, next you have the endpoints Crime, Team, Player, and Position. Each endpoint has a collection of read only methods to get more information about each collection. All requests should be made with HTTP GET requests, any additional parameters listed below should be appended to the querystring (?param=value&param2=value2)

Crime

Top Crimes

NflArrest.com/api/v1/crime

The Top Crimes endpoint returns the most popular crimes in the NFL.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number
start_posintegeroffset for limit, for pageination

Top Players for Crime

NflArrest.com/api/v1/crime/topPlayers/CrimeID

The top players verb makes returns players who have commited the specified crime the most in the NFL.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Top Teams for Crime

NflArrest.com/api/v1/crime/topTeams/CrimeID

The Top Teams verb returns the teams with the most arrests in the NFL.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Top Positions for Crime

NflArrest.com/api/v1/crime/topPositions/CrimeID

The Top Teams verb returns the player positions with the most arrests in the NFL.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Crime Timeline

NflArrest.com/api/v1/crime/timeline/CrimeID

The Timeline verb returns a count of arrests in each month and year in the time period to be graphed overtime.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Arrest List for Crime

NflArrest.com/api/v1/crime/arrests/CrimeID

The arrests verb returns a list of arrests with details for the crime in question.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number
start_posintegeroffset for limit, use for pages

Team

Top Teams

NflArrest.com/api/v1/team

The Top teams endpoint returns the teams that have had the most arrests in the NFL.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number
start_posintegeroffset for limit, for pageination

Top Players from Team

NflArrest.com/api/v1/team/topPlayers/TeamID

The top players verb makes returns players who have been arrested for the most crimes from the specified team and the number of arrests for each player.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Top Crimes by Team

NflArrest.com/api/v1/team/topCrimes/TeamID

The Top Crimes verb returns the teams with the most arrests in the NFL. For example it shows crimes like DUI, Domestic Violence and Drugs as being among the top for many teams, and for each crime the number of arrests.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Search for Team

NflArrest.com/api/v1/team/search/

The search teams verb returns search results for teams in the NFL, it searches by City (Seattle, Wa), short code (sea), and team name (Seahawks).

Example
ParameterFormatDescription
termstringSearch Query
limitintegerLimit results to a specific number
start_posintegeroffset for limit, use for pages

Team Crime Timeline

NflArrest.com/api/v1/team/timeline/TeamID

The Timeline verb returns a count of arrests in each month and year in the time period to be graphed overtime for the specified team.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Arrest Details List

NflArrest.com/api/v1/team/arrests/TeamID

The arrests verb returns a list of arrests with details for the team in question.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Player

Top Players

NflArrest.com/api/v1/player

The Top Players endpoint returns the players that have had the most arrests in the NFL.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number
start_posintegeroffset for limit, for pageination

Top Crimes by Player

NflArrest.com/api/v1/player/topCrimes/PlayerName

The Top Crimes verb returns the crimes the NFL Player is most often charged with.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Search for Player

NflArrest.com/api/v1/player/search/

The search players verb returns search results for players in the NFL, it searches by player name.

Example
ParameterFormatDescription
termstringSearch Query
limitintegerLimit results to a specific number
start_posintegeroffset for limit, use for pages

Arrest Details List

NflArrest.com/api/v1/player/arrests/PlayerName

The arrests verb returns a list of arrests with details for the player in question.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Position

Top Positions

NflArrest.com/api/v1/position

The Top positions endpoint returns the positions that have had the most arrests in the NFL.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number
start_posintegeroffset for limit, for pageination

Top Teams by Position

NflArrest.com/api/v1/position/topTeams/PositionID

The top players verb makes returns players who have commited the most crimes from the specified team.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Top Crimes by Position

NflArrest.com/api/v1/position/topCrimes/PositionID

The Top Crimes verb returns the crimes with the most arrests committed by this position.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Position Crime Timeline

NflArrest.com/api/v1/position/timeline/PositionID

The Timeline verb returns a count of arrests in each month and year in the time period to be graphed overtime for the specified position.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number

Position Arrests

NflArrest.com/api/v1/position/arrests/PositionID

The Arrests verb returns a list of arrests for players playing the particular position.

Example
ParameterFormatDescription
start_date2000-01-31Filter data by start date
end_date2016-01-31Filter data by end date
limitintegerLimit results to a specific number