COMC Scraper API

レスポンスに関する注記

- `category` must be one of `comc-categories`' returned slugs; an unknown value returns `400` before any upstream request is made. Same for `sort`, each value in `attributes`, `condition`, and `page_size`. - Two facets visible on comc.com's own category/search page -- Listing Format (Auction/Buy Now/Both) and Sold Out (Ignore/Include/Only Sold Out) -- are **not** exposed as request filters here. Both are wired to an ASP.NET `__doPostBack` control on comc.com's own site rather than a plain URL parameter (confirmed live), so a stateless GET request cannot drive them the way `sort`/`attributes`/`condition` are driven. - `set_description` is COMC's own descriptive text for the set/base/parallel combination as a single string (e.g. `"Topps Chrome - [Base] - Red Wave Refractor"`) -- deliberately not further split into separate set/base/ parallel fields, since set names themselves routinely contain dashes and brackets, making that split unreliable to do generically. - `grade_label` and `print_run` are only present for graded cards (e.g. `"PSA 10 GEM MT"` / `"#/5"`); both are omitted for ungraded cards. - `price` is the price COMC's own search/category grid displays for this row. Best-effort labeled: COMC's grid shows one price per card+grade row aggregating potentially several sellers' listings, and this has not been live-confirmed to always be the lowest current listing -- treat it as COMC's own representative price for the row, not a guaranteed minimum. - A search with no matching cards returns `200` with an empty `cards` array.

レスポンスに関する注記

- A `handle` that is empty, or does not start with `Cards/` (after stripping a leading slash or a `https://www.comc.com` prefix), returns `400` before any upstream request is made. - `set_description`, `grade_label`, `year`, and `card_number` come from the listing title, which carries the full card identity (e.g. the title `"2021 Panini Absolute - [Base] - Red #36 - Josh Allen"` yields `year: "2021"`, `set_description: "Panini Absolute - [Base] - Red"`, `card_number: "36"`, `subject: "Josh Allen"`). `grade_label` is only present for graded cards. - `listings` is every individual seller copy of this exact card+grade combination, each with its own numeric `item_id`, `owner` username, `owner_url`, and `price` -- not a single aggregate price the way `comc-search`'s row-level `price` is. - `parallels` is every sibling parallel of the same base card (e.g. `"[Base]"`, `"Blue"`, `"Green"`), from the card's own "Parallels & Grades" table, each with COMC's own displayed price, a `handle` for a follow-up `comc-listing` lookup, and `for_sale_count`. A parallel with no current listings has `sold_out: true` and `price: 0` (COMC itself displays `$0.00` for that row rather than omitting it). - A `handle` COMC no longer serves returns `404`.

レスポンスに関する注記

- `kind` groups the taxonomy the way COMC's own nav does. Allowed values: `sports`, `trading`, `gaming`, `comics`. - Deliberately excludes several of COMC's own nav labels that are not their own category slug, but a query-filtered view within a parent category: "Star Trek" and "Garbage Pail Kids" are `Non-Sports` filtered by a keyword, "Star Wars TCG" and "Star Trek TCG" are `Gaming` filtered by a keyword, and "Ticket Stubs" is a `Publications` filtered by a keyword. Search for those by passing the parent category plus a matching `query` on `comc-search`, not as a separate category value. - `Star Wars` (trading-card category, not the gaming-card `Gaming` bucket) is the one slug that contains a literal space rather than a dash.