Docs menu

Alt API endpoint

Alt listing API

One listing's full public detail -- title, description, price/bid state, grading info, and images -- across Alt's own native listings and its aggregated external listings. id and listing_type come from a prior alt-search/alt-auctions result, or from an alt-sold-listings result's listing_id and listing_type for a completed sale on Alt itself. Not every response field applies to every listing_type -- see the field-level notes in this endpoint's markdown doc.

GETapiKey1 credit/requestAltalt.listingResponseDoc/alt/listing

Endpoint facts

Method: GET
API path: /alt/listing
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Alt
Response schema: #/definitions/alt.listingResponseDoc

Alt Scraper API Try Alt listing API in Playground Alt API documentation

How this endpoint behaves

Query parameters:

id (required) — the listing's id, from a Search/Auctions result's id field, or a sold-listings result's listing_id.
listing_type (required) — the listing's listing_type from the same result. One of AUCTION, FIXED_PRICE (Alt's own listings) or EXTERNAL_AUCTION, EXTERNAL_FIXED_PRICE (aggregated from another source).

Notable response behavior:

Not every field applies to every listing_type: state and alt_value are only present for Alt's own native listings (AUCTION/ FIXED_PRICE); current_bid, bid_count, auction_ends_at, and external_url are only present for external listings (EXTERNAL_AUCTION/EXTERNAL_FIXED_PRICE).
external_url is the click-through link back to the original listing on its source site (e.g. eBay).
badges (e.g. 1/1 Rare, Pop 1) are only present for Alt's own native listings.
A listing that has already sold still resolves, with state SOLD. For a sold auction, list_price is not the sale price; the sale price is price on the matching alt-sold-listings result, which for an auction includes Alt's 20% buyer's premium.
cert_number and qualifier (the grading company's qualifier, when the item has one) are returned for Alt's own native listings. Search results do not carry a certificate number, so this endpoint is the way to get it.
There is no language field. Alt records a card's language as part of the set name in brand (for example Pokemon Base Set Japanese); a brand with no language word is not by itself proof of an English printing. For a PSA-graded item, pass cert_number to psa-cert-lookup to read PSA's own label.
An id/listing_type combination Alt cannot resolve returns 404.

Example response (native Alt listing):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "58e5a6a5-a7ad-417f-8cda-ceffb226928c",
    "listing_type": "AUCTION",
    "auction_house": "Alt",
    "name": "2007 Exquisite Collection Dual Logoman Autographs Kobe Bryant/Lebron James #DL-BJ 1/1 PSA 8",
    "subject": "Kobe Bryant/Lebron James",
    "year": 2007,
    "brand": "Exquisite Collection",
    "variety": "Dual Logoman Autographs",
    "card_number": "DL-BJ",
    "category": "BASKETBALL_CARDS",
    "description": "The 2007-08 Upper Deck Exquisite Collection Dual Logoman Autographs #DL-BJ pairs Kobe Bryant and LeBron James on a singular 1/1 issue.",
    "grading_company": "PSA",
    "grade": "8.0",
    "cert_number": "175673254",
    "state": "ACTIVE",
    "list_price": 1772280,
    "alt_value": 8460808.16,
    "expires_at": "2026-09-25T01:00:00+00:00",
    "badges": ["1/1 Rare", "Ghost Card", "Pop 1"],
    "images": [
      {"position": "FRONT", "url": "https://onlyalt-images.s3.us-east-2.amazonaws.com/image/public/front.png"},
      {"position": "BACK", "url": "https://onlyalt-images.s3.us-east-2.amazonaws.com/image/public/back.png"}
    ]
  }
}

Live monitoring

Monitored request: GET /alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.15 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION
Fields returned with a value: 22

Field	In the sample	Value in the sample
id	Has a value
listing_type	Has a value	“AUCTION”
auction_house	Has a value	“Alt”
name	Has a value	“2007 Exquisite Collection Dual Logoman Autographs Kobe Brya…”
subject	Has a value	“Kobe Bryant/Lebron James”
year	Has a value	2,007
brand	Has a value	“Exquisite Collection”
variety	Has a value	“Dual Logoman Autographs”
card_number	Has a value	“DL-BJ”
category	Has a value	“BASKETBALL_CARDS”
description	Has a value	1,052 characters
grading_company	Has a value	“PSA”
grade	Has a value	8
serial	Has a value	1
cert_number	Has a value	175,673,254
state	Has a value	“SOLD”
list_price	Has a value	1,772,280
alt_value	Has a value	6,609,050.21
expires_at	Has a value	2026-09-25
created_at	Has a value	2026-09-02
badges	Has a value	2 entries
images	Has a value	2 entries

Request parameters

Parameter	Type	Required	Description	Example
id	string	Yes	The listing's id, from a Search/Auctions result's id field, or a sold-listings result's listing_id for a completed sale on Alt itself	58e5a6a5-a7ad-417f-8cda-ceffb226928c
listing_type	string	Yes	The listing's listing_type from the same Search/Auctions result Allowed values: AUCTION, FIXED_PRICE, EXTERNAL_AUCTION, EXTERNAL_FIXED_PRICE.	AUCTION
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "58e5a6a5-a7ad-417f-8cda-ceffb226928c",
    "listing_type": "AUCTION",
    "auction_house": "Alt",
    "name": "2007 Exquisite Collection Dual Logoman Autographs Kobe Bryant/Lebron James #DL-BJ 1/1 PSA 8",
    "subject": "Kobe Bryant/Lebron James",
    "year": 2007,
    "brand": "Exquisite Collection",
    "variety": "Dual Logoman Autographs",
    "card_number": "DL-BJ",
    "category": "BASKETBALL_CARDS",
    "description": "The 2007-08 Upper Deck Exquisite Collection Dual Logoman Autographs #DL-BJ pairs Kobe Bryant and LeBron James on a singular 1/1 issue.",
    "grading_company": "PSA",
    "grade": "8.0",
    "cert_number": "175673254",
    "state": "ACTIVE",
    "list_price": 1772280,
    "alt_value": 8460808.16,
    "expires_at": "2026-09-25T01:00:00+00:00",
    "badges": [
      "1/1 Rare",
      "Ghost Card",
      "Pop 1"
    ],
    "images": [
      {
        "position": "FRONT",
        "url": "https://onlyalt-images.s3.us-east-2.amazonaws.com/image/public/front.png"
      },
      {
        "position": "BACK",
        "url": "https://onlyalt-images.s3.us-east-2.amazonaws.com/image/public/back.png"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/alt.listingResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	alt.ListingResult	No
data.alt_value	number	No		AltValue is Alt's own estimated market value, only present for native listings.
data.auction_ends_at	string	No
data.auction_house	string	No
data.autograph	string	No
data.badges	array	No
data.bid_count	integer	No
data.brand	string	No
data.card_number	string	No
data.category	string	No
data.cert_number	string	No
data.created_at	string	No
data.current_bid	number	No		CurrentBid and BidCount are only present for external auction listings -- Alt's own native auctions do not expose live bid state through this endpoint.
data.description	string	No
data.expires_at	string	No		ExpiresAt is only present for native listings; AuctionEndsAt is only present for external auction listings.
data.external_url	string	No		ExternalURL is the click-through link back to the original listing on its source site -- only present for external listings.
data.grade	string	No
data.grading_company	string	No
data.id	string	No
data.images	array	No
data.images[].position	string	No
data.images[].url	string	No
data.list_price	number	No		ListPrice is Alt's own asking/list price (native) or the source site's Buy It Now price (external, when the listing has one).
data.listing_type	string	No
data.name	string	No
data.print_run	integer	No
data.qualifier	string	No
data.serial	integer	No
data.state	string	No		State is only present for Alt's own native listings (e.g. ACTIVE).
data.subject	string	No
data.variety	string	No
data.year	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Alt endpoint docs Alt Scraper API Alt asset API documentation Alt auctions API documentation Alt card search API documentation Alt categories API documentation Alt market trends API documentation Alt search API documentation

Open in Playground Back to group

Docs menu

Alt API endpoint

Alt listing API

GETapiKey1 credit/requestAltalt.listingResponseDoc/alt/listing

Endpoint facts

Method: GET
API path: /alt/listing
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Alt
Response schema: #/definitions/alt.listingResponseDoc

Alt Scraper API Try Alt listing API in Playground Alt API documentation

How this endpoint behaves

Query parameters:

id (required) — the listing's id, from a Search/Auctions result's id field, or a sold-listings result's listing_id.
listing_type (required) — the listing's listing_type from the same result. One of AUCTION, FIXED_PRICE (Alt's own listings) or EXTERNAL_AUCTION, EXTERNAL_FIXED_PRICE (aggregated from another source).

Notable response behavior:

Not every field applies to every listing_type: state and alt_value are only present for Alt's own native listings (AUCTION/ FIXED_PRICE); current_bid, bid_count, auction_ends_at, and external_url are only present for external listings (EXTERNAL_AUCTION/EXTERNAL_FIXED_PRICE).
external_url is the click-through link back to the original listing on its source site (e.g. eBay).
badges (e.g. 1/1 Rare, Pop 1) are only present for Alt's own native listings.
A listing that has already sold still resolves, with state SOLD. For a sold auction, list_price is not the sale price; the sale price is price on the matching alt-sold-listings result, which for an auction includes Alt's 20% buyer's premium.
cert_number and qualifier (the grading company's qualifier, when the item has one) are returned for Alt's own native listings. Search results do not carry a certificate number, so this endpoint is the way to get it.
There is no language field. Alt records a card's language as part of the set name in brand (for example Pokemon Base Set Japanese); a brand with no language word is not by itself proof of an English printing. For a PSA-graded item, pass cert_number to psa-cert-lookup to read PSA's own label.
An id/listing_type combination Alt cannot resolve returns 404.

Example response (native Alt listing):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "58e5a6a5-a7ad-417f-8cda-ceffb226928c",
    "listing_type": "AUCTION",
    "auction_house": "Alt",
    "name": "2007 Exquisite Collection Dual Logoman Autographs Kobe Bryant/Lebron James #DL-BJ 1/1 PSA 8",
    "subject": "Kobe Bryant/Lebron James",
    "year": 2007,
    "brand": "Exquisite Collection",
    "variety": "Dual Logoman Autographs",
    "card_number": "DL-BJ",
    "category": "BASKETBALL_CARDS",
    "description": "The 2007-08 Upper Deck Exquisite Collection Dual Logoman Autographs #DL-BJ pairs Kobe Bryant and LeBron James on a singular 1/1 issue.",
    "grading_company": "PSA",
    "grade": "8.0",
    "cert_number": "175673254",
    "state": "ACTIVE",
    "list_price": 1772280,
    "alt_value": 8460808.16,
    "expires_at": "2026-09-25T01:00:00+00:00",
    "badges": ["1/1 Rare", "Ghost Card", "Pop 1"],
    "images": [
      {"position": "FRONT", "url": "https://onlyalt-images.s3.us-east-2.amazonaws.com/image/public/front.png"},
      {"position": "BACK", "url": "https://onlyalt-images.s3.us-east-2.amazonaws.com/image/public/back.png"}
    ]
  }
}

Live monitoring

Monitored request: GET /alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.15 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION
Fields returned with a value: 22

Field	In the sample	Value in the sample
id	Has a value
listing_type	Has a value	“AUCTION”
auction_house	Has a value	“Alt”
name	Has a value	“2007 Exquisite Collection Dual Logoman Autographs Kobe Brya…”
subject	Has a value	“Kobe Bryant/Lebron James”
year	Has a value	2,007
brand	Has a value	“Exquisite Collection”
variety	Has a value	“Dual Logoman Autographs”
card_number	Has a value	“DL-BJ”
category	Has a value	“BASKETBALL_CARDS”
description	Has a value	1,052 characters
grading_company	Has a value	“PSA”
grade	Has a value	8
serial	Has a value	1
cert_number	Has a value	175,673,254
state	Has a value	“SOLD”
list_price	Has a value	1,772,280
alt_value	Has a value	6,609,050.21
expires_at	Has a value	2026-09-25
created_at	Has a value	2026-09-02
badges	Has a value	2 entries
images	Has a value	2 entries

Request parameters

Parameter	Type	Required	Description	Example
id	string	Yes	The listing's id, from a Search/Auctions result's id field, or a sold-listings result's listing_id for a completed sale on Alt itself	58e5a6a5-a7ad-417f-8cda-ceffb226928c
listing_type	string	Yes	The listing's listing_type from the same Search/Auctions result Allowed values: AUCTION, FIXED_PRICE, EXTERNAL_AUCTION, EXTERNAL_FIXED_PRICE.	AUCTION
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "58e5a6a5-a7ad-417f-8cda-ceffb226928c",
    "listing_type": "AUCTION",
    "auction_house": "Alt",
    "name": "2007 Exquisite Collection Dual Logoman Autographs Kobe Bryant/Lebron James #DL-BJ 1/1 PSA 8",
    "subject": "Kobe Bryant/Lebron James",
    "year": 2007,
    "brand": "Exquisite Collection",
    "variety": "Dual Logoman Autographs",
    "card_number": "DL-BJ",
    "category": "BASKETBALL_CARDS",
    "description": "The 2007-08 Upper Deck Exquisite Collection Dual Logoman Autographs #DL-BJ pairs Kobe Bryant and LeBron James on a singular 1/1 issue.",
    "grading_company": "PSA",
    "grade": "8.0",
    "cert_number": "175673254",
    "state": "ACTIVE",
    "list_price": 1772280,
    "alt_value": 8460808.16,
    "expires_at": "2026-09-25T01:00:00+00:00",
    "badges": [
      "1/1 Rare",
      "Ghost Card",
      "Pop 1"
    ],
    "images": [
      {
        "position": "FRONT",
        "url": "https://onlyalt-images.s3.us-east-2.amazonaws.com/image/public/front.png"
      },
      {
        "position": "BACK",
        "url": "https://onlyalt-images.s3.us-east-2.amazonaws.com/image/public/back.png"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/alt.listingResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	alt.ListingResult	No
data.alt_value	number	No		AltValue is Alt's own estimated market value, only present for native listings.
data.auction_ends_at	string	No
data.auction_house	string	No
data.autograph	string	No
data.badges	array	No
data.bid_count	integer	No
data.brand	string	No
data.card_number	string	No
data.category	string	No
data.cert_number	string	No
data.created_at	string	No
data.current_bid	number	No		CurrentBid and BidCount are only present for external auction listings -- Alt's own native auctions do not expose live bid state through this endpoint.
data.description	string	No
data.expires_at	string	No		ExpiresAt is only present for native listings; AuctionEndsAt is only present for external auction listings.
data.external_url	string	No		ExternalURL is the click-through link back to the original listing on its source site -- only present for external listings.
data.grade	string	No
data.grading_company	string	No
data.id	string	No
data.images	array	No
data.images[].position	string	No
data.images[].url	string	No
data.list_price	number	No		ListPrice is Alt's own asking/list price (native) or the source site's Buy It Now price (external, when the listing has one).
data.listing_type	string	No
data.name	string	No
data.print_run	integer	No
data.qualifier	string	No
data.serial	integer	No
data.state	string	No		State is only present for Alt's own native listings (e.g. ACTIVE).
data.subject	string	No
data.variety	string	No
data.year	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Alt listing API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Alt listing API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related