PriceCharting API & Scraper
The PriceCharting API turns pricecharting.com into JSON in six actions.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search finds products by name, card number, UPC or ASIN, narrowed by category (video games, trading cards, comics, Funko, coins, LEGO), by one console or set, by region (NTSC, PAL, Japan) and with or without variants. product returns one item in full: PriceCharting's current market price for every condition or grade it tracks (9 for a Nintendo 64 game, 19 for a Pokémon card, 14 for a comic, 17 for a coin), the change since the last update, the sales volume, release date, publisher, UPC, ASIN, eBay ePID, TCGplayer id, variants, photos and, for graded cards, the PSA and CGC population report. price_history returns the monthly series behind the price chart for each condition, back to 2006 for the oldest games. sales returns the completed sales the prices are computed from: date, listing title, sold price (with the list price on a best-offer sale), marketplace (eBay, Goldin, Heritage, Fanatics) and the item link, up to 30 per condition. console lists every product of a console, card set, comic series or coin series, 150 per page, and consoles lists the sets of a category. Prices are PriceCharting's own estimates in US dollars, computed from completed sales. One ReefAPI key, the standard { ok, data, meta, error } envelope, no PriceCharting account.
Same price columns, different grades — what the six price slots mean per category
PriceCharting stores six prices per product, but what each one is depends on the category. Read off product pages on 2026-10-14; the API returns each price with the label the page itself prints.
| slot (source_key) | video game | trading card | comic book | coin |
|---|---|---|---|---|
| used | Loose | Ungraded | Ungraded | Ungraded |
| cib | Complete | Grade 7 | 4.0 / VG | VF (20-35) |
| new | New | Grade 8 | 6.0 / Fine | AU (50-58) |
| graded | Graded | Grade 9 | 8.0 / VF | MS62 |
| boxonly | Box Only | Grade 9.5 | 9.2 / NM- | MS64 |
| manualonly | Manual Only | PSA 10 | 9.8 | MS66 |
Every price carries condition (the page's label) and source_key, so a card's PSA 10 is never read as a game's Manual Only. Funko Pops use Out of Box / In Box / New; LEGO uses Pieces Only / Complete / New / Pieces & Manual / Box Only / Manual Only. The Full Price Guide in product adds every other grade the page prices (Grade 1-6, BGS 10, CGC 10, SGC 10, BGS 10 Black, 2.0-10 for comics, MS60-MS70 for coins).
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/pricecharting/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "charizard",
"category": "trading-cards"
}
}{
"ok": true,
"meta": {
"api": "pricecharting",
"endpoint": "search",
"mode": "live",
"latency_ms": 732.6,
"record_count": 200,
"bytes": 80132,
"cache_hit": false,
"query": "charizard",
"filters_applied": {
"category": "trading-cards",
"console_id": null,
"exclude_variants": false,
"region": null,
"sort": "popularity"
},
"possibly_truncated": true,
"source_row_cap": 200,
"has_more": false,
"upstream_requests": 1,
"warnings": [],
"currency": "USD",
"charged_credits": 2,
"version": "1.0.0",
"request_id": "944826dadb02409c",
"queue_ms": 1.3,
"fetched_at": "2026-10-14T18:57:30.473Z"
},
"data": {
"rows": [
{
"id": "14470806",
"name": "Charizard #4",
"console_name": "Pokemon 30th Celebration",
"console_id": "G101225",
"category": "pokemon-cards",
"image": "https://storage.googleapis.com/images.pricecharting.com/iberht5we3unfqwx/240.jpg",
"print_run": null,
"prices": [
{
"condition": "[trimmed-depth]",
"source_key": "[trimmed-depth]",
"price_usd": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"source_key": "[trimmed-depth]",
"price_usd": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"source_key": "[trimmed-depth]",
"price_usd": "[trimmed-depth]"
}
]
},
{
"id": "11069001",
"name": "Mega Charizard X ex #125",
"console_name": "Pokemon Phantasmal Flames",
"console_id": "G88580",
"category": "pokemon-cards",
"image": "https://storage.googleapis.com/images.pricecharting.com/fsbqea5aod5mejp5/240.jpg",
"print_run": null,
"prices": [
{
"condition": "[trimmed-depth]",
"source_key": "[trimmed-depth]",
"price_usd": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"source_key": "[trimmed-depth]",
"price_usd": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"source_key": "[trimmed-depth]",
"price_usd": "[trimmed-depth]"
}
]
},
{
"id": "715593",
"name": "Charizard [1st Edition] #4",
"console_name": "Pokemon Base Set",
"console_id": "G10623",
"category": "pokemon-cards",
"image": "https://storage.googleapis.com/images.pricecharting.com/gmkd37jg7haprczl/240.jpg",
"print_run": null,
"prices": [
{
"condition": "[trimmed-depth]",
"source_key": "[trimmed-depth]",
"price_usd": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"source_key": "[trimmed-depth]",
"price_usd": "[trimmed-depth]"
},
{
"condition": "[trimmed-depth]",
"source_key": "[trimmed-depth]",
"price_usd": "[trimmed-depth]"
}
]
}
]
}
}What the PriceCharting API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search PriceCharting by name, card number, UPC or ASIN. Each row has the product id, console / set, category and three headline prices with the page's own condition labels. The source returns at most 100 rows (200 with a category filter) and has no further pages; narrow with category / console_id / region. | Pricing teams call search to search PriceCharting by name, card number, UPC or ASIN. | query, category, console_id, exclude_variants, region, ... |
| product | One product in full by its id: every condition / grade the site prices (the Full Price Guide), the headline prices with the last change and the sales volume, release date, publisher, genre, UPC / ASIN / eBay ePID / TCGPlayer id, card or model number, variants and how many sold listings each condition shows. | Marketplace operators call product to get one product in full by its id. | id |
| price_history | The monthly price history behind the product's chart, one series per condition (the price at each month; the last point is the current month and equals the current price). Months without a price are null. | Catalog enrichment teams call price_history to get the monthly price history behind the product's chart, one series per condition (the price at…. | id |
| sales | The completed sales the site shows for a product (up to 30 per condition, newest first): date, listing title, sold price (for a best-offer sale the accepted price plus the list price), marketplace (eBay, Goldin, Heritage, Fanatics) and the item link. | Retail analysts call sales to get the completed sales the site shows for a product (up to 30 per condition, newest first). | id, condition |
| console | Every product of one console, card set, comic series or coin series with three headline prices and the latest price change, 150 per page. | Pricing teams call console to get every product of one console, card set, comic series or coin series with three headline price…. | console, sort, cursor |
| consoles | The consoles / card sets / comic series / coin series the site lists for one category ('Browse Popular …' — the popular list, not every comic series), with the slug the `console` action takes. | Marketplace operators call consoles to get the consoles / card sets / comic series / coin series the site lists for one category ('Brows…. | category |
Call search from your stack
curl -X POST https://api.reefapi.com/pricecharting/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"charizard","category":"trading-cards"}'import requests
r = requests.post(
"https://api.reefapi.com/pricecharting/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "charizard",
"category": "trading-cards"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/pricecharting/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "charizard",
"category": "trading-cards"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.pricecharting.search with {"query":"charizard","category":"trading-cards"}.Who uses this API and why
- Price a collection: product for each item gives the current price in the exact condition or grade you own.
- Decide whether to grade a card: compare Ungraded with Grade 9, PSA 10 and BGS 10 in product, and check the PSA population.
- Chart a market: price_history per condition for a console's best sellers or a card set's chase cards.
- Check a deal: sales shows what the same item really sold for, by condition, with the date and marketplace.
- Track a whole set: console pages through every card of a set or every game of a console with three headline prices and the latest change.
Questions developers ask before integrating
Is the price a real sale?
No. The prices are PriceCharting's current market price for each condition, which the site calculates from completed sales; it is not one sale. The completed sales themselves come from the sales action, with the date, the title of the listing, the sold price and the marketplace. On 61 headline prices across 11 products in 8 categories, every one matched the product's Full Price Guide.
Which grades do I get for a trading card?
Ungraded, Grade 1 to Grade 9.5, PSA 10, BGS 10, CGC 10, SGC 10, TAG 10, ACE 10, BGS 10 Black and CGC 10 Pristine, as the page lists them (19 for Charizard 1st Edition #4 from the Pokémon Base Set, 17 of them priced). A grade the site has no price for is null. Graded cards also come with the PSA and CGC population for grades 1 to 10.
How far back does the price history go?
As far as PriceCharting tracked the item: the Super Mario 64 Loose series starts in December 2006 (239 monthly points); card series start in 2020-2021 for older cards, at release for new ones. One point per month per condition, in US dollars; the last point is the current month and equals the current price (60 of 61 checked). Months without a price are null.
What is in the sold listings?
Up to 30 completed sales per condition, newest first: date, listing title, sold price, the marketplace (eBay, Goldin, Heritage, Fanatics) and a link to the item. For an eBay best-offer sale both the accepted price and the list price are returned. Use condition to get one grade, for example condition=PSA 10.
Why do search prices sometimes differ from product?
Search and console rows come from PriceCharting's list index, product reads the product page. On 18 prices compared across six categories 15 were identical; the 3 that differed were all on one new Pokémon card whose price was moving (61.67 in the list, 54.49 on the page). Use product for the current figure.
How many search results can I get?
PriceCharting returns at most 100 products for a search (200 when a category is chosen) and has no further pages; meta.possibly_truncated says when a search hit that limit. Narrow it with category, console_id or region, or list a whole console or set with console, which pages through every product 150 at a time.
Which currencies and markets?
Prices are in US dollars, the currency PriceCharting prices in; the same page read from different countries showed the same prices. Video games cover NTSC, PAL and Japanese releases (region filter). Sports cards are not part of pricecharting.com.
How do I find the id of a product?
Every search and console row carries id, the PriceCharting ID (3924 is Super Mario 64 on Nintendo 64). Pass it to product, price_history or sales as it is; a pricecharting.com/game/... link works too. Card products also return tcgplayer_id, and games UPC, ASIN and eBay ePID, to join with other sources.
What is the PriceCharting API?
PriceCharting API is a ReefAPI endpoint group for pricecharting's collectible price guide as json: the current market price for every condition and grade of a video game, pokémon, magic or yu-gi-oh! card, comic book, coin, funko pop or lego set, with the monthly price history and the sold listings behind it. It returns live JSON through POST requests under /pricecharting/v1.
Is the PriceCharting API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. PriceCharting calls use the same shared credit balance as every other ReefAPI engine.
Do I need a PriceCharting login or account?
No login to PriceCharting is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the PriceCharting data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the PriceCharting API use?
PriceCharting actions currently cost 2-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call PriceCharting from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call pricecharting actions with the same key, credit pool and JSON envelope used by normal REST requests.