\r\n\r\n###### [pubg.js docs](https://pubg.js.org) | [api docs](https://documentation.playbattlegrounds.com/en/introduction.html) | [changelog](CHANGELOG.md) | [issues](#issues)\r\n\r\n\r\npubg.js makes it easy to interact with [the pubg dev api](https://developer.playbattlegrounds.com/). Written with an intelligent and performant api, making it easy for anyone to access a massive database of pubg data, including players stats, matches, teams, events of matches and much more. Built with customizable caching, for maximum performance, and quicker data retrieval. Includes full documentation and IDE auto completion support.\r\n\r\n# Setup and Installation\r\n1. Signup at [the pubg dev api site](https://developer.playbattlegrounds.com/)\r\n2. Register an [app](https://developer.playbattlegrounds.com/apps/new?locale=en), giving you a key\r\n3. Install **pubg.js** `npm install pubg.js --save`\r\n4. When using the wrapper, parse your generated key when creating the client\r\n\r\n\r\n# Examples\r\n```js\r\n// Require model and initiate client with api key\r\nconst pubg = require('pubg.js');\r\nconst client = new pubg.Client('yourKey', 'region');\r\n\r\n// Get a single player using their name\r\nconst player = client.getPlayer({name: 'yeye155'})\r\n .then(player => /* Use an extensive class of data */)\r\n .catch(error => /* Catch any errors */)\r\n\r\n// Retrieve thousands of recent matches, and get stats for any of them\r\nconst player = client.getSamples()\r\n .then(matches => /* Have access to the PUBG's extensive list of matches */)\r\n .catch(error => /* Catch any errors */)\r\n\r\n// Fetch a match with a heap of data on every participant of the match and their stats\r\nconst player = client.getSamples()\r\n .then(match => {\r\n // Manipulate the data in any way you like, or even get match telemetry data \r\n match.fetchTelemetry()\r\n // View a heap of data on the teams - best k/d, winning team etc\r\n match.relationships.rosters\r\n\r\n })\r\n .catch(error => /* Catch any errors */)\r\n\r\n```\r\n\r\n# Web\r\n\r\nIn addition to the Node.js environment, pubg.js also fully supports the web. Useful for interacting with the pubg api with static pages or without the use of a backend. All up, the minified version comes down to as little as 17KB. You can find the latest version in the [webpack](https://github.com/ickerio/pubg.js/tree/webpack) branch. To use it, choose one of the following options and `pubg` will be defined in the window scope. It's as simple as the example above but without the need to `require` the package first.\r\n - **Download it**: [normal](https://raw.githubusercontent.com/ickerio/pubg.js/webpack/pubg.js), [minified](https://raw.githubusercontent.com/ickerio/pubg.js/webpack/pubg.min.js)\r\n - **Production**: [normal](https://cdn.rawgit.com/ickerio/pubg.js/webpack/pubg.js), [minified](https://cdn.rawgit.com/ickerio/pubg.js/webpack/pubg.min.js)\r\n - **Development**: [normal](https://rawgit.com/ickerio/pubg.js/webpack/pubg.js), [minified](https://rawgit.com/ickerio/pubg.js/webpack/pubg.min.js)\r\n\r\n# Issues\r\nIf you run into any issues, have any queries or concerns or would just like to make a few suggestions please do not hesitate to join our [discord support server](https://discord.gg/yCWj2N2)\r\n","maintainers":[{"name":"ickerio","email":"randomhippie321@gmail.com"}],"time":{"modified":"2022-05-13T15:22:55.094Z","created":"2017-09-30T08:06:06.668Z","1.0.0":"2017-09-30T08:06:06.668Z","1.0.1":"2017-09-30T08:51:13.228Z","1.1.0":"2017-09-30T11:08:15.987Z","1.1.1":"2017-09-30T11:54:00.320Z","1.2.0":"2017-09-30T14:16:47.350Z","1.2.1":"2017-10-01T02:50:00.919Z","1.2.2":"2017-10-03T02:23:12.820Z","1.3.0":"2017-10-04T02:20:51.979Z","1.3.1":"2017-10-04T02:27:06.360Z","1.3.2":"2017-10-04T03:30:36.026Z","1.3.3":"2017-10-10T04:27:07.372Z","1.3.4":"2017-10-10T04:53:00.000Z","1.3.5":"2017-10-12T07:14:11.482Z","1.3.6":"2017-10-13T04:23:15.874Z","1.4.0":"2017-10-14T07:31:58.439Z","1.4.1":"2017-10-15T02:43:16.432Z","1.4.2":"2017-10-18T13:03:04.818Z","1.5.0":"2017-10-22T06:57:51.276Z","1.5.1":"2017-10-25T11:56:30.199Z","1.5.2":"2017-11-02T08:41:49.955Z","1.5.3":"2017-11-08T13:02:32.996Z","1.5.4":"2017-11-08T13:41:21.687Z","2.0.0":"2017-11-12T13:23:24.376Z","3.0.0":"2018-04-04T15:18:48.585Z","3.1.0":"2018-04-06T01:50:30.344Z","3.2.0":"2018-04-22T10:59:59.852Z","3.4.0":"2018-05-05T09:54:40.567Z","3.5.0":"2018-05-05T12:16:31.785Z","3.5.1":"2018-05-05T14:09:58.394Z","3.5.2":"2018-05-06T02:05:29.842Z","3.5.3":"2018-05-24T11:54:20.598Z","3.6.0":"2018-07-25T09:25:37.669Z","3.7.0":"2018-10-04T13:18:44.081Z","3.7.1":"2018-10-04T13:49:01.261Z","3.7.2":"2018-10-12T07:57:17.517Z","3.9.0":"2019-06-15T04:23:50.502Z"},"homepage":"https://github.com/ickerio/pubg.js#readme","keywords":["pubg","api","wrapper"],"repository":{"type":"git","url":"git+https://github.com/ickerio/pubg.js.git"},"author":{"name":"ickerio, Zaytt"},"bugs":{"url":"https://github.com/ickerio/pubg.jsissues"},"license":"ISC","readmeFilename":"README.md"}
![](\"https://user-images.githubusercontent.com/14541442/32552867-3d44fd8e-c4d0-11e7-85d5-5199697582bd.png\")
\r\n![](\"https://img.shields.io/npm/v/pubg.js.svg\")
\r\n ![](\"https://img.shields.io/npm/dt/pubg.js.svg?maxAge=3600\")
\r\n ![](\"https://travis-ci.org/ickerio/pubg.js.svg?branch=master\")
\r\n