Skip to main content

See graded counts.
Understand grade distributions.

Query graded counts and distributions by card, company, and grade for detail pages, collection comparisons, and analysis.

Identity
card_id links to the confirmed catalog entry
Scope
grader identifies the grading company
Distribution
population returns count by grade
Time
as_of identifies the snapshot date
Card → Grade distributionResponse

Charizard ex

Pokémon · 223/197 · Holofoil

Total graded for this printing
234cards
Grade 9
120 · 51.3%
Grader2026-10-01

Counts make sense with full context.

Show grader, card version and date together so every distribution has context.

Define the scope. Then view the counts.

One card. One statistical scope.

Card & variant mapping

Link sets, numbers and versions by card ID so graded counts stay with the right record, separate from similar names or artwork.

Keep grading companies separate

Keep the grader as a separate dimension for each distribution, preserving differences in grading systems and data sources.

Beyond the total, See every grade.

Make grade distributions easy to read.

Per-grade counts

Use grade counts to build bar charts, grade lists, or detail cards and highlight the grades you want to compare.

Scoped totals

Aggregate within the same company, card, and date scope. Show totals alongside grade counts and retain scope details.

Counts with dates. Context for every count.

Separate data changes from their meaning.

Keep dated snapshots

Date each distribution snapshot. Before comparing, confirm the same card scope and company to avoid misleading changes.

Link prices & catalog

Link catalog details and price records by card identity. Show distinct dimensions side by side for analysis.

Display every count in context.

Show what a number represents, not just its value.

01

Cross-grader comparison

Show each grader separately. Do not equate their grades or label combined counts as the total number of unique cards.

02

Missing vs. zero

Show “No data” for missing records. Show zero only when the returned count is explicitly 0. Retain grader and date to distinguish missing coverage from reported counts.

03

One card, multiple variants

Confirm language and variant before linking grade counts. Resolve uncertain recognition results before querying Population.

Add grade counts to card details.

Match identity first. Bring counts, grades, and dates into your workflow.

01

Confirm card and grader

Get a card ID from the catalog or recognition. Confirm the version and grader you need.

02

Get grade counts

Query Population for the selected scope. Receive per-grade counts, totals and the data date.

03

Display & link

Render grade counts as a list or chart alongside card details, grading records and prices.

Try in Playground

Explore request parameters and responses.

One distribution, Keep the full statistical context.

This sample uses one Charizard ex card and returns the grader, per-grade counts and data date together.

Identity
card_id links to the confirmed catalog entry
Scope
grader identifies the grading company
Distribution
population returns count by grade
Time
as_of identifies the snapshot date
View Population API docs
GET /example/population
RequestResponse
{
  "sample": true,
  "card_id": "tcgplayer:509980",
  "grader": "GRADER",
  "population": [
    {
      "grade": 7,
      "count": 18
    },
    {
      "grade": 8,
      "count": 64
    },
    {
      "grade": 9,
      "count": 120
    },
    {
      "grade": 10,
      "count": 32
    }
  ],
  "total": 234,
  "as_of": "2026-10-01"
}

Bring graded counts into your product.

Bring distributions to the right use case, linked by card identity.

01

Graded card listing details

Show distributions for the matching company and variant beside listings, with snapshot dates for clear buyer and seller context.

View marketplace solution
02

Collection records & comparison

Add Population distributions to graded-card collections and compare counts across grades for richer context.

View collection solution
03

Market Analytics

View grade counts beside prices for the same version. Organize by grader and date without treating population counts as a price estimate.

View analytics solution

Before you integrate.

More questions? Contact us

Does Population represent print runs or surviving copies?

No. Population describes grading counts and score distributions within a defined scope. Print runs, Raw (ungraded) cards, and surviving copies differ; resubmissions can also affect interpretation.

Can counts from grading companies be added together?

Do not treat the sum as a unique card total. Scope, grading scales, and resubmissions differ. Compare and display companies separately.

How do graded recognition and Population differ?

Graded card recognition extracts card details, cert numbers and label text. Population provides counts for a specific card and grader. Link both by card identity; recognition alone does not return every grader’s statistics.

Does a missing grade mean a zero count?

Not always. Missing fields differ from explicit zeros. Display No data and 0 separately rather than charting unknown counts as zero.

Can Population tell me if a card is rare or worth buying?

Population adds a grading-count dimension, but does not establish print runs, demand, or value. Show catalog, price, and grade distributions with clear definitions.

How do I verify coverage before integrating?

Check Population coverage for your sets, versions and graders, including the data date. A catalog entry or readable grading label does not guarantee Population availability.

Tell us about
card business.

Connect an API, request a key or discuss your data needs.
Tell us what you are building. Let us find the next step.

  • Start with your use case

    Define product goals, data scope, and API needs.

  • Find the right integration

    Combine recognition, imaging and data.

  • Discuss trial access

    Once the plan is agreed, we help you get an API key.

Services of interestSelect any

By submitting, you agree we may contact you about this inquiry.

Request submission is not connected in this preview.

One card. Your first API call.

Try preset requests and responses in Playground, or contact us for an API key.