Población gradada

Cifras de población de PSA, BGS, CGC y SGC para cada impresión de una carta Pokémon, nota por nota, con el gem rate y la parte de copias con nota más alta.

Población gradada

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

Cuántas copias de cada impresión han gradado PSA, BGS, CGC y SGC, y con qué nota. Las cifras salen de los informes de población de las empresas de gradación, unidos por GemRate, y se actualizan cada semana. Desde Pro; el plan Free recibe 403.

Hay un objeto por variante, con el nombre de las filas de precios ("Holofoil", "Reverse Holofoil", "1st Edition"). Las variantes que son la misma impresión física llevan las mismas cifras. Una carta que nadie ha gradado, o que aún no hemos asociado, devuelve una lista variants vacía en lugar de 404.

grades suma las notas numéricas de las empresas, con claves de "1" a "10" y las medias notas como "8.5"; una nota que nunca se dio a la carta no aparece en vez de valer cero. pristine (10 Pristine de BGS, CGC y SGC) y black_label (Black Label de BGS, Perfect 10 de CGC) están por encima de un 10 normal y no están en grades. total_gems cuenta la nota gem de cada empresa o mejor: PSA 10, BGS 9.5 o más, SGC y CGC 10 o más.

percent_higher da, para cada clave de grades, la parte de copias con nota numérica que sacaron una nota más alta, Pristine y Black Label incluidos. Es el dato habitual para estimar la rentabilidad de gradar: una copia raw que vuelve con un 9 o mejor tiene una probabilidad de percent_higher["8.5"].

graders trae el informe propio de cada empresa, con su total, sus grades, pop_report_url y, en PSA, spec_id. updated_at es cuándo obtuvimos las cifras por última vez; last_population_change es el último día en que cambió la cifra de alguna empresa.

Parámetros

idstringobligatorio

El ID único de la carta.

variantstring

Solo esta variante, escrita exactamente como en las filas de precios, por ejemplo "Holofoil" o "Reverse Holofoil".

Pruébalo

Clave de API

id *

variant

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.pkmnprices.com/v1/cards/{id}/population

Respuesta

{
  "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"
    }
  ]
}