Endpoint Playground

Try the COMC search API

Searches or browses COMC's (comc.com) live consignment marketplace for graded and ungraded trading cards. Each result row is a distinct card+grade combination (COMC's own category/search grid aggregates every seller's copy under one row); chain a row's handle into the listing endpoint for the per-seller breakdown. At least one of category or query is typically useful, but both are optional -- omitting both searches all categories.

What a live request returned

14 Oct 2026: 20 cards; 8 fields had a value in every checked item and 1 varied between items.

Observed request: GET /comc/search?category=Baseball&page_size=20
Fields with a value in every checked item: handle, url, year, set_description, card_number, subject, image_url, price

Sample value profiles: year: 1,953 to 2,026, median 2,022; set_description: “Panini Donruss - Signature Series - Red” and 16 other values; url: comc.com.

Request: GET /comc/search
Cost: 4 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 15.44 s
Monitored request: GET /comc/search?category=Baseball&query=Josh+Allen

COMC search API documentation COMC platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/comc/search?sort=r&condition=aUngraded&page_size=6' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
category	string	No		Optional. One of comc_categories' slug values. Omit to search all categories.
query	string	No		Optional free-text search query.
sort	string	No	r	Optional. Allowed values: r (Recently Added, default), c (Card #), o (Oldest), n (Newest), b (Highest SRP), h (Highest Price), l (Lowest Price), d (Biggest Discount), p (Highest Percent Off), q (Print Run), s (Least in Stock), m (Most in Stock), e (Ending Soonest).
attributes	string	No		Optional, comma-separated. Allowed values: AUTO (Autographed), HOF (Hall of Fame), MEM (Memorabilia), PRC (Pre-Rookie Card), RC (Rookie Card), RR (Rookie Related), RY (Rookie Year), SN (Serial Numbered).
condition	string	No	aUngraded	Optional. Allowed values: aUngraded (Ungraded), aGraded (Graded), aAftermarketAuto (Aftermarket Auto), aAfterAutoGraded (Aftermarket Auto Graded).
page	integer	No		1-based page, default 1.
page_size	integer	No	6	Optional. Allowed values: 6, 8, 10, 12, 14, 15, 16, 18, 20, 24, 30, 40, 50, 64, 100. Omit to use COMC's own default.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "category": "Baseball",
    "page": 1,
    "total_count": 2653613,
    "cards": [
      {
        "handle": "Cards/Baseball/2021/Topps_Chrome_-_Base_-_Red_Wave_Refractor/84/Nolan_Arenado/17500366/Graded/PSA/10",
        "url": "https://www.comc.com/Cards/Baseball/2021/Topps_Chrome_-_Base_-_Red_Wave_Refractor/84/Nolan_Arenado/17500366/Graded/PSA/10",
        "year": "2021",
        "set_description": "Topps Chrome - [Base] - Red Wave Refractor",
        "card_number": "84",
        "subject": "Nolan Arenado",
        "grade_label": "PSA 10 GEM MT",
        "print_run": "#/5",
        "image_url": "https://img.comc.com/i/Baseball/2021/Topps-Chrome---Base---Red-Wave-Refractor/84/Nolan-Arenado.jpg",
        "price": 64930
      }
    ]
  }
}

More COMC endpoints

List COMC categories Get COMC card listing detail

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey4 credits/requestcomc.searchResponseDocCOMC

GET /comc/search

Search COMC card listings

Response behavior

- `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.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "category": "Baseball",
    "page": 1,
    "total_count": 2653613,
    "cards": [
      {
        "handle": "Cards/Baseball/2021/Topps_Chrome_-_Base_-_Red_Wave_Refractor/84/Nolan_Arenado/17500366/Graded/PSA/10",
        "url": "https://www.comc.com/Cards/Baseball/2021/Topps_Chrome_-_Base_-_Red_Wave_Refractor/84/Nolan_Arenado/17500366/Graded/PSA/10",
        "year": "2021",
        "set_description": "Topps Chrome - [Base] - Red Wave Refractor",
        "card_number": "84",
        "subject": "Nolan Arenado",
        "grade_label": "PSA 10 GEM MT",
        "print_run": "#/5",
        "image_url": "https://img.comc.com/i/Baseball/2021/Topps-Chrome---Base---Red-Wave-Refractor/84/Nolan-Arenado.jpg",
        "price": 64930
      }
    ]
  }
}

Try the COMC search API

What a live request returned

14 Oct 2026: 20 cards; 8 fields had a value in every checked item and 1 varied between items.

Observed request: GET /comc/search?category=Baseball&page_size=20
Fields with a value in every checked item: handle, url, year, set_description, card_number, subject, image_url, price

Sample value profiles: year: 1,953 to 2,026, median 2,022; set_description: “Panini Donruss - Signature Series - Red” and 16 other values; url: comc.com.

Request: GET /comc/search
Cost: 4 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 15.44 s
Monitored request: GET /comc/search?category=Baseball&query=Josh+Allen

COMC search API documentation COMC platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/comc/search?sort=r&condition=aUngraded&page_size=6' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
category	string	No		Optional. One of comc_categories' slug values. Omit to search all categories.
query	string	No		Optional free-text search query.
sort	string	No	r	Optional. Allowed values: r (Recently Added, default), c (Card #), o (Oldest), n (Newest), b (Highest SRP), h (Highest Price), l (Lowest Price), d (Biggest Discount), p (Highest Percent Off), q (Print Run), s (Least in Stock), m (Most in Stock), e (Ending Soonest).
attributes	string	No		Optional, comma-separated. Allowed values: AUTO (Autographed), HOF (Hall of Fame), MEM (Memorabilia), PRC (Pre-Rookie Card), RC (Rookie Card), RR (Rookie Related), RY (Rookie Year), SN (Serial Numbered).
condition	string	No	aUngraded	Optional. Allowed values: aUngraded (Ungraded), aGraded (Graded), aAftermarketAuto (Aftermarket Auto), aAfterAutoGraded (Aftermarket Auto Graded).
page	integer	No		1-based page, default 1.
page_size	integer	No	6	Optional. Allowed values: 6, 8, 10, 12, 14, 15, 16, 18, 20, 24, 30, 40, 50, 64, 100. Omit to use COMC's own default.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "category": "Baseball",
    "page": 1,
    "total_count": 2653613,
    "cards": [
      {
        "handle": "Cards/Baseball/2021/Topps_Chrome_-_Base_-_Red_Wave_Refractor/84/Nolan_Arenado/17500366/Graded/PSA/10",
        "url": "https://www.comc.com/Cards/Baseball/2021/Topps_Chrome_-_Base_-_Red_Wave_Refractor/84/Nolan_Arenado/17500366/Graded/PSA/10",
        "year": "2021",
        "set_description": "Topps Chrome - [Base] - Red Wave Refractor",
        "card_number": "84",
        "subject": "Nolan Arenado",
        "grade_label": "PSA 10 GEM MT",
        "print_run": "#/5",
        "image_url": "https://img.comc.com/i/Baseball/2021/Topps-Chrome---Base---Red-Wave-Refractor/84/Nolan-Arenado.jpg",
        "price": 64930
      }
    ]
  }
}

Search COMC card listings

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "category": "Baseball", "page": 1, "total_count": 2653613, "cards": [ { "handle": "Cards/Baseball/2021/Topps_Chrome_-_Base_-_Red_Wave_Refractor/84/Nolan_Arenado/17500366/Graded/PSA/10", "url": "https://www.comc.com/Cards/Baseball/2021/Topps_Chrome_-_Base_-_Red_Wave_Refractor/84/Nolan_Arenado/17500366/Graded/PSA/10", "year": "2021", "set_description": "Topps Chrome - [Base] - Red Wave Refractor", "card_number": "84", "subject": "Nolan Arenado", "grade_label": "PSA 10 GEM MT", "print_run": "#/5", "image_url": "https://img.comc.com/i/Baseball/2021/Topps-Chrome---Base---Red-Wave-Refractor/84/Nolan-Arenado.jpg", "price": 64930 } ] } }