Video Game Prices API

This document describes our API for accessing data you've purchased as part of a custom price guide. For certain applications, it's more convenient to use this API than to work with a downloaded CSV file.

API access is only included with price guide subscriptions. When building your price guide, choose 'subscribe' option during checkout.

Please give us your feedback about the API and this documentation. Thank you.

Overview

  • Requests are made over HTTPS
  • Responses are returned in JSON format
  • Responses include liberal CORS headers to facilitate cross-site requests
  • Authentication with a static, shared secret

Example:

$ curl 'https://www.pricecharting.com/api/product?t=c0b53bce27c1bdab90b1605249e600dc43dfd1d5&id=6910' {"console-name":"Super Nintendo","id":"6910","product-name":"EarthBound"}

Authentication

Each custom guide has a unique, 40-character token associated with it. You can find this token by inspecting the URL you use for downloading a copy of your price guide. If you have any trouble finding your access token, feel free to contact us. For example, the demo token used in this documentation is c0b53bce27c1bdab90b1605249e600dc43dfd1d5

Each API call is authenticated by including this token as the t parameter in the HTTP request. This token is specific to your guide and grants access to the data you've purchased. Please keep this token private.

Why? We chose to use a static, shared secret to authenticate API requests to make the API available in as many contexts as possible. Some platforms, like Google Sheets or Android Tasker can't perform complex API signature schemes.

Making a Request

To make an API request, make an HTTP GET request to the base URL https://www.pricecharting.com plus the path for the API you want. See below for a list of supported APIs. The most common is /api/product. Be sure to include a t parameter with your access token and any other parameters required by the API itself.

During development, these requests can be made by visiting the URL in your web browser or using a tool like curl. Each API response is a JSON object. Individual values within the JSON response are encoded as strings (product-name, console-name, etc). Dates are encoded as YYYY-MM-DD. Prices as an integer number of pennies. For example, the amount $17.32 would be encoded as 1732.

Error Handling

Each JSON object contains a "status" key whose value is either ok or error. If the status is ok, the request was completed successfully. The HTTP status code will be 200.

If the API response status is error, there will also be an error_message key whose value describes what went wrong. The HTTP status code to will fall in the 400 or 500 range, reserved for errors.

APIs

/api/product

This API provides data about a single product. Its response is semantically equivalent to a single row in your downloadable CSV price guide. The JSON key names exactly match the column names. Here's a sample response including some details about EarthBound for SNES. Whitespace and comments are added for clarity but are not present in an actual response:

{ "cib-price": 42995, // $429.95 "console-name": "Super Nintendo", "id": "6910", // unique PriceCharting product ID "loose-price": 17244, // $172.44 "new-price": 53000, // $530.00 "product-name": "EarthBound", "release-date": "1995-06-05" // 5 June 1995 }

There are several ways to specify which product you want:

id=6910
PriceCharting product ID number
This number is available in CSV price guides, provided in API responses or available by hovering your mouse over the product title on a product page on PriceCharting.com
upc=045496830434
UPC
The Universal Product Code is a convenient way to identify products for recent systems. Games in the First and Second Generation rarely have UPCs.
q=earthbound
Full text search
Search for a product based on its title and/or console. If multiple products match the search, only the best match is returned. Basic logic operators (AND, OR, NOT) are supported. They must be capitalized. Example queries:

chrono trigger super nintendo
chrono trigger NOT ds

/api/products

This API provides data about multiple products. Product queries can be specified just as with /api/product. The response contains a single products key whose value is a list of the first 20 products matching your search. Here's an example search for tactics ogre.

{ "products": [ { "console-name": "Playstation", "id": "4801", "product-name": "Tactics Ogre" }, { "console-name": "GameBoy Advance", "id": "2611", "product-name": "Tactics Ogre" }, { "console-name": "PSP", "id": "30988", "product-name": "Tactics Ogre: Let Us Cling Together" } ] }

As with all our APIs, the information returned for each product and the consoles included depend on how you built your custom price guide.

Description of Data Returned via API and CSV

Data Name Description
asin Unique identifier (ASIN) for this product on Amazon.com
cib-price Often referred to as Complete in Box (CIB). CIB price is what collectors sell the item for with the box and manual.

The Buy and Sell prices are what we recommend retailers buy and sell the CIB item for in their store or website.
console-name The name of the console on which the item was released.
epid Unique identifier (ePID) for this product on eBay and Half.com
gamestop-price The price that GameStop charges for this game in "Pre-Owned" condition. Make sure you don't charge more than the competition. (Buy/Sell prices above already account for this). The Trade price is what GameStop pays in cash for trade-in games.

These prices are only available for consoles that GameStop sells or trades.
genre The genre is a single category which describes the game. For example RPG, Fighting, Party, etc.
loose-price The loose price is what collectors sell the item for without the box or manual.

The Buy and Sell prices are what we recommend retailers buy and sell the loose item for in their store or website.
new-price The New price is what collectors sell the item for when brand new and sealed.

The Buy and Sell prices are what we recommend retailers buy and sell the new item for in their store or website.
product-name The name of the item.
release-date The date the game was original released.
retail-cib-buy The recommended price for retailers buying from a customer in CIB (complete in box) condition.
retail-cib-sell The recommended price for retailers selling to a customer in CIB (complete in box) condition.
retail-loose-buy The recommended price for retailers buying from a customer in loose condition.
retail-loose-sell The recommended price for retailers selling to a customer in loose condition.
retail-new-buy The recommended price for retailers buying from a customer in brand new condition.
retail-new-sell The recommended price for retailers selling to a customer in brand new condition.
upc The items in your guide will include a UPC that helps you track the item and sell on some websites. For example, eBay uses UPC to identify products when selling on their site.

UPCs may not be available for older consoles that came out before UPCs were created.

 

Login | Create Account | FAQ