Gegradete Population

Population-Zahlen von PSA, BGS, CGC und SGC für jede Druckvariante einer Pokémon-Karte, Note für Note, mit Gem-Rate und dem Anteil höher benoteter Exemplare.

Gegradete Population

GET/v1/cards/:id/population1 Credit

Wie viele Exemplare jeder Druckvariante PSA, BGS, CGC und SGC gegradet haben und mit welcher Note. Die Zahlen stammen aus den Population Reports der Grading-Firmen, zusammengeführt von GemRate, und werden wöchentlich aktualisiert. Ab Pro; im Free-Tarif gibt es 403.

Es gibt ein Objekt pro Variante, benannt wie in den Preiszeilen ("Holofoil", "Reverse Holofoil", "1st Edition"). Varianten, die ein und derselbe physische Druck sind, haben dieselben Zahlen. Eine Karte, die niemand gegradet hat oder die wir noch nicht zugeordnet haben, liefert eine leere variants-Liste statt 404.

grades summiert die numerischen Noten der Grading-Firmen, mit den Schlüsseln "1" bis "10" und halben Noten als "8.5"; eine Note, die für die Karte nie vergeben wurde, fehlt, statt 0 zu sein. pristine (BGS, CGC und SGC 10 Pristine) und black_label (BGS Black Label, CGC Perfect 10) liegen über einer normalen 10 und stehen nicht in grades. total_gems zählt die Gem-Note jeder Firma oder besser: PSA 10, BGS ab 9.5, SGC und CGC ab 10.

percent_higher gibt für jeden Schlüssel in grades den Anteil der numerisch gegradeten Exemplare an, die höher benotet wurden, Pristine und Black Label eingeschlossen. Das ist der übliche Ausgangswert für eine Grading-ROI-Schätzung: Ein Raw-Exemplar, das mit 9 oder besser zurückkommt, hat die Chance percent_higher["8.5"].

graders enthält den eigenen Report jeder Firma, mit total, grades, pop_report_url und bei PSA spec_id. updated_at ist der Zeitpunkt, an dem wir die Zahlen zuletzt geholt haben; last_population_change ist der letzte Tag, an dem sich die Zahl einer Firma geändert hat.

Parameter

idstringPflicht

Die eindeutige Karten-ID.

variantstring

Nur diese Variante, exakt so geschrieben wie in den Preiszeilen, z. B. "Holofoil" oder "Reverse Holofoil".

Ausprobieren

curl -H "X-API-Key: YOUR_API_KEY" \
https://api.pkmnprices.com/v1/cards/{id}/population
Antwort
{
  "card_id": 18176,
  "variants": [
    {
      "variant": "Normal",
      "total_population": 3822,
      "total_gems": 854,
      "gem_rate": 22.34,
      "grades": { "7": 182, "8": 702, "8.5": 83, "9": 1715, "9.5": 104, "10": 791 },
      "pristine": 49,
      "black_label": 0,
      "authentic": 7,
      "percent_higher": { "7": 90.69, "8": 71.87, "8.5": 69.7, "9": 24.74, "9.5": 22.02, "10": 1.28 },
      "graders": {
        "PSA": {
          "total": 2819,
          "gems": 400,
          "gem_rate": 14.19,
          "grades": { "8": 654, "9": 1435, "10": 400 },
          "pristine": null,
          "black_label": null,
          "authentic": 0,
          "altered": null,
          "qualified": 0,
          "last_population_change": "2026-10-16",
          "pop_report_url": "https://www.psacard.com/pop/tcg-cards/2025/pokemon-m24-en-mcdonald-s-collection/292686",
          "spec_id": "12660863",
          "description": "2025 Pokemon M24 EN-Mcdonald's Collection Charizard Base 001"
        }
      },
      "last_population_change": "2026-10-18",
      "updated_at": "2026-10-20T21:00:00+00:00"
    }
  ]
}