Getcollectr APIapp.getcollectr.com ↗
Search and retrieve trading card market prices, grading data, and price history from the Collectr catalog via 3 REST endpoints.
What is the Getcollectr API?
The Collectr API exposes 3 endpoints for querying trading cards and sealed collectible products, returning current market prices, graded sub-type pricing, and historical price snapshots. Use search_products to find cards by name with metadata like rarity, set, and card number, then pull full pricing and grade-filtered data with get_product_details or fetch trimmed records for multiple products at once via get_products_bulk.
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.
| 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
What the API Covers
The Collectr API gives access to the Collectr catalog of trading cards and sealed collectible products. Each product carries fields including product_name, catalog_group (the set or series), card_number, rarity, is_card, market_price, and an image_url. Products span both raw/ungraded items and graded variants tracked across companies like PSA, BGS, CGC, TAG, ACE, and AGS.
Searching and Retrieving Products
search_products accepts a query string and returns paginated results controlled by limit and offset. Each result includes a product_id that feeds directly into the other two endpoints. get_product_details takes a single product_id and returns the full record: market_price, a description field with HTML-formatted card attributes, graded_sub_types with per-grade pricing, and a price_history array of snapshots carrying insertion_date, price, grade_label, grade_value, grading_company, and product_sub_type. The optional grading_company and grade_id parameters filter both graded_sub_types and price_history to a specific grader or numeric grade.
Bulk Retrieval
get_products_bulk accepts a comma-separated list of product_ids and returns one trimmed result per ID in the same input order. It mirrors the filtering params (grading_company, grade_id) from get_product_details but omits price_history, making it efficient for portfolio-scale lookups where historical trends are not needed. The response array maintains order parity with the input list, so index alignment is reliable.
Data Notes
Market prices are expressed as strings in the response. The description field contains HTML markup and may need client-side stripping for plain-text display. Grade labels and values are resolved within each entry, so you do not need a separate lookup to interpret a grade ID returned by a search.
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 current market prices for a collection of PSA-graded Pokémon cards by passing multiple product IDs to get_products_bulk
- Build a price-trend chart using the price_history snapshots returned by get_product_details for a single card
- Filter graded sub-type pricing to a specific grading company (e.g. BGS) using the grading_company parameter
- Look up card metadata — set, rarity, card number — for catalog entries via search_products before fetching full details
- Compare ungraded versus graded market prices for the same product using graded_sub_types and market_price fields
- Implement autocomplete-style card search in a collection management app using the paginated search_products endpoint
- Retrieve sealed product pricing alongside single-card data since is_card distinguishes cards from sealed items
| 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.