Statistics Endpoints


This endpoint allows various stats to be retrieved.

GET /stats/points_this_year

List of players who have earned the most points this year.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ

Example

https://api.ifpapinball.com/v1/stats/points_this_year?api_key=2FSp55Vy27vj6rAG
{
   "type":"Points this Year",
   "stats":[
      {
         "player_id":"10",
         "first_name":"Trent",
         "last_name":"Augenstein",
         "country_name":"United States",
         "country_code":"US",
         "wppr_points":"1279.53",
         "stats_rank":1
      },
      {
         "player_id":"63",
         "first_name":"Jorian",
         "last_name":"Engelbrektsson",
         "country_name":"Sweden",
         "country_code":"SE",
         "wppr_points":"988.46",
         "stats_rank":2
      },
      {
         "player_id":"1",
         "first_name":"Keith",
         "last_name":"Elwin",
         "country_name":"United States",
         "country_code":"US",
         "wppr_points":"937.23",
         "stats_rank":3
      },
      { ... more ... }
     ]
}

GET /stats/most_events

List of players who have played in the most events the 3 years.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ

Example

https://api.ifpapinball.com/v1/stats/most_events?api_key=2FSp55Vy27vj6rAG
{
   "type":"Most Events",
   "stats":[
      {
         "player_id":"1453",
         "first_name":"Nick",
         "last_name":"Zendejas",
         "country_name":"United States",
         "country_code":"US",
         "count":"207",
         "stats_rank":1
      },
      {
         "player_id":"5457",
         "first_name":"Pat",
         "last_name":"Castaldo",
         "country_name":"United States",
         "country_code":"US",
         "count":"200",
         "stats_rank":2
      },
      {
         "player_id":"10",
         "first_name":"Trent",
         "last_name":"Augenstein",
         "country_name":"United States",
         "country_code":"US",
         "count":"199",
         "stats_rank":3
      },
      { ... more ... }
   ]
}

GET /stats/country_players

Aggregate count of players by country.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ

Example

https://api.ifpapinball.com/v1/stats/country_players?api_key=2FSp55Vy27vj6rAG
{
   "type":"Players by Country",
   "stats":[
      {
         "country_name":"United States",
         "country_code":"US",
         "count":"9367",
         "stats_rank":1
      },
      {
         "country_name":"France",
         "country_code":"FR",
         "count":"1099",
         "stats_rank":2
      },
      { ... more ... }
   ]
}

Statistics Endpoints

GET /stats/events_by_year

Aggregate Event count, by year.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ

Example

https://api.ifpapinball.com/v1/stats/events_by_year?api_key=2FSp55Vy27vj6rAG
{
   "type":"Events Per Year",
   "stats":[
      {
         "Year":"2014",
         "country_count":"21",
         "periodic_count":"559",
         "count":"1020",
         "stats_rank":1
      },
      {
         "Year":"2013",
         "country_count":"22",
         "periodic_count":"963",
         "count":"1604",
         "stats_rank":2
      },
      { ... more ... }
   ]
}

GET /stats/players_by_year

Aggregate Players by Year.

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ

Example

https://api.ifpapinball.com/v1/stats/players_by_year?api_key=2FSp55Vy27vj6rAG
{
   "type":"Players by Year",
   "stats":[
      {
         "Year":"2014",
         "count":"7993",
         "previous_year_count":"4255",
         "previous_2_year_count":"2793",
         "stats_rank":1
      },
      {
         "Year":"2013",
         "count":"9835",
         "previous_year_count":"4161",
         "previous_2_year_count":"2834",
         "stats_rank":2
      },
      { ... more ... }
   ]
}

GET /stats/biggest_movers

Players who have moved the most positions since the beginning of the year (top 250).

Parameters

Required Parameter Description Example
Yes api_key Key needed to access API &api_key=RNDOAMGNAJTGQWKQ

Example

https://api.ifpapinball.com/v1/stats/biggest_movers?api_key=2FSp55Vy27vj6rAG
{
   "type":"Biggest Mover this year (top 250)",
   "stats":[
      {
         "player_id":"2605",
         "first_name":"Jeff",
         "last_name":"Smith",
         "country_name":"United States",
         "country_code":"US",
         "stats_rank":1
      },
      {
         "player_id":"16540",
         "first_name":"Bob",
         "last_name":"Jones",
         "country_name":"United States",
         "country_code":"US",
         "stats_rank":2
      },
      {
         "player_id":"31120",
         "first_name":"Adam",
         "last_name":"Mitchell",
         "country_name":"United States",
         "country_code":"US",
         "stats_rank":3
      },
      { ... more ... }
   ]
}