Fanatics Collect API endpoint
Returns Fanatics Collect's current and recent weekly and premier auction events -- the same short list the site's own header auction switcher and countdown banner show. This is the discovery endpoint for Search's auction_urn param: copy an event's urn value to browse every lot in that auction. A small, current/recent set (observed live: around 6 events), not a full historical archive -- older auctions' urn values found on a Search result or a GetListing response remain valid for Search even once they no longer appear here.
/fanaticscollect/auctionsThis is a small, current/recent set (observed live: around 6 events spanning CLOSED/LIVE/PREVIEW status), not a full historical archive of every auction the site has ever run. An older auction's own auction_urn value -- found on a Search result or a Fanatics Collect Listing response's auction field -- remains valid for Search even once that auction no longer appears here.
Response fields:
auctions[] — each entry: {id, urn, marketplace, type, integer_id, auction_integer_id, name, short_name, payout_date, starts_at, ends_at, status, timer}.
urn — the exact value to pass as Search's auction_urn param, e.g. WEEKLY:61de75bc-0e4b-11f1-80c8-0a58a9feac02.marketplace — WEEKLY or PREMIER.type — the auction type, CollectWeeklyAuction or CollectPremierAuction.status — e.g. CLOSED, LIVE, PREVIEW.timer — {auction_starts_at, auction_ends_at, window_ends_at, window_ordinal, window_duration_seconds}, describing the live bidding window.| Field | Filled in, of 5 checked | Values in the sample |
|---|---|---|
| id | 5 | |
| urn | 5 | “WEEKLY:25bf98da-21e8-11f1-894c-0a58a9feac02” and 4 other values |
| marketplace | 5 | WEEKLY (4), PREMIER (1) |
| type | 5 | CollectWeeklyAuction (4), CollectPremierAuction (1) |
| integer_id | 5 | |
| auction_integer_id | 4 | |
| name | 5 | “Weekly Auction #245” and 4 other values |
| short_name | 5 | “WA245” and 4 other values |
| starts_at | 5 | 2026-09-18 to 2026-10-09 |
| ends_at | 5 | 2026-09-28 to 2026-10-23 |
| status | 5 | CLOSED (3), LIVE (2) |
| timer | 5 | |
| payout_date | 1 | 2026-11-04 |
| 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/auctions" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"auctions": [
{
"id": "61de75bc-0e4b-11f1-80c8-0a58a9feac02",
"urn": "WEEKLY:61de75bc-0e4b-11f1-80c8-0a58a9feac02",
"marketplace": "WEEKLY",
"type": "CollectWeeklyAuction",
"integer_id": 421,
"auction_integer_id": 277,
"name": "Weekly Auction #241",
"short_name": "WA241",
"starts_at": "2026-08-21T02:00:00Z",
"ends_at": "2026-08-31T02:00:00Z",
"status": "CLOSED",
"timer": {
"auction_starts_at": "2026-08-21T02:00:00Z",
"auction_ends_at": "2026-08-31T02:00:00Z",
"window_ends_at": "2026-09-16T05:16:00Z",
"window_ordinal": 23183,
"window_duration_seconds": 60
}
},
{
"id": "cf65e70a-3a6a-11f1-bbf0-0a58a9feac02",
"urn": "PREMIER:cf65e70a-3a6a-11f1-bbf0-0a58a9feac02",
"marketplace": "PREMIER",
"type": "CollectPremierAuction",
"integer_id": 86,
"name": "September Premier Auction",
"short_name": "September",
"payout_date": "2026-10-07",
"starts_at": "2026-09-10T23:00:00Z",
"ends_at": "2026-09-25T01:00:00Z",
"status": "LIVE"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/fanaticscollect.auctionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fanaticscollect.AuctionsResponse | No | ||||
| data.auctions | array | No | Auction record, 18 fields: auction_integer_id, ends_at, id, integer_id, marketplace, name, payout_date, short_name, starts_at, status, timer, type and 1 more. Described under Fanatics Collect Listing API. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/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/auctions" \
-H "x-api-key: $CRAWLORA_API_KEY"