# Developer API There are 2 api sets, POESESSID and OAuth 2.0. ## POESESSID One works with http cookie header, that used by official site. You can use Chrome browser in Dev Tool (Press F12), click the `Network` tab, click `Fetch/XHR` filter to see how the API used. But note that this api is not officially supported and no documentation. ### Find the POESESSID in Chrome or Edge **Strongly recommend extreme caution with the use of your POESESSID, as providing that information to anyone else may put your account access at risk.** * Login to pathofexile.com * Press F12 to open the Dev Tool * Click the Application tab * Expand the Cookies dropdown and select pathofexile.com * Double click the POESESSID Value and copy  ## OAuth 2.0 To improve the security of POESESSID. This one only works with OAuth 2.0 and have official support and [official documents](https://www.pathofexile.com/developer/docs). GGG strongly recommend tool to use OAuth 2.0, but you need a distinct server hosted from your client to do the OAuth thing. * You set that up by contacting the `oauth@` email address with the details they desire. * Your project need to have a secure server that runs the whole OAuth dispatching stuff for your clients as you can't have any of that running client-side, clients need to do the auth procedure to bounce via the GGG OAuth sign-in system to grant your application rights. * You will receive a email how to setup the OAuth with `client_id` and `client_secret` ### Summary of OAuth 2.0 * Set a page to redirect to `https://www.pathofexile.com/oauth/authorize?client_id={client_id}&response_type=code&scope={scope}&state={state}&redirect_uri={redirect_uri}` * User confirmed the privilege and redirect_uri with `code` * Server use `https://www.pathofexile.com/oauth/token?grant_type=authorization_code&code={code}&client_id={client_id}&client_secret={client_secret}&redirect_uri={redirect_uri}` to verify the returned code and get `access_token` * Access the scope, ex: `/api/profile` with `User-Agent` header and `access_token` ## Public stash API [Public stash API](https://www.pathofexile.com/developer/docs/reference#publicstashes) doesn't contain any historical data and always returns the current state of stash tabs. Using ajax from a browser got blocked by CORS, you need to setup a basic proxy to fetch it. Every request will return a `next_change_id`. You will fetch the Json by sequence, for example ``` http://www.pathofexile.com/api/public-stash-tabs http://www.pathofexile.com/api/public-stash-tabs?id=342209785-336957592-338826328 http://www.pathofexile.com/api/public-stash-tabs?id=342209792-336957596-338826330 http://www.pathofexile.com/api/public-stash-tabs?id=342209797-336957599-338826336 ``` Using deflate parameter in request header will save a lot of traffic. ### Rate Limit Be aware there is a rate limit ``` curl -XGET -s -D - http://www.pathofexile.com/api/public-stash-tabs | grep -i 'x-rate-limit' ``` ### Next change id You can get latest change id at https://poe.ninja/stats ## Ladder API Each ladder only contains the top 15000 entries. endpoint | per page | description - | - | - /api/ladders/{league} | 200 | /ladder/export-csv/league/{league} | 2000 | csv output /api/league/{league}/ladder | 500 | OAuth 2.0 API, have sort function ## Development Tool Site | Description - | - [Official Website API](https://www.pathofexile.com/developer/docs) | OAuth 2.0 API endpoints of Path of Exile [PoE API](https://poedb.tw/us/poe-api) | PoEDB collections of official API [PyPoE](https://github.com/Project-Path-of-Exile-Wiki/PyPoE) | Collection of Python Tools for Path of Exile [RePoE](https://github.com/brather1ng/RePoE/) | Repository of Path of Exile resources for tool developers. [Skilltree Typescript](https://github.com/EmmittJ/SkillTree_TypeScript) | Best reference for how Skilltree worked [PoeSharp](https://github.com/andreandersen/PoeSharp) | C# Library to deal with PoE stuff [Poe Dat Viewer](https://snosme.github.io/poe-dat-viewer/) | Web-base Poe Dat Viewer [PoE dat schema](https://github.com/poe-tool-dev/dat-schema) | Source of truth schema for dat files. [PoE Format Specification](https://zao.github.io/poe-doc/) | Best book for the file formats used by Path of Exile.