Cards Population search API
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.
Tarifs
Tarifs de l’API Cards Population search
Essayer
Obtenez Cards Population search en une requête
{
"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"
}Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.
Référence
Une requête, une seule forme de réponse.
Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.
Dernière vérification : 2026-11-21 · disponibilité et latence mesurées sur 30d
Corps de la requête
JSON, envoyé à cet 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.
Réponse
JSON, une valeur d’exemple par champ.
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.
FAQ
À propos de l’API Cards Population search
L’API Cards Population search d’AnyAPI renvoie des données Cards en JSON normalisé à partir d’un appel POST à /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 renvoie un schéma normalisé unique quelle que soit la source qui répond. Elle coûte à partir de 2,25 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 100,0% des appels Cards Population search passés par AnyAPI ont réussi, avec un temps de réponse médian de 1,8 secondes, sur 1 appels mesurés.