Docs menu

COMC API endpoint

COMC card listing detail API

Returns one card+grade combination's full detail from COMC (comc.com): card identity and every seller's individual for-sale copy (owner, item id, price). handle is the value returned by comc_search's CardSummary.handle field (or the equivalent comc.com card URL path).

GETapiKey4 credits/requestCOMCcomc.listingResponseDoc/comc/listing

Endpoint facts

Method: GET
API path: /comc/listing
Auth: apiKey
Credits: 4 credits/request
Charged on: Successful 2xx responses only
Platform: COMC
Response schema: #/definitions/comc.listingResponseDoc

COMC Scraper API Try COMC card listing detail API in Playground COMC API documentation

How this endpoint behaves

Query parameters:

handle (required) -- the value returned by a comc-search result's own handle field, e.g. Cards/Football/2021/Panini_Absolute_-_Base_-_Red/36/Josh_Allen/17779360. Also accepts a full https://www.comc.com/... card URL.

Notable response behavior:

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.

Live monitoring

Monitored request: GET /comc/listing?handle=Cards%2FFootball%2F2021%2FPanini_Absolute_-_Base_-_Red%2F36%2FJosh_Allen%2F17779360
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 14.16 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /comc/listing?handle=Cards%2FFootball%2F2021%2FPanini_Absolute_-_Base_-_Red%2F36%2FJosh_Allen%2F17779360
Items in listings: 1
Fields filled in every checked item: 4

Field	Filled in, of 1 checked	Values in the sample
item_id	1
owner	1
owner_url	1	comc.com
price	1	3.69

Request parameters

Parameter	Type	Required	Default	Description	Example
handle	string	Yes		Required. The handle from a comc_search result (or the equivalent comc.com card URL path).	Cards/Football/2021/Panini_Absolute_-_Base_-_Red/36/Josh_Allen/17779360
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/comc/listing?handle=Cards%2FFootball%2F2021%2FPanini_Absolute_-_Base_-_Red%2F36%2FJosh_Allen%2F17779360" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "handle": "Cards/Football/2021/Panini_Absolute_-_Base_-_Red/36/Josh_Allen/17779360",
    "year": "2021",
    "set_description": "Panini Absolute - [Base] - Red",
    "card_number": "36",
    "subject": "Josh Allen",
    "image_url": "https://img.comc.com/i/Football/2021/Panini-Absolute---Base---Red/36/Josh-Allen.jpg",
    "total_listings": 2,
    "parallels": [
      {
        "name": "[Base]",
        "handle": "Cards/Football/2021/Panini_Absolute_-_Base/36/Josh_Allen/17777799",
        "price": 1.29,
        "for_sale_count": 34
      },
      {
        "name": "Orange",
        "handle": "Cards/Football/2021/Panini_Absolute_-_Base_-_Orange/36/Josh_Allen/17778525",
        "sold_out": true
      }
    ],
    "listings": [
      {
        "item_id": 156183522,
        "owner": "Severin",
        "owner_url": "https://www.comc.com/Users/Severin",
        "price": 1.04
      },
      {
        "item_id": 156183600,
        "owner": "crossroad",
        "owner_url": "https://www.comc.com/Users/crossroad",
        "price": 2.15
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/comc.listingResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	comc.ListingResponse	No
data.card_number	string	No
data.grade_label	string	No
data.handle	string	No
data.image_url	string	No
data.listings	array	No
data.listings[].item_id	integer	No
data.listings[].owner	string	No
data.listings[].owner_url	string	No
data.listings[].price	number	No
data.parallels	array	No
data.parallels[].for_sale_count	integer	No
data.parallels[].handle	string	No
data.parallels[].name	string	No
data.parallels[].price	number	No		Price is 0 and SoldOut is true when the parallel has no current listings (COMC displays "$0.00" with a "soldout" marker in that case rather than omitting the row).
data.parallels[].sold_out	boolean	No
data.set_description	string	No
data.subject	string	No
data.total_listings	integer	No
data.year	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/comc/listing?handle=Cards%2FFootball%2F2021%2FPanini_Absolute_-_Base_-_Red%2F36%2FJosh_Allen%2F17779360" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More COMC endpoint docs COMC Scraper API COMC categories API documentation COMC search API documentation

Open in Playground Back to group

Docs menu

COMC API endpoint

COMC card listing detail API

GETapiKey4 credits/requestCOMCcomc.listingResponseDoc/comc/listing

Endpoint facts

Method: GET
API path: /comc/listing
Auth: apiKey
Credits: 4 credits/request
Charged on: Successful 2xx responses only
Platform: COMC
Response schema: #/definitions/comc.listingResponseDoc

COMC Scraper API Try COMC card listing detail API in Playground COMC API documentation

How this endpoint behaves

Query parameters:

handle (required) -- the value returned by a comc-search result's own handle field, e.g. Cards/Football/2021/Panini_Absolute_-_Base_-_Red/36/Josh_Allen/17779360. Also accepts a full https://www.comc.com/... card URL.

Notable response behavior:

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.

Live monitoring

Monitored request: GET /comc/listing?handle=Cards%2FFootball%2F2021%2FPanini_Absolute_-_Base_-_Red%2F36%2FJosh_Allen%2F17779360
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 14.16 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /comc/listing?handle=Cards%2FFootball%2F2021%2FPanini_Absolute_-_Base_-_Red%2F36%2FJosh_Allen%2F17779360
Items in listings: 1
Fields filled in every checked item: 4

Field	Filled in, of 1 checked	Values in the sample
item_id	1
owner	1
owner_url	1	comc.com
price	1	3.69

Request parameters

Parameter	Type	Required	Default	Description	Example
handle	string	Yes		Required. The handle from a comc_search result (or the equivalent comc.com card URL path).	Cards/Football/2021/Panini_Absolute_-_Base_-_Red/36/Josh_Allen/17779360
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/comc/listing?handle=Cards%2FFootball%2F2021%2FPanini_Absolute_-_Base_-_Red%2F36%2FJosh_Allen%2F17779360" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "handle": "Cards/Football/2021/Panini_Absolute_-_Base_-_Red/36/Josh_Allen/17779360",
    "year": "2021",
    "set_description": "Panini Absolute - [Base] - Red",
    "card_number": "36",
    "subject": "Josh Allen",
    "image_url": "https://img.comc.com/i/Football/2021/Panini-Absolute---Base---Red/36/Josh-Allen.jpg",
    "total_listings": 2,
    "parallels": [
      {
        "name": "[Base]",
        "handle": "Cards/Football/2021/Panini_Absolute_-_Base/36/Josh_Allen/17777799",
        "price": 1.29,
        "for_sale_count": 34
      },
      {
        "name": "Orange",
        "handle": "Cards/Football/2021/Panini_Absolute_-_Base_-_Orange/36/Josh_Allen/17778525",
        "sold_out": true
      }
    ],
    "listings": [
      {
        "item_id": 156183522,
        "owner": "Severin",
        "owner_url": "https://www.comc.com/Users/Severin",
        "price": 1.04
      },
      {
        "item_id": 156183600,
        "owner": "crossroad",
        "owner_url": "https://www.comc.com/Users/crossroad",
        "price": 2.15
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/comc.listingResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	comc.ListingResponse	No
data.card_number	string	No
data.grade_label	string	No
data.handle	string	No
data.image_url	string	No
data.listings	array	No
data.listings[].item_id	integer	No
data.listings[].owner	string	No
data.listings[].owner_url	string	No
data.listings[].price	number	No
data.parallels	array	No
data.parallels[].for_sale_count	integer	No
data.parallels[].handle	string	No
data.parallels[].name	string	No
data.parallels[].price	number	No		Price is 0 and SoldOut is true when the parallel has no current listings (COMC displays "$0.00" with a "soldout" marker in that case rather than omitting the row).
data.parallels[].sold_out	boolean	No
data.set_description	string	No
data.subject	string	No
data.total_listings	integer	No
data.year	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/comc/listing?handle=Cards%2FFootball%2F2021%2FPanini_Absolute_-_Base_-_Red%2F36%2FJosh_Allen%2F17779360" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More COMC endpoint docs COMC Scraper API COMC categories API documentation COMC search API documentation

Open in Playground Back to group

COMC card listing detail API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

COMC card listing detail API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related