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.
Pricing
Cards Population search API pricing
Try it
Get Cards population search in one request
{
"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"
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-11-21 · uptime and latency measured over 30d
Request body
JSON, posted to this 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.
Response
JSON, one example value per field.
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
About the Cards Population search API
The AnyAPI Cards Population search API returns Cards population search data as normalized JSON from one POST call to /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 returns one normalized schema whichever source serves it. It costs from $2.25 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Cards population search calls through AnyAPI succeeded, with a median response time of 1.8 seconds across 1 measured calls.