{"uid":"cap_zpvN-Rb6jIOlseElvmS57","slug":"collectablespulse-population-report-grade-scarcity-lookup-73fd93d6","name":"CollectablesPulse Population Report & Grade Scarcity Lookup","description":"Population report & grade scarcity: PSA/PCGS/CGC census lookup for any graded card, coin or comic. Returns how many exist at each grade, pop-with-higher, and scarcity analysis to gauge true rarity. Worldwide. For collector and investor agents.","url":"https://collectablespulse.theaslangroupllc.com/api/collect/population?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["item"],"properties":{"item":{"type":"string","description":"Collectible description (e.g. 1952 Topps Mickey Mantle)"},"lang":{"type":"string","description":"Response language (default en)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","errors":{"400":{"example":{"error":"item parameter required"},"description":"Invalid or missing parameter(s) — required: item. Returned before the payment gate on paid requests, so a malformed call is never charged. JSON body: { error: <what is wrong and how to fix it> } plus usage hints."},"402":{"description":"Payment required — x402 v2 challenge; the accepts array lists scheme, network, and amount. Retry the same request with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header. Verification is free."},"500":{"example":{"error":"upstream_failed"},"description":"Unexpected server error. If a payment settled without a usable result, contact info@theaslangroupllc.com with the settlement tx hash for a re-run or credit."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"8.0000","medianCents":"8.0000","p90Cents":"8.0000","minCents":"8.0000","maxCents":"8.0000","p95Cents":"8.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ft-O6ORIhNl0CV_58fqpF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up PSA, PCGS, and CGC census population data for graded cards, coins, and comics — returning counts at each grade, pop-higher totals, and scarcity analysis.","exampleAgentPrompt":"How many PSA 10 copies of a 2003 LeBron James Topps Chrome rookie card exist, and how does that compare to PSA 9s — is a PSA 10 actually scarce?","exampleUseCases":null,"resultDescription":"Returns a breakdown of how many copies of the collectible have been graded at each grade level by the specified grading service (PSA/PCGS/CGC), the count of copies graded higher than any given level (pop-higher), and a scarcity analysis indicating true rarity relative to the overall population.","failureModes":["Item not found in census — returns empty population or error if the collectible is too obscure or unlisted","Invalid grading service specified — returns error if PSA/PCGS/CGC is mismatched to item type (e.g. PCGS for a comic)","Ambiguous item identifier — if the card/coin/comic description is insufficiently specific, may return wrong item or no result","Census data stale — population data may lag behind the most recent grading service updates","Payment failure — x402 payment of $0.08 USDC not processed, returns 402 error"],"whenToPreferThis":"Use this endpoint when you need raw population and scarcity data from official grading service censuses (PSA, PCGS, CGC) for cards, coins, or comics — especially when a collector or investor agent needs to verify true rarity before buying, selling, or pricing a graded collectible. Prefer this over the investment signal endpoint when you specifically want census numbers and grade distribution rather than a buy/hold/sell recommendation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T18:35:55.593Z","isFirstParty":false,"canonicalSlug":"collectablespulse-population-report-grade-scarcity-lookup-73fd93d6"}