Fanatics Collect API endpoint
Returns full detail for a single Fanatics Collect listing: a weekly-auction lot, a premier-auction lot, or a fixed-price "buy now" item (including an Instant Rips pack). Fields include title, current bid/starting/asking price, bid count, auction window and status, images, description, completed sale history, and -- when the card is stored in Fanatics' vault -- grading/authentication metadata including a direct PSA cert-verification link. Costs 1 credit per successful call.
/fanaticscollect/listing/{id}Returns full detail for a single Fanatics Collect listing: a weekly-auction lot, a premier-auction lot, or a fixed-price "buy now" item. This also covers Instant Rips (fanaticscollect.com/instant-rips) pack products -- each pack tier shown there (e.g. "Football Super") is itself a FIXED listing under the hood, reachable with the same id and type=FIXED. Fields include title, current bid/starting/asking price, bid count, auction window and status, images, description, completed sale history, and -- when the card is stored in Fanatics' vault -- grading/authentication metadata including a direct PSA cert-verification link.
Path parameters:
id (required) — Fanatics Collect listing UUID, e.g. 1e389d12-6f23-11ed-9d8b-0a58a9feac02.Query parameters:
type (optional) — listing type. Default: WEEKLY. One of: WEEKLY, PREMIER, FIXED.Response fields:
id, integer_id, title, subtitle, slug, url — the public listing page URL.listing_type — WEEKLY, PREMIER, or FIXED.lot_string — human-readable lot label, e.g. WA1 Lot: 1417. Empty for FIXED listings.certified_seller, status, is_closed, is_flash, is_fanatics_authentic.marketplace_eye_appeal, description, default_item_description.starting_price, current_bid, sold_for, sold_date — starting_price/current_bid/sold_for are {amount, currency} objects; absent when not applicable. Populated for WEEKLY/PREMIER auction lots.asking_price — the buy-now price, an {amount, currency} object. Populated only for FIXED listings.bid_count, favorited_count.auction — the weekly or premier auction event this listing belongs to: {id, urn, marketplace, type, integer_id, auction_integer_id, name, short_name, payout_date, starts_at, ends_at, status, timer}. urn is the exact value to pass as Search's auction_urn param to browse every lot in this auction (e.g. WEEKLY:8d27de96-6f1d-11ed-ab20-0a58a9feac02); marketplace is WEEKLY or PREMIER. timer ({auction_starts_at, auction_ends_at, window_ends_at, window_ordinal, window_duration_seconds}) describes the live bidding window.images[] — {large, medium, small, thumbnail} URL sets.sale_history[] — completed sales of this exact listing: {sold_date, sold_for}.vault_item — present when the item is stored in Fanatics' own vault: {id, integer_id, safe_market_value, suggested_asking_price, similar_item_transactions, grading_service_url, origin_type, origin_label, video_url}. grading_service_url links directly to the grading service's public cert-verification page (e.g. PSA) when the card is professionally graded.card_ladder — a third-party "Card Ladder" guide-price estimate, present only when Card Ladder has comp data for this exact item: {estimated_value, estimated_min, estimated_max} (each an {amount, currency} object).inserted_at, updated_at.Returns 404 when the listing id does not exist for the given type.
| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| sold_date | 1 | 2022-01-24 |
| sold_for | 1 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Listing UUID | 1e389d12-6f23-11ed-9d8b-0a58a9feac02 | |
| type | string | No | Listing type. Default: WEEKLY Allowed values: WEEKLY, PREMIER, FIXED. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fanaticscollect/listing/1e389d12-6f23-11ed-9d8b-0a58a9feac02?type=WEEKLY" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "1e389d12-6f23-11ed-9d8b-0a58a9feac02",
"integer_id": 3093496,
"title": "1963 Fleer Football Keith Lincoln #70 PSA 6 EXMT",
"url": "https://www.fanaticscollect.com/weekly/1e389d12-6f23-11ed-9d8b-0a58a9feac02",
"listing_type": "WEEKLY",
"lot_string": "WA1 Lot: 1417",
"certified_seller": "Fanatics Collect",
"status": "STATUS_SOLD",
"is_closed": true,
"description": "Welcome to our first Weekly Sunday Auction!",
"current_bid": {
"amount": 11,
"currency": "USD"
},
"starting_price": {
"amount": 5,
"currency": "USD"
},
"bid_count": 2,
"favorited_count": 0,
"auction": {
"id": "8d27de96-6f1d-11ed-ab20-0a58a9feac02",
"type": "CollectWeeklyAuction",
"integer_id": 172,
"auction_integer_id": 30,
"name": "2022 Weekly Auction #1",
"short_name": "WA1",
"payout_date": "2022-02-16",
"starts_at": "2022-01-14T03:00:00Z",
"ends_at": "2022-01-24T03:00:00Z",
"status": "CLOSED"
},
"images": [
{
"large": "https://img/large.jpg",
"medium": "https://img/medium.jpg",
"small": "https://img/small.jpg",
"thumbnail": "https://img/thumb.jpg"
}
],
"sale_history": [
{
"sold_date": "2022-01-24T04:10:05Z",
"sold_for": {
"amount": 13.2,
"currency": "USD"
}
}
],
"vault_item": {
"id": "20e2198e-6f1f-11ed-a798-0a58a9feac02",
"integer_id": 1049411,
"safe_market_value": {
"amount": 28,
"currency": "USD"
},
"suggested_asking_price": {
"amount": 28,
"currency": "USD"
},
"grading_service_url": "https://www.psacard.com/cert/43185259/psa",
"origin_type": "VAULT_SUBMISSION",
"origin_label": "Vault Submission"
},
"inserted_at": "2021-12-22T03:43:54Z",
"updated_at": "2023-01-09T18:38:27Z"
}
}Request schema
No body schema
Response schema
#/definitions/fanaticscollect.listingResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | fanaticscollect.Listing | No | ||||
| data.asking_price | object | No | AskingPrice is set only for FIXED listings (the "buy now" price); WEEKLY/PREMIER auction lots price through StartingPrice/CurrentBid/ SoldFor instead. | |||
| data.asking_price.amount | number | No | 13.2 | |||
| data.asking_price.currency | string | No | USD | |||
| data.auction | fanaticscollect.Auction | No | ||||
| data.auction.auction_integer_id | integer | No | ||||
| data.auction.ends_at | string | No | ||||
| data.auction.id | string | No | ||||
| data.auction.integer_id | integer | No | ||||
| data.auction.marketplace | string | No | WEEKLY | |||
| data.auction.name | string | No | 2022 Weekly Auction #1 | |||
| data.auction.payout_date | string | No | ||||
| data.auction.short_name | string | No | WA1 | |||
| data.auction.starts_at | string | No | ||||
| data.auction.status | string | No | CLOSED | |||
| data.auction.timer | fanaticscollect.AuctionTimer | No | ||||
| data.auction.timer.auction_ends_at | string | No | 2022-01-24T03:00:00Z | |||
| data.auction.timer.auction_starts_at | string | No | 2022-01-14T03:00:00Z | |||
| data.auction.timer.window_duration_seconds | integer | No | ||||
| data.auction.timer.window_ends_at | string | No | ||||
| data.auction.timer.window_ordinal | integer | No | ||||
| data.auction.type | string | No | CollectWeeklyAuction | |||
| data.auction.urn | string | No | WEEKLY:8d27de96-6f1d-11ed-ab20-0a58a9feac02 | |||
| data.bid_count | integer | No | ||||
| data.card_ladder | fanaticscollect.CardLadderEstimate | No | ||||
| data.card_ladder.estimated_max | fanaticscollect.Money | No | ||||
| data.card_ladder.estimated_max.amount | number | No | 13.2 | |||
| data.card_ladder.estimated_max.currency | string | No | USD | |||
| data.card_ladder.estimated_min | fanaticscollect.Money | No | ||||
| data.card_ladder.estimated_min.amount | number | No | 13.2 | |||
| data.card_ladder.estimated_min.currency | string | No | USD | |||
| data.card_ladder.estimated_value | fanaticscollect.Money | No | ||||
| data.card_ladder.estimated_value.amount | number | No | 13.2 | |||
| data.card_ladder.estimated_value.currency | string | No | USD | |||
| data.certified_seller | string | No | Fanatics Collect | |||
| data.current_bid | fanaticscollect.Money | No | ||||
| data.current_bid.amount | number | No | 13.2 | |||
| data.current_bid.currency | string | No | USD | |||
| data.default_item_description | string | No | ||||
| data.description | string | No | ||||
| data.favorited_count | integer | No | ||||
| data.id | string | No | ||||
| data.images | array | No | ||||
| data.images[].large | string | No | ||||
| data.images[].medium | string | No | ||||
| data.images[].small | string | No | ||||
| data.images[].thumbnail | string | No | ||||
| data.inserted_at | string | No | ||||
| data.integer_id | integer | No | ||||
| data.is_closed | boolean | No | ||||
| data.is_fanatics_authentic | boolean | No | ||||
| data.is_flash | boolean | No | ||||
| data.listing_type | string | No | WEEKLY | |||
| data.lot_string | string | No | WA1 Lot: 1417 | |||
| data.marketplace_eye_appeal | string | No | ||||
| data.sale_history | array | No | ||||
| data.sale_history[].sold_date | string | No | ||||
| data.sale_history[].sold_for | fanaticscollect.Money | No | ||||
| data.sale_history[].sold_for.amount | number | No | 13.2 | |||
| data.sale_history[].sold_for.currency | string | No | USD | |||
| data.slug | string | No | ||||
| data.sold_date | string | No | ||||
| data.sold_for | fanaticscollect.Money | No | ||||
| data.sold_for.amount | number | No | 13.2 | |||
| data.sold_for.currency | string | No | USD | |||
| data.starting_price | fanaticscollect.Money | No | ||||
| data.starting_price.amount | number | No | 13.2 | |||
| data.starting_price.currency | string | No | USD | |||
| data.status | string | No | STATUS_SOLD | |||
| data.subtitle | string | No | ||||
| data.title | string | No | ||||
| data.updated_at | string | No | ||||
| data.url | string | No | ||||
| data.vault_item | fanaticscollect.VaultItem | No | ||||
| data.vault_item.grading_service_url | string | No | https://www.psacard.com/cert/43185259/psa | |||
| data.vault_item.id | string | No | ||||
| data.vault_item.integer_id | integer | No | ||||
| data.vault_item.origin_label | string | No | ||||
| data.vault_item.origin_type | string | No | ||||
| data.vault_item.safe_market_value | fanaticscollect.Money | No | ||||
| data.vault_item.safe_market_value.amount | number | No | 13.2 | |||
| data.vault_item.safe_market_value.currency | string | No | USD | |||
| data.vault_item.similar_item_transactions | array | No | ||||
| data.vault_item.similar_item_transactions[].sold_date | string | No | ||||
| data.vault_item.similar_item_transactions[].sold_for | fanaticscollect.Money | No | ||||
| data.vault_item.similar_item_transactions[].sold_for.amount | number | No | 13.2 | |||
| data.vault_item.similar_item_transactions[].sold_for.currency | string | No | USD | |||
| data.vault_item.suggested_asking_price | fanaticscollect.Money | No | ||||
| data.vault_item.suggested_asking_price.amount | number | No | 13.2 | |||
| data.vault_item.suggested_asking_price.currency | string | No | USD | |||
| data.vault_item.video_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Missing or invalid path/query parameters | #/definitions/app.Response |
| 404 | Listing not found | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
| 503 | Fanatics Collect upstream request failed | #/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/listing/1e389d12-6f23-11ed-9d8b-0a58a9feac02?type=WEEKLY" \
-H "x-api-key: $CRAWLORA_API_KEY"