SportsCardsPro API & CSV Download Documentation

Documentation for all SportsCardsPro APIs, including the Prices API to get card prices and the Marketplace API to automate all aspects of finding and selling games on the Marketplace.

SportsCardsPro offers CSV download files including cards and price data for each set listed on the site. Users access these by clicking "Download Price List" link on any set page.

CSV download feature is only available to Retailer subscribers.

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.sportscardspro.com/api/product?t=c0b53bce27c1bdab90b1605249e600dc43dfd1d5&id=72584" { "status": "success", "id":"72584", "product-name":"Michael Jordan #57" "console-name":"Basketball Cards 1986 Fleer", }

Authentication

Each subscription has a unique, 40-character token associated with it. You can find this token by visiting the Subscription page and clicking "API/Download" button. 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.

Make a Request

To make an API request, make an HTTP 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.

Requests should use GET or POST methods. Each API will list the supported method. As a general rule, APIs that display data only will use GET and APIs that create or change data will use POST.

During development, 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.
Dates are encoded as YYYY-MM-DD strings.
Prices an integer number of pennies. For example, the amount $17.32 would be encoded as 1732.
Boolean are encoded as boolean.
All other keys are encoded as strings.

Error Handling

Each JSON object contains a "status" key whose value is either success or error. If the status is success, 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.

 

Download Data via CSV File

In addition to an API, we also offer a CSV download with all the data included. A CSV download is a more efficient way to update lots of data points at one time.

The CSV files are generated once every 24 hours so no need to download it more often than once per day.

CSV column names match the Prices API key description names.

CSV download feature is only available to Retailer subscribers. To access an existing download, visit the Subscriptions page and click "API/Download" button.

 

Prices API

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

Product: /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.

Whitespace and comments are added for clarity but are not present in an actual response:

$ curl "https://www.sportscardspro.com/api/product?t=c0b53bce27c1bdab90b1605249e600dc43dfd1d5&id=72584" { "status": "success", // response status "cib-price": 413800, // $4138.00 "console-name": "Basketball Cards 1986 Fleer", "id": "72584", // unique product ID "loose-price": 225500, // $2255.00 "new-price": 602295, // $6022.95 "product-name": "Michael Jordan #57", }

Parameters

There are several ways to specify which product you want:

id=6910
SportsCardsPro 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 an item page on SportsCardsPro.com
q=michael+jordan+57+1986+fleer
Full text search
Search for a product based on its title and/or set. If multiple products match the search, only the best match is returned. Example queries:

Products: /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.

$ curl "https://www.sportscardspro.com/api/products?t=c0b53bce27c1bdab90b1605249e600dc43dfd1d5&q=michael+jordan+1986+fleer" { "status": "success", "products": [ { "console-name": "Basketball Cards 1986 Fleer", "id": "72584", "product-name": "Michael Jordan #57" }, { "console-name": "Basketball Cards 1986 Fleer Sticker", "id": "90923", "product-name": "Michael Jordan #8" }, ] }

Parameters

There is one way to specify which products you want:

q=tom brady rookie
Full text search
Search for a card based on its title and/or set. If multiple cards match the search, only the best matches are returned. Example queries:

tom brady rookie
michael jordan #57
mike trout 2023 prizm

Prices API & CSV: Description of Keys

Description of the data contained in each CSV column and API key.

Column Name Description
box-only-price Value for card Graded 9.5 by Beckett grading service
cib-price Value for card Graded 7 or 7.5 by a grading company
console-name The name of the set the card is in. Example: "Basketball 1986 Fleer"
genre The genre is a single category which describes the item. Example: "Baseball Card"
graded-price Value for card Graded 9 by a grading company
id SportsCardsPro unique id for a card.
loose-price Value for Ungraded card
manual-only-price Value for card Graded 10 by PSA grading service
new-price Value for card Graded 8 or 8.5 by a grading company
product-name The full name of the card with card number and parallel name.
release-date The rough date the card was original released.
retail-cib-buy The recommended price for retailers buying from a customer if card is Graded 7.
retail-cib-sell The recommended price for retailers selling to a customer if card is Graded 7.
retail-loose-buy The recommended price for retailers buying from a customer in Ungraded condition.
retail-loose-sell The recommended price for retailers selling to a customer in Ungraded condition.
retail-new-buy The recommended price for retailers buying from a customer if card is Graded 8.
retail-new-sell The recommended price for retailers selling to a customer if card is Graded 8.
sales-volume The yearly units sold

FAQ | Login Don't Want Ads?

Take/Upload a sports card photo. Find the best match in our database.

Example Photos

Great Photo
great photo example
  • Clear Photo
  • Rectangle Shaped Card
  • Minimal Background
Bad Photo = Poor Result
bad photo: too much background and blurry
  • Too Much Background
  • Blurry
Bad Photo = Poor Result
bad photo: angled edges
  • Shot From an Angle So
    Card is Not a Rectangle
Bad Photo = Poor Result
bad photo: cutoff
  • Cutoff Part of Card

Best Matches