API

  • This API is experimental. We might shut it down at any time.
  • Please contact us before using the API. If people are using this API, we can prioritize supporting it.
  • It's not perfect but it works.
  • Limit yourself to one request per second. If you need to go faster than that, please contact us and we'll arrange for a bulk download.
  • All results are in JSON. For maximum enjoyment of the following examples, install JSONview for Chrome or something like that.


Retrieve simple details for a GGTracker player

Use the player's GGTracker ID, like this: http://api.ggtracker.com/api/v1/identities/1455.json

Retrieve simple details for a GGTracker match

Use the match's GGTracker ID, like this: http://api.ggtracker.com/api/v1/matches/3529593.json

Retrieve extended details for a GGTracker match

Use the match's GGTracker ID, like this: https://gg2-matchblobs-prod.s3.amazonaws.com/3529593

Retrieve match details for a GGTracker player's latest ten PvT 1v1 ladder matches

http://api.ggtracker.com/api/v1/matches?category=Ladder&game_type=1v1&identity_id=1455&page=1&paginate=true&race=protoss&vs_race=terran

Retrieve average APM for a GGTracker player

http://api.ggtracker.com/api/v1/matches?identity_id=1455&paginate=true&stats=apm(avg:[<1455])

Retrieve Spending Skill for 1v1 Ladder matches

http://api.ggtracker.com/api/v1/matches?category=Ladder&game_type=1v1&identity_id=1455&paginate=true&stats=spending_skill(avg:[<1455])
0.0 is bronze average, 1.0 is silver average, 2.0 gold, 3.0 plat, 4.0 diamond, 5.0 master, 6.0 grandmaster average.




Anything you see on the GGTracker website is accessible via the API as well. Have a question? Want something not documented here? Just ask!

login forgot password?
Sign up Forgot password?
sign up login