API

Fresh from the coding oven comes GW2TP's very own API! Please note: this API is still very new and WILL change in the future! It currently allows for some basic data querying as is explained below. Currently the API only supports the JSON format.

All requests have JSONP support. This means you can supply a callback function name by appending ?callback=function_name to the request URL and it will wrap the response data in your method call, thereby allowing your function to fire when the request is complete. This is useful for users using jQuery or any other library with JSONP support.

Returns a list of all item types and their sub-types.

[GET] /api/v1/item_types

[
   {
       "id": 1,
       "name": "Armor",
       "tp_id": 0,
       "sub_types": [
           {
               "id": 2,
               "name": "Aquatic Helm",
               "tp_id": 4
           },
           { ... },
           { ... }
       ]
   },
   { ... },
   { ... }
]

Returns a detailed, paginated list of items, their price data and type. Limited to 1000 items per page.

[GET] /api/v1/items

Parameters:

?page= The page number
?item_type= The item type ID (or sub-type ID) to limit item results. Note: uses the id for the type as returned by the item type listing, not in-game tp_id.

{

   "total_items": 18242,
   "per_page": 1000,
   "page": 1,
   "items": [
       {
           "id": 1,
           "name": "Water Filter",
           "tp_id": 4234,
           "level": 20,
           "rarity": "Masterwork",
           "image": "https://dfach8bufmqqv.cloudfront.net/gw2/img/content/29575337.png",
           "item_type": {
               "id": 2,
               "name": "Aquatic Helm",
               "tp_id": 4
           },
           "sell_count": 237,
           "buy_count": 517,
           "sell_price": 1246,
           "buy_price": 844,
           "updated_at": "2013-01-10T18:41:31Z"
       },
       { ... },
       { ... }
     ]
}

Returns detailed information about an item, its price data and type.

[GET] /api/v1/items/<id>

Arguments:

id The item ID as provided by the item listing. Not the in-game tp_id

{
   "id": 6765,
   "name": "Explorer's Hard Inscription",
   "tp_id": 19896,
   "level": 60,
   "rarity": "Fine",
   "image": "https://dfach8bufmqqv.cloudfront.net/gw2/img/content/a075373.png",
   "item_type": {
       "id": 18,
       "name": "Crafting Material",
       "tp_id": 5
   },
   "sell_count": 864,
   "buy_count": 1866,
   "sell_price": 483,
   "buy_price": 280,
   "updated_at": "2013-01-10T18:41:31Z"
}