COMC API endpoint
Returns COMC's (comc.com) closed, top-level category/sport taxonomy -- the discovery endpoint for the search endpoint's `category` param. Every slug is the exact path segment comc.com's own site uses.
/comc/categoriesThis endpoint takes no query parameters.
Notable response behavior:
kind groups the taxonomy the way COMC's own nav does. Allowed values:
sports, trading, gaming, comics.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.| Field | Filled in, of 23 checked | Values in the sample |
|---|---|---|
| slug | 23 | |
| name | 23 | “Baseball Cards” and 22 other values |
| kind | 23 | sports (13), trading (5), gaming (4) and 1 more |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/comc/categories" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"categories": [
{
"slug": "Baseball",
"name": "Baseball Cards",
"kind": "sports"
},
{
"slug": "Football",
"name": "Football Cards",
"kind": "sports"
},
{
"slug": "Non-Sports",
"name": "Non-Sports Cards",
"kind": "trading"
},
{
"slug": "Star Wars",
"name": "Star Wars Cards",
"kind": "trading"
},
{
"slug": "Magic",
"name": "Magic: the Gathering",
"kind": "gaming"
},
{
"slug": "Comics",
"name": "Comic Books",
"kind": "comics"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/comc.categoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | comc.CategoriesResponse | No | ||||
| data.categories | array | No | ||||
| data.categories[].kind | string | No | sports | Kind groups the taxonomy the same way COMC's own nav does: sports, trading, gaming, or comics. | ||
| data.categories[].name | string | No | Baseball Cards | |||
| data.categories[].slug | string | No | Baseball | Slug is the exact path segment COMC's own site uses, e.g. "Baseball", "Non-Sports", "Star Wars" (a literal space, not a dash -- COMC's own URL encodes it as %20). | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/comc/categories" \
-H "x-api-key: $CRAWLORA_API_KEY"