PriceCharting

https://www.pricecharting.com/api-documentation
Admin
PriceCharting tracks and charts the prices of various items, helping users monitor market trends and...
Tokens:6,562
Snippets:51
Trust Score:9.6
Update:1 month ago
Show doc for...
Tokens:
Raw
### Perform a Product Lookup via cURL

Source: https://www.pricecharting.com/api-documentation

Example of a GET request to the product endpoint using a demo authentication token.

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

--------------------------------

### Retrieve Marketplace Offers via GET

Source: https://www.pricecharting.com/api-documentation

Fetches a list of offers based on specified parameters. Requires a valid API token and seller ID.

```bash
$ curl "https://www.pricecharting.com/api/offers?t=YOUR_TOKEN&seller=7cgdyu5ynzos3mxwhfh46xj3f4&status=sold"      {         "status":"success",         "offers":[             {                 "condition-string":"Normal wear",                 "console-name":"NES",                 "ended-time":"2017-10-31",                 "id":9307,                                       // unique PriceCharting product ID                 "include-string":"Game only",                 "is-available":false,                 "is-ended":true,                 "is-shipped":false,                 "is-sold":true,                                  // has offer sold                 "offer-id":"smzksacsy5i2dsrddxsrlzsp6i",         // unique offer Id                 "offer-status":"sold",                           // offer status                 "offer-url":"/offer/smzksacsy5i2dsrddxsrlzsp6i",                 "price":1473,                                    // $14.73.  current price                 "product-name":"M.C. Kids",                 "sale-time":"2017-10-31",                 "shipped-time":"0001-01-01",                     // zero time since it hasn't shipped             },             {                 "cert-id": "5672930123",                         // gradeing company unique identifier for graded item                 "condition-string":"Scratched,Writing",                 "console-name":"NES",                 "ended-time":"2017-10-30",                 "grade-co-id": 1,                                // unique ID for the grading company used                 "id":9729,                 "include-string":"Game, Box, and Manual",                 "is-available":false,                 "is-ended":true,                 "is-shipped":true,                 "is-sold":true,                 "offer-id":"nw6asacmsbvvoq5yeyrkvzcdky",                 "offer-status":"available",                 "offer-url":"/offer/nw6asacmsbvvoq5yeyrkvzcdky",                 "price":6281,                 "product-name":"Shatterhand",                 "sale-time":"2017-10-30",                 "shipped-time":"2017-10-31",             },         ],     }
```

--------------------------------

### Retrieve Offer Details via GET

Source: https://www.pricecharting.com/api-documentation

Fetches comprehensive details for a specific offer, including buyer shipping information if the item has sold.

```bash
$ curl "https://www.pricecharting.com/api/offer-details?t=YOUR_TOKEN&offer-id=vtdsww72uyslgooawzyyijsllm"
```

--------------------------------

### GET /api/product

Source: https://www.pricecharting.com/api-documentation

Retrieves product information including name and console details based on a specific product ID.

```APIDOC
## GET /api/product

### Description
Retrieves details for a specific product using its unique identifier.

### Method
GET

### Endpoint
https://www.pricecharting.com/api/product

### Parameters
#### Query Parameters
- **t** (string) - Required - Your 40-character API access token.
- **id** (string) - Required - The unique product ID.

### Request Example
curl "https://www.pricecharting.com/api/product?t=YOUR_TOKEN&id=6910"

### Response
#### Success Response (200)
- **status** (string) - Indicates success or error.
- **id** (string) - The product ID.
- **product-name** (string) - The name of the product.
- **console-name** (string) - The name of the console associated with the product.

#### Response Example
{
  "status": "success",
  "id": "6910",
  "product-name": "EarthBound",
  "console-name": "Super Nintendo"
}
```

--------------------------------

### GET /api/product

Source: https://www.pricecharting.com/api-documentation

Retrieves data about a single product. The response is semantically equivalent to a single row in the downloadable CSV price guide.

```APIDOC
## GET /api/product

### Description
Retrieves data about a single product based on an ID, UPC, or search query.

### Method
GET

### Endpoint
/api/product

### Parameters
#### Query Parameters
- **t** (string) - Required - Your API authentication token.
- **id** (string) - Optional - PriceCharting product ID number.
- **upc** (string) - Optional - Universal Product Code.
- **q** (string) - Optional - Full text search query for product title and/or console.

### Response
#### Success Response (200)
- **status** (string) - Response status.
- **cib-price** (integer) - Price in cents for CIB condition.
- **console-name** (string) - Name of the console.
- **id** (string) - Unique PriceCharting product ID.
- **loose-price** (integer) - Price in cents for loose condition.
- **new-price** (integer) - Price in cents for new condition.
- **product-name** (string) - Name of the product.
- **release-date** (string) - Release date of the product.
```

--------------------------------

### GET /api/products

Source: https://www.pricecharting.com/api-documentation

Retrieves data about multiple products based on a search query. Returns a list of up to 20 matching products.

```APIDOC
## GET /api/products

### Description
Provides data about multiple products matching a search query.

### Method
GET

### Endpoint
/api/products

### Parameters
#### Query Parameters
- **t** (string) - Required - Your API authentication token.
- **q** (string) - Required - Full text search query for product title and/or console.

### Response
#### Success Response (200)
- **status** (string) - Response status.
- **products** (array) - List of the first 20 products matching the search.
```

--------------------------------

### GET /api/offer-details

Source: https://www.pricecharting.com/api-documentation

Find full details on an individual offer, including the buyer's address if the item has sold.

```APIDOC
## GET /api/offer-details

### Description
Find full details on an individual offer, including the buyer's address if the item has sold.

### Method
GET

### Endpoint
/api/offer-details

### Parameters
#### Query Parameters
- **t** (string) - Required - Your API token
- **offer-id** (string) - Required - The unique ID for an offer

### Response
#### Success Response (200)
- **status** (string) - Status of the request
- **buyer** (object) - Buyer's shipping info
- **offer-id** (string) - Unique offer ID
- **price** (number) - Sales price
```

--------------------------------

### GET /api/offers

Source: https://www.pricecharting.com/api-documentation

Retrieves a list of offers matching the provided parameters. This endpoint is used by sellers to check for sold offers and should be throttled to once every 5 minutes.

```APIDOC
## GET /api/offers

### Description
Retrieves a list of offers matching the provided parameters. This endpoint is used by sellers to check for sold offers and should be throttled to once every 5 minutes.

### Method
GET

### Endpoint
/api/offers

### Parameters
#### Query Parameters
- **t** (string) - Required - Authentication token
- **status** (string) - Required - Offer status (available, sold, ended, or collection)
- **buyer** (string) - Optional - User ID for the buyer
- **console** (string) - Optional - PriceCharting Unique Console ID
- **condition-id** (integer) - Optional - PriceCharting Condition ID
- **genre** (string) - Optional - Genre name
- **id** (integer) - Optional - PriceCharting Unique Product ID
- **seller** (string) - Optional - User ID for the seller
- **sort** (string) - Optional - Sort order (name, starts, lowest-price)

### Request Example
curl "https://www.pricecharting.com/api/offers?t=YOUR_TOKEN&seller=7cgdyu5ynzos3mxwhfh46xj3f4&status=sold"

### Response
#### Success Response (200)
- **status** (string) - Response status
- **offers** (array) - List of offer objects

#### Response Example
{
  "status": "success",
  "offers": [
    {
      "condition-string": "Normal wear",
      "console-name": "NES",
      "ended-time": "2017-10-31",
      "id": 9307,
      "include-string": "Game only",
      "is-available": false,
      "is-ended": true,
      "is-shipped": false,
      "is-sold": true,
      "offer-id": "smzksacsy5i2dsrddxsrlzsp6i",
      "offer-status": "sold",
      "offer-url": "/offer/smzksacsy5i2dsrddxsrlzsp6i",
      "price": 1473,
      "product-name": "M.C. Kids",
      "sale-time": "2017-10-31",
      "shipped-time": "0001-01-01"
    }
  ]
}
```

--------------------------------

### Retrieve multiple products via API

Source: https://www.pricecharting.com/api-documentation

Searches for multiple products based on a query string and returns a list of matches.

```bash
$ curl "https://www.pricecharting.com/api/products?t=c0b53bce27c1bdab90b1605249e600dc43dfd1d5&q=tactics ogre"      {         "status":   "success",         "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"             }         ]     }
```

--------------------------------

### Publish an offer using cURL

Source: https://www.pricecharting.com/api-documentation

Sends a POST request to the offer-publish endpoint with product details and authentication token.

```bash
$ curl --data "t=YOUR_TOKEN&product=9331&condition-id=1&price-max=901&sku=123abc" https://www.pricecharting.com/api/offer-publish      {         "status":"success"         "cost-basis":125,                                // price you paid for item         "offer-id":"ccirsewk5mdnoest7xkryagimy",         // the unique ID for this new offer         "offer-url":"/offer/ccirsewk5mdnoest7xkryagimy", // url for the new offer         "offer-status":"available",         "product-name":"Metroid",         "console-name":"NES",         "condition-string":"Scratches, Writing",         // condition values end users will see         "include-string":"Game, Box",                    // include values end users will see         "has-pictures":false,                            // does the listing have a photo         "price":901,         "sku":"123abc",         "is-collection":false,                           // is the offer in a collection         "start-time":"2017-11-03",                       // date the offer was listed         "quantity":1,                                    // quantity owned.  only supported for collections     }
```

--------------------------------

### Retrieve single product data via API

Source: https://www.pricecharting.com/api-documentation

Fetches data for a specific product using an ID. The response includes pricing information in various conditions.

```bash
$ curl "https://www.pricecharting.com/api/product?t=c0b53bce27c1bdab90b1605249e600dc43dfd1d5&id=6910"      {         "status": "success",              // response status         "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     }
```

--------------------------------

### Post Offer Feedback via POST

Source: https://www.pricecharting.com/api-documentation

Submits a rating and optional comment for a transaction associated with a specific offer ID.

```bash
$ curl --data "t=YOUR_TOKEN&rating=2&comment=Great+buyer&offer-id=vtdsww72uyslgooawzyyijsllm" https://www.pricecharting.com/api/offer-feedback
```

--------------------------------

### Refund an Offer via API

Source: https://www.pricecharting.com/api-documentation

Use this endpoint to process a refund for a previously purchased offer, which triggers an immediate refund via PayPal.

```bash
$ curl --data "t=YOUR_TOKEN&offer-id=vtdsww72uyslgooawzyyijsllm" https://www.pricecharting.com/api/offer-refund      {         "status":"success",         "offer-id":"vtdsww72uyslgooawzyyijsllm",         "is-refunded":true,         "refunded-time":"2017-10-31"     }
```

--------------------------------

### Mark Offer as Shipped via POST

Source: https://www.pricecharting.com/api-documentation

Updates the status of an offer to shipped and attaches a tracking number for the shipment.

```bash
$ curl --data "t=YOUR_TOKEN&tracking-number=901234567890000&offer-id=vtdsww72uyslgooawzyyijsllm" https://www.pricecharting.com/api/offer-ship
```

--------------------------------

### POST /api/offer-ship

Source: https://www.pricecharting.com/api-documentation

Mark an offer as shipped and upload a tracking number if available.

```APIDOC
## POST /api/offer-ship

### Description
Mark an offer as shipped and upload a tracking number if available.

### Method
POST

### Endpoint
/api/offer-ship

### Parameters
#### Request Body
- **t** (string) - Required - Your API token
- **offer-id** (string) - Required - The unique ID for an offer
- **tracking-number** (string) - Optional - The tracking number for the offer

### Response
#### Success Response (200)
- **status** (string) - Status of the request
- **offer-id** (string) - Unique offer ID
- **is-shipped** (boolean) - Shipping status
- **shipped-time** (string) - Date notified of shipping
- **tracking-number** (string) - Tracking number
```

--------------------------------

### Offer Parameters

Source: https://www.pricecharting.com/api-documentation

Parameters used to define the details of an offer when publishing a new listing or editing an existing one.

```APIDOC
## Offer Parameters

### Description
Parameters used to identify the product and define the terms of an offer for sale or collection.

### Parameters
#### Required Identifiers (Choose one)
- **product** (integer) - PriceCharting Unique Product ID
- **upc** (string) - UPC for the item
- **asin** (string) - Amazon Unique ID
- **epid** (integer) - eBay Unique ID
- **offer-id** (string) - PriceCharting Unique Offer ID (for editing existing offers)

#### Required Offer Details
- **price-max** (integer) - Maximum price in pennies
- **condition-id** (integer) - Numeric value for item inclusion (e.g., Item only, Box, Manual)

#### Optional Parameters
- **price-min** (integer) - Minimum price for reverse auctions (in pennies)
- **add-to-collection** (string) - Set to 'on' to add to collection instead of listing for sale
- **cost-basis** (integer) - Price paid for item in pennies
- **description** (string) - Text description (max 300 chars)
- **sku** (string) - Internal tracking number (max 64 chars)
- **quantity** (integer) - Number of copies owned (collection only)
- **broken** (string) - Condition tag: 'on'
- **pristine** (string) - Condition tag: 'on'
- **scratch** (string) - Condition tag: 'on'
- **stickers** (string) - Condition tag: 'on'
- **tear** (string) - Condition tag: 'on'
- **writing** (string) - Condition tag: 'on'
- **photo1-6** (string) - URLs to JPG or PNG images
```

--------------------------------

### End an Offer via API

Source: https://www.pricecharting.com/api-documentation

Use this endpoint to end an offer, making it unavailable for purchase and removing it from any collections.

```bash
$ curl --data "t=YOUR_TOKEN&offer-id=vtdsww72uyslgooawzyyijsllm" https://www.pricecharting.com/api/offer-end      {         "status":"success",         "offer-id":"vtdsww72uyslgooawzyyijsllm",         "is-ended":true,         "ended-time":"2017-10-31"     }
```

--------------------------------

### POST /api/offer-publish

Source: https://www.pricecharting.com/api-documentation

Publishes a new offer on the PriceCharting Marketplace. This endpoint is intended for single offer creation; for bulk operations, use CSV upload tools.

```APIDOC
## POST /api/offer-publish

### Description
The Offer-Publish API publishes one new offer on the Marketplace.

### Method
POST

### Endpoint
https://www.pricecharting.com/api/offer-publish

### Request Body
- **t** (string) - Required - Your API token
- **product** (integer) - Required - The product ID
- **condition-id** (integer) - Required - The condition ID for the item
- **price-max** (integer) - Required - The price for the item
- **sku** (string) - Optional - The SKU for the item

### Request Example
curl --data "t=YOUR_TOKEN&product=9331&condition-id=1&price-max=901&sku=123abc" https://www.pricecharting.com/api/offer-publish

### Response
#### Success Response (200)
- **status** (string) - The status of the request
- **cost-basis** (integer) - Price paid for the item
- **offer-id** (string) - Unique ID for the new offer
- **offer-url** (string) - URL for the new offer
- **offer-status** (string) - Current status of the offer
- **product-name** (string) - Name of the product
- **console-name** (string) - Name of the console
- **condition-string** (string) - Condition description for end users
- **include-string** (string) - Included items description for end users
- **has-pictures** (boolean) - Whether the listing has a photo
- **price** (integer) - The price of the offer
- **sku** (string) - The SKU of the offer
- **is-collection** (boolean) - Whether the offer is in a collection
- **start-time** (string) - Date the offer was listed
- **quantity** (integer) - Quantity owned

#### Response Example
{
  "status": "success",
  "cost-basis": 125,
  "offer-id": "ccirsewk5mdnoest7xkryagimy",
  "offer-url": "/offer/ccirsewk5mdnoest7xkryagimy",
  "offer-status": "available",
  "product-name": "Metroid",
  "console-name": "NES",
  "condition-string": "Scratches, Writing",
  "include-string": "Game, Box",
  "has-pictures": false,
  "price": 901,
  "sku": "123abc",
  "is-collection": false,
  "start-time": "2017-11-03",
  "quantity": 1
}
```

--------------------------------

### POST /api/offer-feedback

Source: https://www.pricecharting.com/api-documentation

Post feedback rating and comments on a particular offer.

```APIDOC
## POST /api/offer-feedback

### Description
Post feedback rating and comments on a particular offer.

### Method
POST

### Endpoint
/api/offer-feedback

### Parameters
#### Request Body
- **t** (string) - Required - Your API token
- **offer-id** (string) - Required - The unique ID for an offer
- **rating** (integer) - Required - An integer rating (2=Great, 1=Good, 0=Ok, -1=Bad, -2=Awful)
- **comment** (string) - Optional - A text comment about the transaction

### Response
#### Success Response (200)
- **status** (string) - Status of the request
- **offer-id** (string) - Unique offer ID
- **rating** (integer) - Feedback rating
- **comment** (string) - Feedback comment
```

--------------------------------

### POST /api/offer-refund

Source: https://www.pricecharting.com/api-documentation

Refunds the payment for an offer that was already purchased, immediately processing the refund from your PayPal account back to the buyer.

```APIDOC
## POST /api/offer-refund

### Description
Refund the payment for an offer that was already purchased. This immediately refunds the payment from your PayPal account back to the buyer.

### Method
POST

### Endpoint
/api/offer-refund

### Parameters
#### Query Parameters
- **t** (string) - Required - Your API token
- **offer-id** (string) - Required - The unique ID for an offer.

### Response
#### Success Response (200)
- **status** (string) - Status of the request
- **offer-id** (string) - The unique ID for an offer
- **is-refunded** (boolean) - Whether the offer is refunded
- **refunded-time** (string) - The time the offer was refunded
```

--------------------------------

### API Request Parameters

Source: https://www.pricecharting.com/api-documentation

Query parameters used to filter offer results.

```text
status=available
```

```text
buyer=7cgdyu5ynzos3mxwhfh46xj3f4
```

```text
console=G17
```

```text
condition-id=2
```

```text
genre=Football
```

```text
id=6910
```

```text
seller=7cgdyu5ynzos3mxwhfh46xj3f4
```

```text
sort=name
```

--------------------------------

### POST /api/offer-end

Source: https://www.pricecharting.com/api-documentation

Ends an offer so it is no longer available for purchase. If the offer is in a collection, this removes the item from the collection.

```APIDOC
## POST /api/offer-end

### Description
End an offer so it is no longer available for purchase. If offer is in a collection this removes the item from the collection.

### Method
POST

### Endpoint
/api/offer-end

### Parameters
#### Query Parameters
- **t** (string) - Required - Your API token
- **offer-id** (string) - Required - The unique ID for an offer.

### Response
#### Success Response (200)
- **status** (string) - Status of the request
- **offer-id** (string) - The unique ID for an offer
- **is-ended** (boolean) - Whether the offer is ended
- **ended-time** (string) - The time the offer was ended
```
Tokens:
Raw