Population gradée

Les chiffres de population PSA, BGS, CGC et SGC pour chaque impression d’une carte Pokémon, note par note, avec le gem rate et la part des exemplaires mieux notés.

Population gradée

GET/v1/cards/:id/population1 crédit

Combien d’exemplaires de chaque impression PSA, BGS, CGC et SGC ont gradés, et à quelle note. Les chiffres viennent des rapports de population des sociétés de gradation, réunis par GemRate, et sont mis à jour chaque semaine. À partir de Pro ; le plan Free reçoit 403.

Il y a un objet par variante, nommé comme dans les lignes de prix ("Holofoil", "Reverse Holofoil", "1st Edition"). Les variantes qui sont une seule et même impression physique portent les mêmes chiffres. Une carte que personne n’a gradée, ou que nous n’avons pas encore associée, renvoie une liste variants vide plutôt qu’un 404.

grades additionne les notes numériques des sociétés, avec les clés "1" à "10" et les demi-notes en "8.5" ; une note jamais attribuée à la carte est absente plutôt qu’à zéro. pristine (10 Pristine BGS, CGC et SGC) et black_label (Black Label BGS, Perfect 10 CGC) se situent au-dessus d’un 10 simple et ne figurent pas dans grades. total_gems compte la note gem de chaque société ou mieux : PSA 10, BGS 9.5 et plus, SGC et CGC 10 et plus.

percent_higher donne, pour chaque clé de grades, la part des exemplaires notés numériquement qui ont obtenu une note plus élevée, Pristine et Black Label compris. C’est la donnée habituelle d’une estimation de rentabilité de gradation : un exemplaire raw qui revient à 9 ou mieux a une probabilité de percent_higher["8.5"].

graders contient le rapport propre à chaque société, avec son total, ses grades, pop_report_url et, pour PSA, spec_id. updated_at indique quand nous avons récupéré les chiffres pour la dernière fois ; last_population_change est le dernier jour où le chiffre d’une société a changé.

Paramètres

idstringobligatoire

L'ID unique de la carte.

variantstring

Seulement cette variante, écrite exactement comme dans les lignes de prix, par exemple "Holofoil" ou "Reverse Holofoil".

Essayer

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