COMC APIcomc.com ↗
Search and retrieve sports card listings from COMC marketplace. Access card prices, grading filters, seller data, and parallel variants via 2 endpoints.
What is the COMC API?
The COMC API exposes 2 endpoints for searching and inspecting trading card listings on the Check Out My Cards marketplace. The search_listings endpoint returns up to 100 cards per page with pricing, grading, and category filters, while get_card_listings retrieves every active buy-now offer for a specific card alongside its parallel variants and per-seller inventory.
curl -X GET 'https://api.parse.bot/scraper/214a63d8-8383-4871-9267-593aec0bf063/search_listings?page=1&query=Michael+Jordan&grader=PSA&category=Basketball&listing_type=buy_now' \ -H 'X-API-Key: $PARSE_API_KEY'
Search or browse sports card listings on COMC by keyword. Returns paginated results; each page returns up to 100 listings with card details, pricing, and seller availability. Results are ordered by Highest SRP (Suggested Retail Price) unless a sort is given; sort exposes COMC's full 'Sort By' menu, including recently_added (newest inventory first, useful for scanning fresh listings), price and discount orders, and ending_soonest for auctions. Supports optional category filtering (e.g. Baseball, Basketball, Football, Hockey), grading company filtering (e.g. PSA, BGS, SGC), and listing type filtering (auction or buy_now). When query is omitted, browses all listings matching the applied filters (the whole marketplace when no filter is given). Use the page parameter to paginate through results; one round trip per page. Each listing's url is a COMC card page for buy-now listings (usable as card_url in get_card_listings) or an eBay promotion page for auction listings. An unrecognized sort value is rejected as invalid input.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-indexed). Each page contains up to 100 listings. |
| sort | string | Result ordering from COMC's 'Sort By' menu. When omitted, results are ordered by Highest SRP (highest_srp). recently_added lists the most recently added inventory first. |
| query | string | Search query for cards (e.g. player name, set name, card number). When omitted, returns all listings matching other filters. |
| grader | string | Grading company filter. When omitted, returns all listings regardless of grading. Observed values include PSA, BGS, SGC, CGC, CSG. |
| category | string | Sport category filter. When omitted, searches across all categories. Observed values include Baseball, Basketball, Football, Hockey, MultiSport. |
| listing_type | string | Listing format filter. When omitted, returns both auction and buy-now listings. |
{
"type": "object",
"fields": {
"page": "Current page number",
"sort": "Sort order applied (SortOrder value); highest_srp when sort was omitted",
"query": "The search query used, or empty string if browsing without query",
"grader": "Grading company filter applied, or null if not filtered",
"category": "Category filter applied, or null if not filtered",
"listings": "Array of card listing objects with set_description, title, url, image_url, price, on_sale, team (null when not available from search results), and optional attributes, quantity_available, and auction_time_left",
"total_pages": "Total number of pages available",
"listing_type": "Listing type filter applied, or null if not filtered",
"total_listings": "Total number of matching listings across all pages",
"listings_per_page": "Number of listings per page (up to 100)"
},
"sample": {
"data": {
"page": 1,
"sort": "recently_added",
"query": "Michael Jordan",
"grader": null,
"category": "Basketball",
"listings": [
{
"url": "https://www.comc.com/Cards/Basketball/1992-93/Upper_Deck_-_Base/488/Game_Faces_-_Michael_Jordan/1413210",
"team": null,
"price": "$3.53",
"title": "Game Faces - Michael Jordan",
"on_sale": true,
"image_url": "https://img.comc.com/i/Basketball/1992-93/Upper-Deck---Base/488/Game-Faces---Michael-Jordan.jpg?id=fe533ee9-031e-4866-ae22-b0b5a7b02770&size=biggerthumb",
"attributes": [
"Hall of Fame"
],
"set_description": "1992-93 Upper Deck - [Base] #488",
"quantity_available": 107
},
{
"url": "https://www.comc.com/Cards/Basketball/1989-90/Fleer_-_Base/21/Michael_Jordan/1398903/Graded/PSA/7",
"team": null,
"price": "$109.62",
"title": "Michael Jordan [PSA 7 NM]",
"on_sale": true,
"image_url": "https://img.comc.com/i/Basketball/1989-90/Fleer---Base/21/Michael-Jordan.jpg?id=1df8f4ab-e653-4731-8cf6-3e8eeb35bf58&size=biggerthumb",
"attributes": [
"Hall of Fame"
],
"set_description": "1989-90 Fleer - [Base] #21"
}
],
"total_pages": 76,
"listing_type": "buy_now",
"total_listings": 7559,
"listings_per_page": 100
},
"status": "success"
}
}About the COMC API
Searching Card Listings
The search_listings endpoint accepts a query string (player name, set name, card number) and optional filters: grader (e.g. PSA, BGS), category (e.g. Baseball, Basketball), and listing_type (auction vs. buy-now). Results are paginated at up to 100 listings per page; total_listings and total_pages let you walk the full result set. Each listing object includes title, url, image_url, price, on_sale, set_description, and team (when available). The default sort is highest_srp; the sort parameter maps to COMC's Sort By menu options.
Inspecting a Specific Card
The get_card_listings endpoint accepts a card_url exactly as returned in search_listings results and returns three collections for that card page. listings contains individual items for sale (12 per page), each with seller, item_id, price, price_value, and on_sale. variants covers the card's Parallels & Grades tab — each row includes name, kind (parallel or grade), url, and price fields, so you can follow variant URLs as new card_url inputs. sellers provides a per-seller summary including an 'All Sellers' aggregate row.
Pagination and Coverage
Both endpoints are paginated. search_listings pages hold up to 100 items; get_card_listings pages hold 12 items. The variants and sellers collections on get_card_listings are returned in full on every page request regardless of the page parameter — only the listings array changes per page. COMC's inventory spans Baseball, Basketball, Football, Hockey, and other categories, covering raw and graded cards from a wide range of sets and eras.
The COMC API is a managed, monitored endpoint for comc.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when comc.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 comc.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 price trends for a specific player's cards by querying
search_listingswith a player name and sorting by price. - Compare all active buy-now offers for a graded PSA card using
get_card_listingsto see per-seller pricing side by side. - Build a parallel card inventory by walking the
variantsarray returned byget_card_listingsfor a base card URL. - Filter COMC listings to graded-only inventory by passing a
gradervalue such as PSA or BGS tosearch_listings. - Monitor total supply of a specific card using
total_listingsfromget_card_listingsacross paginated item results. - Aggregate auction vs. buy-now availability by toggling the
listing_typefilter insearch_listings. - Identify on-sale cards in a category by checking the
on_salefield across paginatedsearch_listingsresults.
| 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 COMC have an official developer API?+
What does `get_card_listings` return beyond individual sale items?+
listings array of individual items (seller, item_id, price, on_sale), it returns a variants array covering every parallel and grade variant of the card — each with its own url you can pass as a new card_url — and a sellers array with per-seller inventory summaries including an 'All Sellers' aggregate row.Can I retrieve historical sold prices or completed auction data from COMC?+
How does pagination work across the two endpoints?+
search_listings returns up to 100 listings per page and exposes total_pages and total_listings so you can iterate the full result set. get_card_listings returns 12 items per page in its listings array, but the variants and sellers collections are returned in full on every page regardless of which page value you pass.Does the API expose seller profile details or seller ratings?+
sellers collection in get_card_listings includes seller username, item kind, and pricing summary. Full seller profile pages, feedback scores, and seller reputation data are not included. You can fork this API on Parse and revise it to add a seller profile endpoint that covers those fields.