---
title: "Get COMC card listing detail"
method: GET
path: "/comc/listing"
tags: ["COMC"]
---

# Get COMC card listing detail

`GET /comc/listing`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/comc/listing`
- Auth: API key in header `x-api-key`

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

## Query parameters

- `handle` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ComcListingResponseDoc
  - `code` integer
  - `data` ComcListingResponse
    - `card_number` string
    - `grade_label` string
    - `handle` string
    - `image_url` string
    - `listings` ComcListingItem[]
      - `item_id` integer
      - `owner` string
      - `owner_url` string
      - `price` number
    - `parallels` ComcParallel[]
      - `for_sale_count` integer
      - `handle` string
      - `name` string
      - `price` number: 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).
      - `sold_out` boolean
    - `set_description` string
    - `subject` string
    - `total_listings` integer
    - `year` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)