Popolazione gradata

Numeri di popolazione di PSA, BGS, CGC e SGC per ogni stampa di una carta Pokémon, voto per voto, con gem rate e quota di copie con voto più alto.

Popolazione gradata

GET/v1/cards/:id/population1 credito

Quante copie di ogni stampa hanno gradato PSA, BGS, CGC e SGC, e con quale voto. I numeri vengono dai report di popolazione delle società di grading, uniti da GemRate, e si aggiornano ogni settimana. Da Pro in su; il piano Free riceve 403.

C’è un oggetto per variante, con il nome delle righe di prezzo ("Holofoil", "Reverse Holofoil", "1st Edition"). Le varianti che sono la stessa stampa fisica hanno gli stessi numeri. Una carta che nessuno ha gradato, o che non abbiamo ancora associato, restituisce una lista variants vuota invece di 404.

grades somma i voti numerici delle società, con chiavi da "1" a "10" e i mezzi voti come "8.5"; un voto mai assegnato alla carta manca invece di valere zero. pristine (10 Pristine di BGS, CGC e SGC) e black_label (Black Label di BGS, Perfect 10 di CGC) stanno sopra un 10 normale e non sono in grades. total_gems conta il voto gem di ogni società o migliore: PSA 10, BGS da 9.5, SGC e CGC da 10.

percent_higher indica, per ogni chiave di grades, la quota di copie con voto numerico che hanno preso un voto più alto, Pristine e Black Label compresi. È il dato di partenza per stimare la convenienza del grading: una copia raw che torna con 9 o più ha una probabilità di percent_higher["8.5"].

graders contiene il report di ogni società, con il suo total, i suoi grades, pop_report_url e, per PSA, spec_id. updated_at è quando abbiamo preso i numeri l’ultima volta; last_population_change è l’ultimo giorno in cui è cambiato il numero di una società.

Parametri

idstringobbligatorio

L'ID univoco della carta.

variantstring

Solo questa variante, scritta esattamente come nelle righe di prezzo, ad esempio "Holofoil" o "Reverse Holofoil".

Provalo

curl -H "X-API-Key: YOUR_API_KEY" \
https://api.pkmnprices.com/v1/cards/{id}/population
Risposta
{
  "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"
    }
  ]
}