Collectr API

What a card is worth raw, and in every grade, from Collectr

endpoints
10
credits per call
1–3

The Collectr API returns the Collectr price guide as clean JSON.

This page covers what the Collectr API returns, who uses it, a real response and pricing. Every parameter and response field is in Collectr API parameters and responses →

POST/collectr/v1/product
Real result, captured Nov 8, 2026
grade_namemarket_pricegradergrade
GEM - MT1209.19PSA10
MINT344.96PSA9
NM - MT+312.89PSA8.5
10 active endpoints, on 1, 2 and 3 credit tiers.search · product · price_history · suggest · sets · set+4 more ↓OpenAPI 3.0 spec ↗

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Collectr API

3 of 10 endpoints, ready to run

View docs ↗

Cards and sealed product by name or card number: set, card number, rarity, printing, market price, latest change and which grades have prices.

2 credits0 required · 5 optional
POST/collectr/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Collectr endpoints does ReefAPI ship?

10 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • search

    2 cr

    Search Collectr's price guide by name across every game, or browse a category, a set or a pri…

    required
    —
    optional
    query, category, set_id, language, product_type, price_min, price_max, sort, page, limit, currency, max_rotations
  • product

    2 cr

    One card or sealed product in full.

    required
    product_id
    optional
    currency, max_rotations
  • price_history

    3 cr

    The daily price history behind a product's chart, about one year back.

    required
    product_id
    optional
    grader, grade, variant, days, currency, max_rotations
  • suggest

    1 cr

    Collectr's own search-as-you-type.

    required
    query
    optional
    set_id, max_rotations
  • sets

    2 cr

    Every set (expansion) Collectr lists for a game, newest first.

    required
    category
    optional
    language, query, max_rotations
  • set

    2 cr

    One set's analytics as Collectr shows them.

    required
    set_id
    optional
    history_days, currency, max_rotations
  • trending

    2 cr

    What collectors are looking at on Collectr today.

    required
    —
    optional
    category, language, product_type, page, limit, currency, max_rotations
  • movers

    2 cr

    Biggest price gainers or losers on Collectr by percent or by amount, for one game or all, car…

    required
    —
    optional
    direction, measure, category, language, product_type, price_min, price_max, page, limit, currency, max_rotations
  • categories

    1 cr

    Every game and collectible category Collectr prices (Pokémon, Magic, Yu-Gi-Oh!, One Piece, Lo…

    required
    —
    optional
    max_rotations
  • grading_scales

    1 cr

    The grading companies and grades Collectr prices (PSA, BGS, CGC, TAG, ACE, ARS, AGS) with eac…

    required
    —
    optional
    max_rotations

Every parameter, every allowed value →

Missing a Collectr endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Collectr API works

Collectr is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 632 engines.

Call02
POST /collectr/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

Should I grade this card? Three calls

Compare a card's raw price with what each grade sells for, and see the trend, from Collectr.

01search
POST/collectr/v1/search
{"query": "199/165", "category": "pokemon"}

Find the card by its number; the row lists which grades have prices.

02product
POST/collectr/v1/product
{"product_id": "517045"}

Raw price and every graded price, PSA to AGS, with grade names.

03price_history
POST/collectr/v1/price_history
{"product_id": "517045", "grader": "PSA", "grade": "10", "days": 180}

How the PSA 10 price moved over six months.

Raw vs graded value and the graded trend for one card in three calls.

request
curl -X POST https://api.reefapi.com/collectr/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"charizard","category":"pokemon"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "collectr",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

GradeCollectr price (USD)vs raw $296.98
Ungraded (raw)296.981.0x
PSA 9 MINT344.961.2x
PSA 10 GEM - MT1,209.194.1x
CGC 10 Gem Mint575.041.9x
CGC 10 Pristine1,644.005.5x
TAG 10 GEM MINT1,280.874.3x
BGS 10 Pristine8,499.9928.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.

Coverage

What Collectr publishes, and what it does not

Collectr's price guide only, prices in USD (converted on request). Measured 2026-11-08: 35 of 35 live cases across ten actions, and 669 rows and prices checked against Collectr's own pages with no difference. Some of these lines go against us.

Graded prices per card

Base Set Charizard came back with 85 graded prices across 2 printings, SV151 Charizard ex with 35 across 5 graders, and a One Piece Luffy with 10.

Price history

About a year. Raw prices are close to daily; graded prices have gaps.

Sets

Pokémon 178 English, 202 Japanese and 26 Chinese sets, Magic 192, One Piece 23.

Against us: sports

Basketball only, and only Panini 2018-21 rookies.

Not published

Population counts, the window a price change covers, and portfolios (they need a login). A new product with no price yet is null, never 0.

Use cases

What people build with Collectr

The jobs this data is most often used for.

01

Grading decisions: raw price next to PSA, CGC, TAG and BGS prices for the same card

02

Collection value trackers: market price per card and printing, with history for charts

03

Sealed product investing: booster box and ETB prices and their movement

04

Market dashboards: trending cards, biggest gainers and losers, set value over time

10

endpoints

1/2/3

credits per call

Pricing

What Collectr data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 632 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/collectr/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"charizard","category":"pokemon"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/collectr/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
        "query": "charizard",
        "category": "pokemon"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Collectr.

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.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 631 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-08.