Jet Set Radio API
Documentation

Home Swagger Docs

Introduction

Welcome to the jsrapi, the Jet Set Radio API! This documentation should help get you familiar with which resources are available and how to consume them with HTTP requests.

Base URL

The Base URL is the root URL for all of the API. If you ever get an error performing a request check the BaseURL first.

The Base URL is:

https://jetsetradio-api.onrender.com/v1/api/

Authentication

Jsrapi is a completely open API. No authentication is required. This means you are only able to do GET requests. If you find a mistake in the data, then send an email to jetsetradio.api@gmail.com or post on issue on the github page.

Rate Limiting

A request limit has been set to avoid malicious abuse(if anyone were to do that!). Limiting is set per IP address. You can make a total of up to 1000 requests per hour.

Sorting

All API routes support the sortBy and orderBy parameters. If orderBy is omitted, it will assume an ascending direction.

Example:

https://jetsetradio-api.onrender.com/v1/api/characters/jsr?sortBy=name&orderBy=desc

Limiting

All API routes support the limit parameter. You can use this to return a limited number of results instead of the entire response.

Example:

https://jetsetradio-api.onrender.com/v1/api/locations/jsrf?limit=5

Caching

All API routes utilize cache in memory to be able to serve content faster! The cache is automatically set to expire after 1 hour. The expiration is subject to future change.

Swagger Docs

You can use the swagger docs to view the available endpoints, see their parameters, and test the routes out!

___________________________________________________________

Resources

The following Resources are currently available to be consumed from. More resources will be added in the future.

  • Games
  • Characters
  • Locations
  • Levels
  • Graffiti Tags
  • Songs
  • Artists

The following Resources will be added in a future release of JSRAPI.

If you would like to contribute in adding any of these resources, see the Contributing Docs.

  • Graffiti Souls
  • Street Challenges
  • Jet Challenges
  • Gangs
  • Acheivements (JSR only)
  • Mystery Tapes
  • Grind Tricks

Each Resource is described more in detail below. An example request and response is provided for each resource. Note that the example responses provided on this page won't always match exactly what is returned from the example request. To get the most accurate data, it is best to try out the requests for yourself.

Games

A Game is a resource describing a published game developed within the Jet Set Radio Franchise.

Endpoints:

  • /games ==> Returns all Games
  • /games/:id ==> Returns a single Game by ID

Example Request:

https://jetsetradio-api.onrender.com/v1/api/games?name=Jet Set Radio Future

Example Response:

Characters

A Character is a resource describing a character from a specific Game.

Endpoints:

  • /characters ==> Returns all Characters
  • /characters/jsr ==> Returns all Jet Set Radio Characters
  • /characters/jsr/:id ==> Returns a single JSR Character by ID
  • /characters/jsrf ==> Returns all Jet Set Radio Future Characters
  • /characters/jsrf/:id ==> Returns a single JSRF Character by ID

Example Request:

https://jetsetradio-api.onrender.com/v1/api/characters/jsr

Example Response:

Locations

A Location is a resource describing a location or place from a specific Game.

Endpoints:

  • /locations ==> Returns all Locations
  • /locations/jsr ==> Returns all Jet Set Radio Locations
  • /locations/jsr/:id ==> Returns a single JSR Location by ID
  • /locations/jsrf ==> Returns all Jet Set Radio Future Locations
  • /locations/jsrf/:id ==> Returns a single JSRF Location by ID

Example Request:

https://jetsetradio-api.onrender.com/v1/api/locations?sortBy=name&limit=5

Example Response:

Levels

A Level is a resource describing a level from Jet Set Radio/Jet Grind Radio.

Endpoints:

  • /levels ==> Returns all Levels
  • /locations/:id ==> Returns a single Level by ID

Example Request:

https://jetsetradio-api.onrender.com/v1/api/levels?sortBy=chapter

Example Response:

Graffiti-Tags

A Graffiti Tag is a resource describing a Graffiti Point from a specific Game.

Endpoints:

  • /graffiti-tags ==> Returns all Graffiti-Tags
  • /graffiti-tags/jsr ==> Returns all Jet Set Radio Graffiti-Tags
  • /graffiti-tags/jsr/:id ==> Returns a single JSR Graffiti-Tag by ID
  • /graffiti-tags/jsrf ==> Returns all Jet Set Radio Future Graffiti-Tags
  • /graffiti-tags/jsrf/:id ==> Returns a single JSRF Graffiti-Tag by ID

Example Request:

https://jetsetradio-api.onrender.com/v1/api/graffiti-tags?sortBy=size&orderBy=desc

Example Response:

Songs

A Song is a resource describing a song from a specific Game.

Endpoints:

  • /songs ==> Returns all Songs
  • /songs/jsr ==> Returns all Jet Set Radio Songs
  • /songs/jsr/:id ==> Returns a single JSR Song by ID
  • /songs/jsrf ==> Returns all Jet Set Radio Future Songs
  • /songs/jsrf/:id ==> Returns a single JSRF Song by ID

Example Request:

https://jetsetradio-api.onrender.com/v1/api/songs?gameId=64285b7918c8a0231136dc5a

Example Response:

Artists

An Artist is a resource describing an artist that created a Song.

Endpoints:

  • /artists ==> Returns all Artists
  • /artists/:id ==> Returns a single Artist by ID
  • /artists/:id/songs ==> Returns all Songs by Artist

Example Request:

https://jetsetradio-api.onrender.com/v1/api/artists/643865b5af5362b86b844d75

Example Response: