Collectr API & Scraper: parameters and responses
This is the reference for the 10 Collectr endpoints under /collectr/v1 (search, product, price_history, suggest, sets, set, trending, movers, categories and grading_scales) and their 20 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.
The Collectr API returns the Collectr price guide as clean JSON.
🤖 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 cards and sealed product by name or card number across Pokémon (English, Japanese and Chinese), Magic: The Gathering, Yu-Gi-Oh!, One Piece, Lorcana and 30 more games plus Funko, Marvel cards and watches, filtered by game, set, language, cards or sealed and price range, sorted by price, trending or newest, 30 rows a page; each row has the market price, Collectr's latest change and which grades have a price. product returns one card in full: the ungraded market price of every printing (1st Edition, Shadowless, Holofoil, Reverse Holo …) and every graded price Collectr tracks for PSA, BGS, CGC, TAG, ACE, ARS and AGS, down to the half grade, with the TCGplayer product id. price_history returns about a year of daily prices for the raw card or any grade. sets lists every expansion of a game; set returns a set's total value over time, volatility, biggest movers, price bands, rarity breakdown and most wishlisted cards. trending and movers show what collectors are watching and what moved most. Prices in USD or 35 other currencies at Collectr's own rate. No account, no browser - one ReefAPI key and the standard { ok, data, meta, error } envelope.
One card, every grade: what a Charizard ex is worth slabbed
Charizard ex 199/165 from Pokémon 151 on 2026-11-08: one product call returned the raw price and 35 graded prices from five grading companies. The same card in a top grade ranges from about 2x to almost 30x the raw price depending on who graded it.
| Grade | Collectr price (USD) | vs raw $296.98 |
|---|---|---|
| Ungraded (raw) | 296.98 | 1.0x |
| PSA 9 MINT | 344.96 | 1.2x |
| PSA 10 GEM - MT | 1,209.19 | 4.1x |
| CGC 10 Gem Mint | 575.04 | 1.9x |
| CGC 10 Pristine | 1,644.00 | 5.5x |
| TAG 10 GEM MINT | 1,280.87 | 4.3x |
| BGS 10 Pristine | 8,499.99 | 28.6x |
Grade 10 is not one thing: CGC, TAG, BGS, ARS and AGS each have two top grades (Gem Mint vs Pristine, or Black Label), so every graded price comes with its grade name. Low grades can sit near or above the raw price (here PSA 5 was 300.00); these are Collectr's own figures, not smoothed by us.
Real request and response JSON
Captured from the indexed primary action, product, on .
{
"method": "POST",
"url": "https://api.reefapi.com/collectr/v1/product",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"product_id": "517045"
}
}{
"ok": true,
"meta": {
"api": "collectr",
"endpoint": "product",
"mode": "live",
"latency_ms": 1714,
"record_count": 1,
"bytes": 87354,
"cache_hit": false,
"graded_prices": 35,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "bf113df9295f4901",
"queue_ms": 1.2,
"fetched_at": "2026-11-08T13:04:21.611Z"
},
"data": {
"product": {
"product_id": "517045",
"name": "Charizard ex",
"category_id": "3",
"category": "Pokemon",
"category_slug": "pokemon",
"set_name": "SV: 151",
"set_id": "23237",
"set_slug": "sv-151",
"set_url": "https://app.getcollectr.com/sets/category/3/sv-151?groupId=23237&cardType=cards",
"cards_in_set": 215,
"card_number": "199/165",
"rarity": "Special Illustration Rare",
"is_card": true,
"product_type": "card",
"description": "Card Type: FireHP: 330Stage: Stage 2Attack 1: [R] Brave Wing (60+)\n if this Pokemon has any damage counters on it, this attack does 100 more damage.Attack 2: [RRRR] Explosive Vortex (330)\nDiscard 3 Energy from this Pokemon.Weakness: Wx2Resistance: NoneRetreat Cost: 2",
"image_url": "https://public.getcollectr.com/public-assets/products/product_517045.jpg",
"url": "https://app.getcollectr.com/explore/product/517045",
"tcgplayer_product_id": "517045",
"tcgplayer_url": "https://www.tcgplayer.com/product/517045/pokemon-sv-scarlet-and-violet-151-charizard-ex-199-165",
"cardmarket_url": null,
"added_to_collectr_at": "2023-09-20T10:05:07.547Z",
"variants": [
{
"variant": "Holofoil",
"image_url": "https://public.getcollectr.com/public-assets/products/product_517045.jpg"
}
],
"market_price": 296.64,
"price_change": -3.65,
"price_change_percent": -1.22,
"raw_prices": [
{
"variant": "Holofoil",
"market_price": 296.64,
"price_change": 0,
"price_change_percent": 0,
"price_date": "2026-11-08"
}
],
"graded_prices": [
{
"grade_id": "12",
"grader": "PSA",
"grade": "10",
"grade_name": "GEM - MT",
"grade_label": "PSA 10 GEM - MT",
"variant": "Holofoil",
"market_price": 1209.19,
"price_change": 0,
"price_change_percent": 0,
"price_date": "2026-11-05"
},
{
"grade_id": "11",
"grader": "PSA",
"grade": "9",
"grade_name": "MINT",
"grade_label": "PSA 9 MINT",
"variant": "Holofoil",
"market_price": 344.96,
"price_change": 0,
"price_change_percent": 0,
"price_date": "2026-11-06"
},
{
"grade_id": "10",
"grader": "PSA",
"grade": "8.5",
"grade_name": "NM - MT+",
"grade_label": "PSA 8.5 NM - MT+",
"variant": "Holofoil",
"market_price": 312.89,
"price_change": 0,
"price_change_percent": 0,
"price_date": "2026-11-06"
}
],
"graders": [
"PSA",
"BGS",
"CGC"
],
"graded_price_count": 35,
"show_graded_section": true,
"language": "en"
},
"currency": "USD",
"exchange_rate": 1
}
}What the Collectr API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Collectr's price guide by name across every game, or browse a category, a set or a price band: each row has the product id, set, card number, rarity, variant (Holofoil, 1st Edition, Reverse Holo …), the raw market price with Collectr's latest change, which graders and grades have a price, the image and the Collectr URL. Filter by category, set, language (EN/JP/CN), cards or sealed and price range; sort by price, trending, newest, name or card number. 30 rows a page. | Pricing teams call search to search Collectr's price guide by name across every game, or browse a category, a set or a pri…. | query, category, set_id, language, product_type, ... |
| product | One card or sealed product in full: the raw (ungraded) market price of every variant and EVERY graded price Collectr tracks (PSA, BGS, CGC, TAG, ACE, ARS, AGS; grader, grade and grade name such as CGC 10 Pristine vs Gem Mint or BGS 10 Black Label) with each price's latest change and date, set and card number, rarity, card text, images per variant, card language, the TCGplayer product id and link. | Marketplace operators call product to get one card or sealed product in full. | product_id, currency, max_rotations |
| price_history | The daily price history behind a product's chart, about one year back: one series per variant and grade (raw by default; a grader such as PSA, a single grade such as PSA 10, or all graded series), each with every daily point, the first and latest price and the change over the window. | Catalog enrichment teams call price_history to get the daily price history behind a product's chart, about one year back. | product_id, grader, grade, variant, days, ... |
| suggest | Collectr's own search-as-you-type: up to 10 matching products with id, set, card number, rarity and image - the quickest way to turn a card name into a product_id. | Retail analysts call suggest to get collectr's own search-as-you-type. | query, set_id, max_rotations |
| sets | Every set (expansion) Collectr lists for a game, newest first: set id, name, card count, release date, logo and URL. Pokémon has English, Japanese and Chinese set lists. | Pricing teams call sets to get every set (expansion) Collectr lists for a game, newest first. | category, language, query, max_rotations |
| set | One set's analytics as Collectr shows them: the total value of the set today and its value history, volatility score, biggest market movers, how many cards fall in each price band, rarity and variant breakdown, weekly sales volume and the most wishlisted cards - plus the set's name, code, release date and card count. Use search with set_id for the full card list with prices. | Marketplace operators call set to get one set's analytics as Collectr shows them. | set_id, history_days, currency, max_rotations |
| trending | What collectors are looking at on Collectr today: products ordered by today's views, optionally for one game or cards / sealed only, with the three most viewed products and their view counts. | Catalog enrichment teams call trending to get what collectors are looking at on Collectr today. | category, language, product_type, page, limit, ... |
| movers | Biggest price gainers or losers on Collectr by percent or by amount, for one game or all, cards or sealed, optionally above a minimum price so cheap bulk does not dominate. One row per variant. | Retail analysts call movers to get biggest price gainers or losers on Collectr by percent or by amount, for one game or all, car…. | direction, measure, category, language, product_type, ... |
| categories | Every game and collectible category Collectr prices (Pokémon, Magic, Yu-Gi-Oh!, One Piece, Lorcana and 30+ more, Funko, Marvel, watches, basketball), with the id and slug the other actions take, whether it has set lists, and the languages and product types the search filters accept. | Pricing teams call categories to get every game and collectible category Collectr prices (Pokémon, Magic, Yu-Gi-Oh!, One Piece, Lo…. | max_rotations |
| grading_scales | The grading companies and grades Collectr prices (PSA, BGS, CGC, TAG, ACE, ARS, AGS) with each grade's id, value and name, which grades Collectr treats as equivalent across companies, and its raw-card condition multipliers (Near Mint, Lightly Played … Damaged). | Marketplace operators call grading_scales to get the grading companies and grades Collectr prices (PSA, BGS, CGC, TAG, ACE, ARS, AGS) with eac…. | max_rotations |
Call product from your stack
curl -X POST https://api.reefapi.com/collectr/v1/product \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"product_id":"517045"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/collectr/v1/product",
headers={"x-api-key": REEF_KEY},
json={
"product_id": "517045"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/collectr/v1/product", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"product_id": "517045"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.collectr.product with {"product_id":"517045"}.Who uses this API and why
- Grading decisions: raw price next to PSA, CGC, TAG and BGS prices for the same card
- Collection value trackers: market price per card and printing, with history for charts
- Sealed product investing: booster box and ETB prices and their movement
- Market dashboards: trending cards, biggest gainers and losers, set value over time
- Japanese vs English price comparison for Pokémon
Questions developers ask before integrating
Which grading companies are covered?
PSA, BGS (Beckett), CGC, TAG, ACE, ARS and AGS - whatever Collectr prices for that card. Each graded price carries the grader, the grade, the grade name and the date of the price. The graders a card has are listed on every search row, so you can skip cards with no graded data. SGC is not in Collectr's grading scale.
Can I get the price history for a PSA 10?
Yes. price_history with grader PSA and grade 10 returns the daily series Collectr charts, about a year back (raw prices are near-daily; graded series have gaps on days with no data). Use days to cut the window, variant to pick one printing, or grader all for every series at once.
Does it cover Japanese and Chinese Pokémon cards?
Yes. Collectr keeps separate English, Japanese and Chinese Pokémon set lists (178, 202 and 26 sets in our 2026-11-08 run). search takes language jp or cn, sets lists the sets per language, and product tells you the card's language from its set.
Is sealed product included?
Yes - booster boxes, Elite Trainer Boxes, bundles, tins and collections have their own market price and history. Use product_type sealed in search, or cards for singles only.
Are sports cards covered?
Only lightly. Collectr's catalog has a small basketball section (Panini Prizm, Select and Optic rookie cards from 2018-21) and no baseball, football or soccer. For sports cards use Card Ladder or SportsCardsPro.
How do I find the id of a card?
suggest returns up to 10 matches for a name as you type; search takes a name or a card number such as 199/165. For TCGplayer-listed cards the Collectr id is the TCGplayer product id, so a TCGplayer product URL works as the id too.
What is the Collectr API?
Collectr API is a ReefAPI endpoint group for raw and graded card prices (psa, bgs, cgc, tag) with a year of history, for pokémon, magic, one piece and 30+ tcgs. It returns live JSON through POST requests under /collectr/v1.
Is the Collectr API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Collectr calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Collectr login or account?
No login to Collectr 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 Collectr 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 Collectr API use?
Collectr actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Collectr from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call collectr actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Collectr API a Collectr scraper?
It is the managed alternative to a DIY Collectr scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same raw and graded card prices (psa, bgs, cgc, tag) with a year of history, for pokémon, magic, one piece and 30+ tcgs back as clean JSON.
Why does my Collectr scraper keep getting blocked?
Most Collectr scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.