API de Cards

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.

POST/v1/run/cards.population_search
Disponibilidad
100.00%
30d · 1 llamada
Solicitudes
1
30d
Respuesta
1.8s
mediana · 30d

Precios

Precios del endpoint Population search de la API de Cards

Proveedores
Chameleon- atendidas- de disponibilidad- p50US$2.25/1k solic.tarifa fija
Pagas
US$22.50
US$2.25/1k solic., solo por lo que usas. Sin plan mensual.
Tus primeras 44 solicitudes son gratis con el saldo inicial de US$0.10.

Pruébalo

Obtén Population search de Cards en una sola solicitud

Abrir en
Respuesta de ejemplo
Las ejecuciones gratis devuelven solo los primeros 3 resultados. Agrega fondos a una clave para obtener la respuesta completa.
{
  "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.

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo por campo.

datadata

Matching cards, or null when nothing matched.

  • hasMoreboolean

    True when another page of matches exists.

each itemdata.items[]

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.

top level
  • 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.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

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.

Cuesta desde US$2.25 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto cobrado.

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. La respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

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. Estas son mediciones propias de AnyAPI sobre el tráfico que pasa por el gateway, recalculadas continuamente, no un objetivo de nivel de servicio publicado.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta, que alcanza para 44 llamadas a Population search de Cards a US$0.00225 cada una.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/cards.population_search con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.