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 Legendary 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
API's are a premium tool. You must have a paid subscription to access the API.
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 Legendary 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 |
|---|---|
| bgs-10-price | Value for card graded BGS 10 |
| box-only-price | Value for card Graded 9.5 by a grading company |
| cib-price | Value for card Graded 7 or 7.5 by a grading company |
| condition-17-price | Value for card graded CGC 10 |
| condition-18-price | Value for card graded SGC 10 |
| 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 PSA 10 |
| 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 |
