API para 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.
Preços
Preços do endpoint Population search da API para Cards
Teste
Obtenha Population search do Cards em uma só requisição
{
"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"
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Uma requisição, um formato de resposta.
Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.
Última verificação em 2026-11-21 · disponibilidade e latência medidas em 30d
Corpo da requisição
JSON, enviado via POST para 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.
Resposta
JSON, um valor de exemplo 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.
Dúvidas frequentes
Sobre o endpoint Population search da API para Cards
O endpoint Population search da AnyAPI para Cards retorna dados de Cards em JSON normalizado com uma chamada POST para /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. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 2,25 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Population search da API para Cards feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,8 segundos, em 1 chamadas medidas.