Fanatics Collect API endpoint
Returns every accepted value for GetListing's marketplace param -- WEEKLY, PREMIER, FIXED -- and for Search's marketplace, category_parent, sub_category, grading_service, status, and sort params. Discovery endpoint for those closed enums.
/fanaticscollect/categoriesReturns every accepted value for Fanatics Collect Listing's type param -- WEEKLY, PREMIER -- for Fanatics Collect Search's marketplace, category_parent, sub_category, grading_service, status, and sort params, and for Fanatics Collect Sold Items's category, grading_service, eye_appeal_grade, and sort params. Discovery endpoint for those closed enums; no parameters.
Response fields:
marketplaces[] — WEEKLY, PREMIER, FIXED.category_parents[] — the 5 top-level categories: Sports Cards, Trading Card Games, Other, Video Games, Comics.sub_categories[] — all 35 {category_parent, name, path} pairs, e.g. {"category_parent":"Sports Cards","name":"Baseball","path":"Sports Cards > Baseball"}. path (or just name) is what Search's sub_category param accepts.grading_services[] — the 21 accepted Search.grading_service values, including Ungraded for raw/unslabbed items.statuses[] — LIVE, SOLD, ALL.sort_options[] — {value, display_name} pairs, e.g. {"value":"best_value","display_name":"Best Value"}. value is what Search's sort param accepts.sold_item_categories[] — the 23 accepted Sold Items.category values: Trading Cards, Baseball, Basketball, Football, Hockey, Golf, Boxing & MMA, Soccer, Tennis, Racing, Misc Sports, Non-Sport, Yu-Gi-Oh!, Magic The Gathering, Pokémon, Collectible Card Games, Miscellaneous, Memorabilia, Photos, Comics, Tickets, Coins, Video Games. A separate, more granular taxonomy than category_parents/sub_categories -- Search and Sold Items are different products with different category vocabularies.sold_item_grading_services[] — the 8 accepted Sold Items.grading_service values: PSA, SGC, BGS, BVG, BCCG, CGC, CSG, ungraded.eye_appeal_grades[] — the 3 accepted Sold Items.eye_appeal_grade values: Eye Appeal - A, Eye Appeal - E, Eye Appeal - S.sold_item_sort_options[] — {value, display_name} pairs for Sold Items.sort: sold_date_desc (Most Recently Sold), highest_price (Highest Price), lowest_price (Lowest Price).| Field | Filled in, of 35 checked | Values in the sample |
|---|---|---|
| category_parent | 35 | Sports Cards (10), Trading Card Games (7), Video Games (7) and 2 more |
| name | 35 | “Baseball” and 33 other values |
| path | 35 | “Sports Cards > Baseball” and 34 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fanaticscollect/categories" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"marketplaces": [
"WEEKLY",
"PREMIER",
"FIXED"
],
"category_parents": [
"Sports Cards",
"Trading Card Games",
"Other",
"Video Games",
"Comics"
],
"sub_categories": [
{
"category_parent": "Sports Cards",
"name": "Baseball",
"path": "Sports Cards > Baseball"
},
{
"category_parent": "Trading Card Games",
"name": "Pokémon (English)",
"path": "Trading Card Games > Pokémon (English)"
}
],
"grading_services": [
"Ungraded",
"CGC",
"PSA",
"BGS",
"SGC"
],
"statuses": [
"LIVE",
"SOLD",
"ALL"
],
"sort_options": [
{
"value": "best_value",
"display_name": "Best Value"
},
{
"value": "lowest_price",
"display_name": "Lowest Price"
}
],
"sold_item_categories": [
"Trading Cards",
"Baseball",
"Basketball"
],
"sold_item_grading_services": [
"PSA",
"SGC",
"BGS",
"BVG",
"BCCG",
"CGC",
"CSG",
"ungraded"
],
"eye_appeal_grades": [
"Eye Appeal - A",
"Eye Appeal - E",
"Eye Appeal - S"
],
"sold_item_sort_options": [
{
"value": "sold_date_desc",
"display_name": "Most Recently Sold"
},
{
"value": "highest_price",
"display_name": "Highest Price"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/fanaticscollect.categoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fanaticscollect.Categories | No | ||||
| data.category_parents | array | No | ||||
| data.eye_appeal_grades | array | No | ||||
| data.grading_services | array | No | ||||
| data.marketplaces | array | No | ||||
| data.sold_item_categories | array | No | ||||
| data.sold_item_grading_services | array | No | ||||
| data.sold_item_sort_options | array | No | ||||
| data.sold_item_sort_options[].display_name | string | No | Best Value | |||
| data.sold_item_sort_options[].value | string | No | best_value | |||
| data.sort_options | array | No | ||||
| data.sort_options[].display_name | string | No | Best Value | |||
| data.sort_options[].value | string | No | best_value | |||
| data.statuses | array | No | ||||
| data.sub_categories | array | No | ||||
| data.sub_categories[].category_parent | string | No | Sports Cards | |||
| data.sub_categories[].name | string | No | Baseball | |||
| data.sub_categories[].path | string | No | Sports Cards > Baseball | |||
| 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/fanaticscollect/categories" \
-H "x-api-key: $CRAWLORA_API_KEY"