API de Cards: Population search
Search graded trading cards across PSA, BGS, SGC and CGC by free text (year, set, player or character, card number, parallel) and get each matching card variant with its card ID, year, set, number, parallel, total graded population, gem count and gem rate. Pass the card ID to Graded Card Population for the count at every grade.
Precios
Precios del endpoint Population search de la API de Cards
Pruébalo
Obtén Population search de Cards en una sola solicitud
{
"data": {
"hasMore": true,
"items": [
{
"cardId": "a1b2c3d4",
"cardNumber": "example",
"category": "general",
"description": "A short example description of this item.",
"gemRatePercent": 12.5,
"gems": 42,
"graders": [
"example"
],
"image": "https://example.com/image.jpg",
"name": "Example title",
"parallel": "example",
"set": "example",
"totalPopulation": 12500,
"year": 2024
}
]
},
"found": true,
"reason": "not_found"
}Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.
Referencia
Una solicitud, un formato de respuesta.
Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.
Verificado por última vez el 2026-11-21 · disponibilidad y latencia medidas en 30d
Cuerpo de la solicitud
JSON, enviado por POST a este endpoint.
- querystring
1999 Pokemon Base Charizard
Free text describing the card: year, set, player or character, card number and parallel, e.g. "2018 Topps Chrome Update Shohei Ohtani Refractor".
- pageinteger
1-based results page of 10 cards, up to 5 pages. Each page is billed as one request.
Respuesta
JSON, un valor de ejemplo por campo.
Matching cards, or null when nothing matched.
- hasMoreboolean
True when another page of matches exists.
Matching card variants, best match first. Each variant (base, 1st edition, shadowless, refractor...) is its own row. Populated whenever the provider has data for the entity.
- cardIdstring
Card ID. Pass it as cardId to Graded Card Population (cards.population) for the count at every grade. Populated whenever the provider has data for the entity.
- cardNumberstring
Card number within the set.
- categorystring
Card category, e.g. tcg-cards or baseball-cards.
- descriptionstring
Full card description, e.g. "1999 Pokemon Game Charizard-Holo Base 4". Populated whenever the provider has data for the entity.
- gemRatePercentnumber
Share of graded copies that are gem mint or better, in percent.
- gemsinteger
Copies graded gem mint or better.
- gradersstring[]
Graders whose counts are included, e.g. ["psa", "bgs", "sgc", "cgc"].
- imagestring
Card image URL.
- namestring
Card name: player or character.
- parallelstring
Variant or parallel name, e.g. "1st Edition", "Shadowless" or "Refractor".
- setstring
Set name.
- totalPopulationinteger
Total copies graded across the graders listed in graders.
- yearinteger
Year of the card's set.
- foundboolean
True when at least one graded card matched the query.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preguntas frecuentes
Acerca del endpoint Population search de la API de Cards
El endpoint Population search de AnyAPI para Cards devuelve datos de Cards como JSON normalizado con una sola llamada POST a /v1/run/cards.population_search. Search graded trading cards across PSA, BGS, SGC and CGC by free text (year, set, player or character, card number, parallel) and get each matching card variant with its card ID, year, set, number, parallel, total graded population, gem count and gem rate. Pass the card ID to Graded Card Population for the count at every grade. AnyAPI devuelve un único esquema normalizado sin importar qué fuente atienda la solicitud. Cuesta desde US$2.25 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 100.0% de las llamadas al endpoint Population search de la API de Cards a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 1.8 segundos en 1 llamadas medidas.