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. Price range: min_price and max_price (USD, inclusive) keep only listings whose displayed asking price falls inside the range. COMC offers no server-side price filter, so the range is applied to the listings of the requested page: page, total_listings and total_pages still describe the unfiltered site result stream, listings_on_page is the unfiltered count of that page and matched_on_page the count returned after the price filter (a page can legitimately return zero matches while later pages still match). To scan a whole price range, combine the filter with sort=lowest_price or sort=highest_price and walk pages until price_range_exhausted becomes true (it is true once the price-ordered stream has passed the bound, so no later page can match; null for other sorts or when no price bound is given). 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, a non-numeric or negative price bound, or min_price greater than max_price 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. |
| max_price | number | Highest asking price to keep, in USD (inclusive, e.g. 5500). Applied to the listings of the requested page; must not be lower than min_price. When omitted, no upper bound is applied. |
| min_price | number | Lowest asking price to keep, in USD (inclusive, e.g. 250 or 250.50). Applied to the listings of the requested page; see the endpoint description for how to scan a price range across pages. When omitted, no lower bound is applied. |
| 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 (displayed string), price_value (numeric USD), on_sale, team (null when not available from search results), and optional attributes, quantity_available, and auction_time_left",
"max_price": "Upper price bound applied (number, USD), or null when not given",
"min_price": "Lower price bound applied (number, USD), or null when not given",
"total_pages": "Total number of pages available on the site (before any price filter)",
"listing_type": "Listing type filter applied, or null if not filtered",
"total_listings": "Total number of matching listings across all pages on the site (before any price filter)",
"matched_on_page": "Number of listings returned after applying min_price/max_price (equals listings_on_page when no bound is given)",
"listings_on_page": "Number of listings the site returned on this page before the price filter",
"listings_per_page": "Number of listings per page as served by the site (up to 100)",
"price_range_exhausted": "With sort=lowest_price (or highest_price) and a max_price (or min_price) bound: true once this page's prices have passed the bound so no later page can match; null otherwise"
},
"sample": {
"data": {
"page": 1,
"sort": "highest_srp",
"query": "Michael Jordan",
"grader": null,
"category": "Basketball",
"listings": [
{
"url": "https://www.comc.com/Cards/Basketball/1996-97/Topps_Stadium_Club_-_Shining_Moments/SM_2/Michael_Jordan/1467746/Graded/PSA/10",
"team": null,
"price": "$2,055.32",
"title": "Michael Jordan [PSA 10 GEM MT]",
"on_sale": true,
"image_url": "https://img.comc.com/i/Basketball/1996-97/Topps-Stadium-Club---Shining-Moments/SM-2/Michael-Jordan.jpg?id=79825fef-6f39-47ec-abf4-52728c1586ee&size=biggerthumb",
"attributes": [
"Hall of Fame"
],
"price_value": 2055.32,
"set_description": "1996-97 Topps Stadium Club - Shining Moments #SM 2"
},
{
"url": "https://www.comc.com/Cards/Basketball/1989/Los_Ases_de_la_NBA_Stickers_-_Base/13/Michael_Jordan/27942964/Graded/CGC_Cards/4",
"team": null,
"price": "$476.33",
"title": "Michael Jordan [CGC 4 VG/EX]",
"on_sale": true,
"image_url": "https://img.comc.com/i/Basketball/1989/Los-Ases-de-la-NBA-Stickers---Base/13/Michael-Jordan.jpg?id=1ccd6d18-696b-4709-a507-c9d22f6d9497&size=biggerthumb",
"attributes": [
"Hall of Fame"
],
"price_value": 476.33,
"set_description": "1989 Los Ases de la NBA Stickers - [Base] #13",
"quantity_available": 2
}
],
"max_price": 5500,
"min_price": 250,
"total_pages": 77,
"listing_type": null,
"total_listings": 7670,
"matched_on_page": 89,
"listings_on_page": 100,
"listings_per_page": 100,
"price_range_exhausted": null
},
"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.