Endpoint Playground

Try the 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.

What a live request returned

14 Oct 2026: Single record response; 22 fields had a value in every checked item.

Observed request: GET /alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION
Fields with a value in every checked item: id, listing_type, auction_house, name, subject, year, brand, variety

Sample value profiles: expires_at: 2026-09-25; year: 2,007; listing_type: “AUCTION”.

Request: GET /alt/listing
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.15 s
Monitored request: GET /alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION

Alt listing API documentation Alt platform page Pricing

Prefilled cURL

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

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	Yes	58e5a6a5-a7ad-417f-8cda-ceffb226928c	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
listing_type	string	Yes	AUCTION	The listing's listing_type from the same Search/Auctions result

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"
      }
    ]
  }
}

More Alt endpoints

Get one card design's population report and recent sales Search Alt's own live 24/7 auctions Search Alt's reference card-design catalog List Alt search filter values Get Alt's card-market price-trend index Search Alt's aggregated card marketplace Search Alt's completed sales archive Get Alt's biggest card-market price movers

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestalt.listingResponseDocAlt

GET /alt/listing

Get one Alt listing's full public detail

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): ```json { "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"} ] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

requiredstring

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 itselflisting_type

requiredstring

The listing's listing_type from the same Search/Auctions result · allowed: AUCTION, FIXED_PRICE, EXTERNAL_AUCTION, EXTERNAL_FIXED_PRICE

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "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"
      }
    ]
  }
}

Try the Alt listing API

What a live request returned

14 Oct 2026: Single record response; 22 fields had a value in every checked item.

Observed request: GET /alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION
Fields with a value in every checked item: id, listing_type, auction_house, name, subject, year, brand, variety

Sample value profiles: expires_at: 2026-09-25; year: 2,007; listing_type: “AUCTION”.

Request: GET /alt/listing
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.15 s
Monitored request: GET /alt/listing?id=58e5a6a5-a7ad-417f-8cda-ceffb226928c&listing_type=AUCTION

Alt listing API documentation Alt platform page Pricing

Prefilled cURL

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

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	Yes	58e5a6a5-a7ad-417f-8cda-ceffb226928c	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
listing_type	string	Yes	AUCTION	The listing's listing_type from the same Search/Auctions result

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"
      }
    ]
  }
}

Get one Alt listing's full public detail

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "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" } ] } }