PriceCharting API endpoint
Searches PriceCharting's price guide (trading cards, video games, comics, coins, Funko Pops, LEGO and more) and returns up to 100 matches: product id, name, console or set, category, image and the loose/ungraded, complete/Grade 9 and new/PSA 10 prices. Narrow by console_uid, drop variants, and sort by popularity, highest price or name. Price data is PriceCharting's; cite it with a link when you display it.
/pricecharting/searchParameters:
q (required): the search text, 2 to 100 characters.console_uid (optional): restrict to one console or set by its console_uid, for example G10623 for Pokemon Base Set. The value comes from search results and from pricecharting-console.exclude_variants (optional): true drops variant printings such as 1st Edition.sort (optional): popularity (default), highest-price or name.Notable response behavior:
console_uid to see more.loose_price, complete_price and new_price are the first, third and second price columns. For trading cards they are the ungraded, Grade 9 and PSA 10 prices; for video games they are the loose, complete-in-box and new prices. Other categories use their own column names; pricecharting-product returns the labeled columns. A price is omitted when PriceCharting has none.category is the category slug from pricecharting-categories. Prices are US dollars.products list.Example response (long values and lists shortened):
{
"code": 200,
"msg": "OK",
"data": {
"query": "charizard",
"sort": "popularity",
"total": 100,
"products": [
{
"id": 14470806,
"name": "Charizard #4",
"console": "Pokemon 30th Celebration",
"console_uid": "G101225",
"category": "pokemon-cards",
"image_url": "https://storage.googleapis.com/images.pricecharting.com/iberht5we3unfqwx/240.jpg",
"loose_price": 177.5,
"complete_price": 379.39,
"new_price": 2017.43
},
{
"id": 11069001,
"name": "Mega Charizard X ex #125",
"console": "Pokemon Phantasmal Flames",
"console_uid": "G88580",
"category": "pokemon-cards",
"image_url": "https://storage.googleapis.com/images.pricecharting.com/fsbqea5aod5mejp5/240.jpg",
"loose_price": 620.06,
"complete_price": 611.5,
"new_price": 1338.09
},
{
"id": 715593,
"name": "Charizard [1st Edition] #4",
"console": "Pokemon Base Set",
"console_uid": "G10623",
"category": "pokemon-cards",
"image_url": "https://storage.googleapis.com/images.pricecharting.com/gmkd37jg7haprczl/240.jpg",
"loose_price": 6956.11,
"complete_price": 36735,
"new_price": 335000.48
}
]
}
}
| Field | Filled in, of 100 checked | Values in the sample |
|---|---|---|
| id | 100 | |
| name | 100 | “Charizard #4” and 89 other values |
| console | 100 | “Pokemon 30th Celebration” and 53 other values |
| console_uid | 100 | |
| category | 100 | pokemon-cards in all 100 |
| image_url | 100 | storage.googleapis.com |
| loose_price | 100 | 2.82 to 6,956.11, median 126.46 |
| complete_price | 98 | 22.27 to 39,800, median 220 |
| new_price | 99 | 62 to 335,000.48, median 899 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Search text, 2 to 100 characters | charizard | |
| console_uid | string | No | Restrict to one console or set by its console_uid (for example G10623), as returned in search results and by pricecharting-console | G10623 | |
| exclude_variants | boolean | No | Drop variant printings such as 1st Edition | true | |
| sort | string | No | popularity | Ordering; defaults to popularity Allowed values: popularity, highest-price, name. | highest-price |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/pricecharting/search?q=charizard&exclude_variants=true&sort=popularity" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "charizard",
"sort": "popularity",
"total": 100,
"products": [
{
"id": 14470806,
"name": "Charizard #4",
"console": "Pokemon 30th Celebration",
"console_uid": "G101225",
"category": "pokemon-cards",
"image_url": "https://storage.googleapis.com/images.pricecharting.com/iberht5we3unfqwx/240.jpg",
"loose_price": 177.5,
"complete_price": 379.39,
"new_price": 2017.43
},
{
"id": 11069001,
"name": "Mega Charizard X ex #125",
"console": "Pokemon Phantasmal Flames",
"console_uid": "G88580",
"category": "pokemon-cards",
"image_url": "https://storage.googleapis.com/images.pricecharting.com/fsbqea5aod5mejp5/240.jpg",
"loose_price": 620.06,
"complete_price": 611.5,
"new_price": 1338.09
},
{
"id": 715593,
"name": "Charizard [1st Edition] #4",
"console": "Pokemon Base Set",
"console_uid": "G10623",
"category": "pokemon-cards",
"image_url": "https://storage.googleapis.com/images.pricecharting.com/gmkd37jg7haprczl/240.jpg",
"loose_price": 6956.11,
"complete_price": 36735,
"new_price": 335000.48
}
]
}
}Request schema
No body schema
Response schema
#/definitions/pricecharting.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | pricecharting.SearchResponse | No | ||||
| data.products | array | No | ||||
| data.products[].category | string | No | ||||
| data.products[].complete_price | number | No | ||||
| data.products[].console | string | No | ||||
| data.products[].console_uid | string | No | ||||
| data.products[].id | integer | No | ||||
| data.products[].image_url | string | No | ||||
| data.products[].loose_price | number | No | ||||
| data.products[].name | string | No | ||||
| data.products[].new_price | number | No | ||||
| data.query | string | No | ||||
| data.sort | string | No | ||||
| data.total | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/pricecharting/search?q=charizard&exclude_variants=true&sort=popularity" \
-H "x-api-key: $CRAWLORA_API_KEY"