API de Cards: Graded cert
Look up one graded trading card slab by its PSA, BGS, SGC or CGC certificate number and get the card (year, set, number, player or character, variety), its grade with BGS subgrades, the approximate population in that grade, the estimated market value with its low and high range, the last sale of any copy in that grade, and the sales of this exact slab that carry its certificate number (eBay and Fanatics Collect sales only from about the last 90 days, when the seller put the number in the title), in one normalized response. Sports cards, Pokemon and other trading card games.
Precios
Precios del endpoint Graded cert de la API de Cards
Pruébalo
Obtén Graded cert de Cards en una sola solicitud
{
"data": {
"cardName": "Example title",
"cardNumber": "example",
"category": "general",
"certNumber": "example",
"certUrl": "https://example.com/page",
"grade": 12.5,
"gradeLabel": "Example title",
"gradingCompany": "Acme Inc",
"image": "https://example.com/image.jpg",
"lastSaleInGrade": {
"marketplace": "example",
"price": 19.99,
"saleType": "general",
"soldUtc": 12.5,
"url": "https://example.com/page"
},
"populationInGrade": 42,
"qualifier": "example",
"sales": [
{
"grade": "example",
"image": "https://example.com/image.jpg",
"marketplace": "example",
"matchedBy": "example",
"price": 19.99,
"saleId": "a1b2c3d4",
"saleType": "general",
"shippingPrice": 19.99,
"soldUtc": 12.5,
"title": "Example title",
"url": "https://example.com/page"
}
],
"salesInGrade": 42,
"set": "example",
"subgrades": {
"centering": 12.5,
"corners": 12.5,
"edges": 12.5,
"surfaces": 12.5
},
"subject": "Example title",
"value": 19.99,
"valueConfidence": 19.99,
"valueHigh": 19.99,
"valueLow": 19.99,
"variety": "example",
"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.
- certNumberstring
0011562845
Certificate number printed on the slab label, digits only, e.g. 171634124. Keep any leading zeros: BGS numbers start with 00 (0011562845).
- gradingCompanyenum
BGS
The company that graded the slab. Required because the same number can exist at two graders (4272318 is both a PSA and an SGC cert).
Respuesta
JSON, un valor de ejemplo por campo.
The graded slab, or null when no slab has that certificate number at that grading company.
- cardNamestring
Full card name, e.g. "1999 Pokemon Game Holo Charizard #4". Populated whenever the provider has data for the entity.
- cardNumberstring
Card number within the set.
- categorystring
Card category, e.g. pokemon, basketball or football.
- certNumberstring
Certificate number of the slab. Populated whenever the provider has data for the entity.
- certUrlstring
The grading company's own certificate verification page, when it has one (PSA).
- gradenumber
Numeric grade, e.g. 9.5. Populated whenever the provider has data for the entity.
- gradeLabelstring
Grade as printed with its grader, e.g. "PSA 9" or "BGS 9.5".
- gradingCompanystring
Grading company of the slab: PSA, BGS, SGC or CGC. Populated whenever the provider has data for the entity.
- imagestring
Card image URL, when one is known.
- populationInGradeinteger
Approximate number of copies of this card graded at this grade by this grader. It tracks the grader's own population report closely (within about 2% for PSA) but is not the official count.
- qualifierstring
Grade qualifier such as OC (off center) or MK (marks), or null when the grade has none.
- salesInGradeinteger
Number of recorded sales of any copy of this card at this grade.
- setstring
Set name, e.g. "Pokemon Game" or "Fleer".
- subjectstring
Player or character on the card.
- valuenumber
Estimated market value in USD of this card at this grade, modeled from recent sales.
- valueConfidencenumber
Confidence in the estimated value, 0 to 100. Higher means more recent comparable sales.
- valueHighnumber
High end of the estimated value range in USD.
- valueLownumber
Low end of the estimated value range in USD.
- varietystring
Variety or parallel, e.g. "1st Edition Holo" or "Refractor", or null for the base card.
- yearinteger
Year of the card's set.
The most recent sale of any copy of this card at this grade. Every member is null when none is recorded.
- marketplacestring
Where it sold, as a lowercase marketplace id, e.g. ebay, fanatics (Fanatics Collect, including former PWCC venues), goldin or heritage.
- pricenumber
Sale price in USD.
- saleTypestring
How it sold: AUCTION, BUY_IT_NOW or BEST_OFFER.
- soldUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- urlstring
Link to the sold listing.
Sales of this exact slab that carry its certificate number, newest first. Sales recorded with the number itself are kept whatever their age; eBay and Fanatics Collect sales are found only from about the last 90 days and only when the seller wrote the number in the title. Empty when no such sale is found, which does not mean the slab never sold.
- gradestring
Grade as listed, e.g. "PSA 6".
- imagestring
Listing photo URL.
- marketplacestring
Where it sold, as a lowercase marketplace id, e.g. ebay, fanatics (Fanatics Collect, including former PWCC venues), goldin or heritage.
- matchedBystring
How the sale was tied to this slab: cert_field (the sale record carries the certificate number) or title (the seller wrote the number in the listing title).
- pricenumber
Sale price in USD.
- saleIdstring
Identifier of the sale record.
- saleTypestring
How it sold: AUCTION, BUY_IT_NOW or BEST_OFFER.
- shippingPricenumber
Shipping charged in USD, when known.
- soldUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- titlestring
Listing title.
- urlstring
Link to the sold listing.
BGS subgrades. Every member is null for graders that do not issue subgrades.
- centeringnumber
Centering subgrade.
- cornersnumber
Corners subgrade.
- edgesnumber
Edges subgrade.
- surfacesnumber
Surface subgrade.
- foundboolean
True when the certificate number resolved to a graded slab at that grading company.
- 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 Graded cert de la API de Cards
El endpoint Graded cert de AnyAPI para Cards devuelve datos de Cards como JSON normalizado con una sola llamada POST a /v1/run/cards.graded_cert. Look up one graded trading card slab by its PSA, BGS, SGC or CGC certificate number and get the card (year, set, number, player or character, variety), its grade with BGS subgrades, the approximate population in that grade, the estimated market value with its low and high range, the last sale of any copy in that grade, and the sales of this exact slab that carry its certificate number (eBay and Fanatics Collect sales only from about the last 90 days, when the seller put the number in the title), in one normalized response. Sports cards, Pokemon and other trading card games. AnyAPI devuelve un único esquema normalizado sin importar qué fuente atienda la solicitud. Cuesta desde US$3.38 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 Graded cert de la API de Cards a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 6.8 segundos en 2 llamadas medidas.