API Cards

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.

POST/v1/run/cards.population_search
Disponibilité
100,00%
30d · 1 appel
Requêtes
1
30d
Réponse
1,8s
médiane · 30d

Tarifs

Tarifs de l’API Cards Population search

Fournisseurs
Chameleon- servis- de disponibilité- p502,25 $US/1k reqforfait fixe
Vous payez
22,50 $US
2,25 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 44 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez Cards Population search en une requête

Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse
Les exécutions gratuites ne renvoient que les 3 premiers résultats. Alimentez une clé pour obtenir la réponse complè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.

Vous envoyez. Un petit corps JSON. Les valeurs affichées sont des exemples à remplacer par les vôtres.

Réponse

JSON, une valeur d’exemple par champ.

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.

Vous recevez. Des champs nommés et typés, dans la même forme quelle que soit la source qui répond.

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.

Elle coûte à partir de 2,25 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Vous alimentez un portefeuille en USD et chaque appel le débite. Certaines requêtes échouées financées par le portefeuille entraînent des frais de traitement que nous répercutons au prix coûtant, sans marge ; la réponse d’erreur indique le montant facturé.

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 réponse est du JSON normalisé avec la même enveloppe que celle de tous les endpoints AnyAPI, donc analyser un second endpoint revient à changer l’URL et rien d’autre.

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. Ce sont les propres mesures d’AnyAPI du trafic passant par la passerelle, recalculées en continu, et non un objectif de niveau de service publié.

Oui. Un nouveau compte AnyAPI démarre avec 0,10 $US de solde gratuit, sans carte, ce qui couvre 44 appels Cards Population search à 0,00225 $US chacun.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/cards.population_search avec votre clé AnyAPI dans un en-tête « Authorization: Bearer » et l’entrée en corps JSON. La même clé et le même portefeuille fonctionnent sur tous les endpoints AnyAPI.

Non. Vous ajoutez des dollars US à un solde AnyAPI prépayé unique et chaque requête le débite. Il n’y a ni forfait mensuel ni minimum, et le même solde paie tous les endpoints AnyAPI.

Oui. Installez @getanyapi/sdk depuis npm pour TypeScript ou getanyapi depuis pip pour Python. Les deux appellent chaque endpoint AnyAPI avec la même clé, et n’importe quel client HTTP fonctionne aussi.

Oui. Un agent peut se connecter au serveur MCP d’AnyAPI à https://api.getanyapi.com/mcp, ou créer sa propre clé d’essai gratuit avec un seul POST non authentifié vers https://api.getanyapi.com/agent/signup et appeler cet endpoint en HTTP.