Getcollectr APIapp.getcollectr.com ↗
Search and retrieve detailed information about collectible trading cards and sealed products, including current market prices, historical price trends, and grading data to track and compare your collection's value. Find specific cards or products quickly and access comprehensive market insights to make informed collecting and trading decisions.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace app-getcollectr-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Collectr SDK — search trading cards, inspect pricing and grades."""
from parse_apis.app_getcollectr_com_api import Collectr, ProductNotFound
client = Collectr()
# Search for products by name — limit caps total items fetched.
for card in client.product_summaries.search(query="charizard", limit=5):
print(card.product_name, card.catalog_group, card.rarity)
# Drill into the first result for full pricing details.
summary = client.product_summaries.search(query="pikachu", limit=1).first()
if summary:
product = summary.details()
print(product.product_name, product.market_price, product.catalog_category_name)
for graded in product.graded_sub_types:
print(f" Grade {graded.grade_id}: ${graded.market_price}")
# Fetch a product directly by its ID.
try:
detail = client.products.get(product_id="684462")
print(detail.product_name, detail.rarity, detail.market_price)
except ProductNotFound as exc:
print(f"Product not found: {exc.product_id}")
print("exercised: product_summaries.search / summary.details / products.get")
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
The Getcollectr API on Parse exposes 2 endpoints for the publicly available data on app.getcollectr.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.