API Codes list
2 years ago
East Sussex, England

Heyya gang,

I've extracted some data from the Speedrun.com API, however, I can't for the life of me find the detail of specific id/code meanings. I know runners names are anonymised but I'm talking specifically in regards to platform, region, gametype, genres, engines.

Can someone help me out with this?

YUMmy_Bacon5 likes this
United States

You should familiarize yourself with the API github page: https://github.com/speedruncomorg/api/tree/master/version1 Take a look at regions.md, platform.md, gametype.md, etc

https://www.speedrun.com/api/v1/regions/pr184lqn will for example return the USA region as that is what the ID of pr184lqn refers to.

YUMmy_Bacon5 likes this
East Sussex, England

So this code only relates to NTSC and does not list the code for any other region. It's the same with the other categories. I try to just search /regions/ but is just a 404?

YUMmy_Bacon5 likes this
United States

I found the issue.

As stupid as it sounds, you can't have the second / after the URL or GET request. https://www.speedrun.com/api/v1/regions will show all regions, while https://www.speedrun.com/api/v1/regions/ will return a 404.

For Platforms you will need to add ?max=1000 (or some high arbitrary limit) due to a high number of platforms that don't all show by default. Ex: https://www.speedrun.com/api/v1/platforms?&max=1000

This may apply to the other API codes you are interested in as well.

Edited by the author 2 years ago
East Sussex, England

Thank you so much for this. Litteraly exactly what I was looking for!

YUMmy_Bacon5 and Pear like this