npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

lol-stats-api

v1.1.3

Published

A configurable League of Legends API

Downloads

33

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

danielsogldanielsogl

Keywords

league of legendslolapiriot games

Readme

lol-stats-api

NPM

npm version dependencies Status

A configurable League of Legends API. It uses the official developer's API offered by Riot Games, so you will need an API key to be able to use it. Here's the complete documentation of their API. In the documentation below there will be references to the official methods used for each route.

Download

lol-stats-api is installable via:

  • GitHub git clone https://github.com/danielsogl/lol-stats-api.git
  • npm: npm install lol-stats-api

Getting started

To start the API server run the following command:

node run start

You will have to do a one time configuration to be able to use the API. At the prompt you will be asked for the default API key to be used for the calls, the port on which the API will run, the default region to be used for the API calls and the caching strategy.

Resetting the configuration

You can change the provided API configuration at any time, simply by running:

npm run resetconfig

Documentation

The API's calls are mapped to various API methods from Riot Game's documentation. All URLs can accept apiKey and region as query string parameters, if you want to do calls for a different region or with a different key than the specified defaults.

Routes

/account/:accountId

Retrieves a summoner by accountId.

/account/:accountId/matchlist

Retrieves matchlist by accountId.

Querystring parameters

  • season - Comma-separated list of season ids to use for filtering matchlist.

  • queue - Comma-separated list of ranked queue types to use for filtering matchlist.

    • Possible values: RANKED_SOLO_5x5 | RANKED_FLEX_SR | RANKED_FLEX_TT.

  • beginIndex - The begin index to use for fetching games.

    • Possible values: Any positive natural number.

  • beginTime - The begin time to use for fetching games specified as epoch milliseconds.

    • Possible values: Any positive natural number.

  • endTime - The end time to use for fetching games specified as epoch milliseconds.

    • Possible values: Any positive natural number.

  • endIndex - The end index to use for fetching games.

    • Possible values: Any positive natural number.

/account/:accountId/matchlist/recent

Retrieves matchlist for last 20 matches played on given accountId.

/champions

Retrieves the status of all champions.

Querystring parameters

  • freeToPlay - Filter param to revireve only free to play champions.
    • Possible values: Anything

/champions/:id

Retrieves the status of given champion id.

/featured-games

Retrieves a list of featured games.

/leagues/challenger

Retrieves the challenger tier leagues

Querystring parameters

  • queue - The queue type.
    • Possible values: "RANKED_SOLO_5x5" | "RANKED_FLEX_SR" | "RANKED_FLEX_TT"

/leagues/master

Retrieves the master tier leagues

Querystring parameters

  • queue - The queue type.
    • Possible values: "RANKED_SOLO_5x5" | "RANKED_FLEX_SR" | "RANKED_FLEX_TT"

/matches/:id

Retrieves a match by its id.

/matches/:matchId/timeline

Retrieves a match's timeline by matchId.

/static/champions

Retrieves champion list.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

  • dataById - If specified as true, the returned data map will use the champions' id as the keys. If not specified or specified as false, the returned data map will use the champions' keys instead.

  • champData - Tags to return additional data. Only id, key, name, and title are returned by default if this parameter isn't specified. To return all additional data, use the tag 'all'.

    • Possible values: "all" | "allytips" | "altimages" | "blurb" | "enemytips" | "image" | "info" | "lore" | "partype" | "passive" | "recommended" | "skins" | "spells" | "stats" | "tags"

/static/champions/:id

Retrieves a champion by its id.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

  • champData - Tags to return additional data. Only id, key, name, and title are returned by default if this parameter isn't specified. To return all additional data, use the tag 'all'.

    • Possible values: "all" | "allytips" | "altimages" | "blurb" | "enemytips" | "image" | "info" | "lore" | "partype" | "passive" | "recommended" | "skins" | "spells" | "stats" | "tags"

/static/items

Retrieves a list of all items in the game.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

  • itemData - Tags to return additional data. Only id, name, plaintext, group, and description are returned by default if this parameter isn't specified. To return all additional data, use the tag 'all'.

    • Possible values: "all" | "colloq" | "consumeOnFull" | "consumed" | "depth" | "effect" | "from" | "gold" | "hideFromAll" | "image" | "inStore" | "into" | "maps" | "requiredChampion" | "sanitizedDescription" | "specialRecipe" | "stacks" | "stats" | "tags"

/static/items/:id

Retrieves an item by id.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

  • itemData - Tags to return additional data. Only id, name, plaintext, group, and description are returned by default if this parameter isn't specified. To return all additional data, use the tag 'all'.

    • Possible values: "all" | "colloq" | "consumeOnFull" | "consumed" | "depth" | "effect" | "from" | "gold" | "hideFromAll" | "image" | "inStore" | "into" | "maps" | "requiredChampion" | "sanitizedDescription" | "specialRecipe" | "stacks" | "stats" | "tags"

/static/languages

Retrieves supported languages data.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

/static/language-strings

Retrieves language string data.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

/static/maps

Retrieves map data.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

/static/masteries

Retrieves the masteries list.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

  • masteryData - Tags to return additional data. Only id, name, and description are returned by default if this parameter isn't specified. To return all additional data, use the tag 'all'

    • Possible values: "all" | "image" | "masteryTree" | "prereq" | "ranks" | "sanitizeDescription"

/static/masteries/:id

Retrieves a mastery item by id.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

  • masteryData - Tags to return additional data. Only id, name, and description are returned by default if this parameter isn't specified. To return all additional data, use the tag 'all'

    • Possible values: "all" | "image" | "masteryTree" | "prereq" | "ranks" | "sanitizeDescription"

/static/profile-icons

Retrieves profile icons data.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

/static/realms

Retrieves realm data.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

/static/runes

Retrieves all runes in game.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

  • runeData - Tags to return additional data. Only id, name, rune, and description are returned by default if this parameter isn't specified. To return all additional data, use the tag 'all'.

    • Possible values: "all" | "colloq" | "consumeOnFull" | "consumed" | "depth" | "from" | "gold" | "hideFromAll" | "image" | "inStore" | "into" | "maps" | "requiredChampion" | "sanitizedDescription" | "specialRecipe" | "stacks" | "stats" | "tags"

/static/runes/:id

Retrieves a rune by id.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

  • runeData - Tags to return additional data. Only id, name, rune, and description are returned by default if this parameter isn't specified. To return all additional data, use the tag 'all'.

    • Possible values: "all" | "colloq" | "consumeOnFull" | "consumed" | "depth" | "from" | "gold" | "hideFromAll" | "image" | "inStore" | "into" | "maps" | "requiredChampion" | "sanitizedDescription" | "specialRecipe" | "stacks" | "stats" | "tags"

/static/spells

Retrieves all summoner spells in game.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

  • dataById - If specified, the returned data map will use the spells' id as the keys. If not specified or specified as false, the returned data map will use the spells' keys instead.

    • Possible values: Anything

  • spellData - Tags to return additional data. Only type, version, data, id, key, name, description, and summonerLevel are returned by default if this parameter isn't specified. To return all additional data, use the tag 'all'.

    • Possible values: "all" | "cooldown" | "cooldownBurn" | "cost" | "costBurn" | "costType" | "effect" | "effectBurn" | "image" | "key" | "leveltip" | "maxrank" | "modes" | "range" | "rangeBurn" | "resource" | "sanitizedDescription" | "sanitizedTooltip" | "tooltip" | "vars"

/static/spells/:id

Retrieves a summoner spell by id.

Querystring parameters

  • locale - Locale code for returned data (e.g., en_US, es_ES). If not specified, the default locale for the region is used.

  • version - Data dragon version for returned data. If not specified, the latest version for the region is used. List of valid versions can be obtained from the /versions endpoint.

  • spellData - Tags to return additional data. Only type, version, data, id, key, name, description, and summonerLevel are returned by default if this parameter isn't specified. To return all additional data, use the tag 'all'.

  • Possible values: "all" | "cooldown" | "cooldownBurn" | "cost" | "costBurn" | "costType" | "effect" | "effectBurn" | "image" | "key" | "leveltip" | "maxrank" | "modes" | "range" | "rangeBurn" | "resource" | "sanitizedDescription" | "sanitizedTooltip" | "tooltip" | "vars"

/static/versions

Retrieves version data.

/status

Retrieves the list of available regions.

/summoner

Retrieves a summoner based on name, id or accountId.

Querystring parameters

  • name - The name of the summoner

  • id - The Id of the summoner

  • accountId - The account id of the summoner

/summoner/:id

Retrieves a summoner by id.

/summoner/:summonerId/currentGame

Retrieves active game information for the given summonerId.

/summoner/:summonerId/championMastery

Retrieves all champion mastery entries by summonerId.

/summoner/:summonerId/championMastery/:championId

Retrieves a champion mastery entry by summonerId and championId.

/summoner/:summonerId/championMastery/score

Retrieves the total champion mastery score by summonerId.

/summoner/:summonerId/leagues

Retrieves leagues in all queues for a given summonerId.

/summoner/:summonerId/leagues/positions

Retrieves league positions in all queues for a given summonerId.

/summoner/:summonerId/masteries

Get mastery pages for a given summonerId.

/summoner/:summonerId/runes

Get rune pages for a given summonerId.

/clear-cache/account/:accountId

Clears the cache for a given accountId.

/clear-cache/summoner/:summonerId

Clears the cache for a given summonerId.