Getcollectr APIapp.getcollectr.com ↗
Search trading cards and sealed products on Collectr. Get market prices, price history, graded sub-type pricing, and cross-company grade comparisons via 5 endpoints.
What is the Getcollectr API?
The Collectr API exposes 5 endpoints covering the Collectr catalog of trading cards and sealed products, returning current market prices, historical price data, and graded sub-type breakdowns. The get_product_details endpoint delivers per-grade pricing across companies like PSA, BGS, and CGC, while compare_graded_prices lets you benchmark one grading company's price against others at the same numeric grade for any given card.
curl -X GET 'https://api.parse.bot/scraper/f9af367c-0a37-4e37-b6fe-637f181eaf96/search_products?limit=10&query=charizard&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search the Collectr catalog for trading cards and sealed products by name. Returns matching products with basic metadata including category, set, card number, and rarity. Results are paginated via offset/limit. If the upstream search service returns invalid or fabricated data (detectable by non-Collectr image URLs), the endpoint returns an upstream_error rather than passing through fake results.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return per request. |
| queryrequired | string | Search query string to match against product names. |
| offset | integer | Number of results to skip for pagination. |
{
"type": "object",
"fields": {
"items": "array of product summaries with product_id, product_name, catalog_category_name, catalog_group, card_number, rarity, is_card, image_url",
"limit": "integer",
"offset": "integer"
},
"sample": {
"data": {
"items": [
{
"rarity": "Promo",
"is_card": true,
"image_url": "https://public.getcollectr.com/public-assets/products/product_659612.png?optimizer=image&format=webp&width=1200&quality=80&strip=metadata",
"product_id": "659612",
"card_number": "023",
"product_name": "Mega Charizard X ex",
"catalog_group": "Mega Evolution Promos",
"catalog_category_name": "Pokemon"
}
],
"limit": 10,
"offset": 0
},
"status": "success"
}
}About the Getcollectr API
Search and Browse the Catalog
The search_products endpoint accepts a query string and returns paginated product summaries including product_id, product_name, catalog_category_name, catalog_group, card_number, rarity, and is_card. Use offset and limit to page through results. The get_products_by_group endpoint takes a group_query string matched case-insensitively against set names — useful for pulling all cards in a named set like "Terastal Festival ex" or "VMAX Climax" — and returns each product with its collected product_sub_types and a resolved group_name.
Product Details and Pricing
get_product_details returns the full record for a single product: market_price, description (HTML-formatted card attributes), image_url, and both ungraded and graded_sub_types pricing. You can filter graded entries by passing a grading_company symbol (e.g. PSA, BGS, CGC, TAG, ACE, AGS) and/or a grade_id. Price history across grades is included and can be filtered the same way. All monetary fields are returned in the currency specified by the currency parameter (defaults to USD). get_products_bulk accepts a comma-separated list of product_ids and returns trimmed details — core pricing and grading data without price history — for up to many products in one call.
Grading Company Price Comparisons
The compare_graded_prices endpoint answers the question of how a card's market price differs across grading companies at the same numeric grade. Set base_company as the reference (defaults to CGC), pass grade_value (e.g. '10', '9.5'), and optionally specify compare_companies as a comma-separated list. The response includes a comparisons array with per-printing results, each containing the base company's price, the compared company's price, absolute and percentage differences, and an exchange_rate field when a non-USD currency is requested.
The Getcollectr API is a managed, monitored endpoint for app.getcollectr.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when app.getcollectr.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official app.getcollectr.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track market price changes over time for specific PSA 10 or BGS 9.5 graded cards using price history from
get_product_details - Build a collection valuation tool by calling
get_products_bulkwith a list of owned product IDs to fetch current market prices in bulk - Compare whether a CGC 10 commands a premium or discount versus a PSA 10 for the same card using
compare_graded_prices - Pull the complete card list for a newly released set using
get_products_by_groupwith the set name asgroup_query - Display graded sub-type pricing breakdowns filtered by grading company on a portfolio dashboard using the
grading_companyparameter - Search the catalog for specific cards by name to resolve their
product_idbefore fetching detailed pricing viaget_product_details - Surface price differences across grading companies at grade 9 versus grade 10 to inform grading submission decisions
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Collectr have an official developer API?+
What grading companies and grade values does `compare_graded_prices` support?+
base_company and compare_companies. The grade_value parameter accepts numeric grades as Collectr lists them (e.g. '10', '9.5', '9'). Only grades that exist in the product's graded sub-types for the given companies are included in the comparisons array — if a company has no data at the requested grade, it is omitted.What does `get_products_bulk` return compared to `get_product_details`?+
get_products_bulk returns core pricing and grading data for multiple products in one call but omits price_history. get_product_details is a single-product call and includes full price history across grades, filterable by grading_company and grade_id. Use bulk for portfolio snapshots and single-product details when historical trend data is needed.Does the API cover population report data from grading companies?+
Is there a limitation on how `get_products_by_group` handles pagination?+
limit and offset parameters control raw catalog rows fetched, not the final product count. Because product variants are aggregated into product_sub_types, the number of unique products returned can be fewer than the requested limit. Paginating accurately requires adjusting offset in increments of the raw row limit and accounting for deduplication in the response.