Alt API endpoint
Returns every accepted value for alt-search/alt-auctions/alt-sold-listings' category, auction_house, grading_company, and listing_type params, plus the sort enum. category/auction_house/grading_company/listing_type are read live from Alt's own current search index on every call, not a fixed taxonomy -- so this endpoint self-corrects if Alt's aggregator adds a new source auction house, grading company, or category.
/alt/categoriesResponse fields:
category[] — card category values.auction_house[] — source auction houses Alt's aggregator currently
carries listings from.grading_company[] — grading/authentication values.listing_type[] — AUCTION, FIXED_PRICE (Alt's own listings) and
EXTERNAL_AUCTION, EXTERNAL_FIXED_PRICE (aggregated from another
source).sort[] — alt-search/alt-auctions' accepted sort values.| Field | In the sample | Value in the sample |
|---|---|---|
| category | Has a value | 16 entries |
| auction_house | Has a value | 7 entries |
| grading_company | Has a value | 22 entries |
| listing_type | Has a value | 4 entries |
| sort | Has a value | 8 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/alt/categories" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"category": [
"BASEBALL_CARDS",
"POKEMON_CARDS",
"FOOTBALL_CARDS",
"BASKETBALL_CARDS",
"POP-CULTURE_CARDS",
"HOCKEY_CARDS",
"SOCCER_CARDS",
"ONE_PIECE_CARDS",
"OTHER_CARDS",
"TCG_CARDS",
"COMBAT_SPORTS_CARDS",
"RACING_CARDS",
"MAGIC_CARDS",
"YUGIOH_CARDS",
"GOLF_CARDS",
"TENNIS_CARDS"
],
"auction_house": [
"eBay",
"Fanatics Collect",
"Alt",
"Pristine Auction",
"Goldin",
"CardHobby",
"Memory Lane"
],
"grading_company": [
"PSA",
"CGC",
"BGS",
"CSG",
"SGC",
"PSA/DNA",
"BVG",
"BCCG",
"Factory Sealed",
"BAS",
"AUTHENTIC",
"TAG",
"RELABEL",
"RECASE",
"JSA/BVG",
"REVIEW",
"INTERNAL",
"NEW/",
"BULK",
"OTHERS",
"UNGRADED"
],
"listing_type": [
"AUCTION",
"FIXED_PRICE",
"EXTERNAL_AUCTION",
"EXTERNAL_FIXED_PRICE"
],
"sort": [
"recommended",
"alt_value_desc",
"alt_value_asc",
"price_desc",
"price_asc",
"watched_desc",
"ending_soonest_asc",
"timestamp_desc"
]
}
}Request schema
No body schema
Response schema
#/definitions/alt.categoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | alt.CategoriesResponse | No | ||||
| data.auction_house | array | No | ||||
| data.category | array | No | ||||
| data.grading_company | array | No | ||||
| data.listing_type | array | No | ||||
| data.sort | array | No | ||||
| 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/alt/categories" \
-H "x-api-key: $CRAWLORA_API_KEY"