Docs menu

Alt API endpoint

Alt auctions API

Searches Alt's own currently live auctions -- the same pool shown on alt.xyz/browse's "Auctions" tab filtered to the Alt source. Unlike alt-search, this never returns another source auction house's listings or Alt's own fixed-price items. See alt-categories for the accepted category/grading_company/sort values.

GETapiKey2 credits/requestAltalt.auctionsResponseDoc/alt/auctions

Endpoint facts

Method: GET
API path: /alt/auctions
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Alt
Response schema: #/definitions/alt.auctionsResponseDoc

Alt Scraper API Try Alt auctions API in Playground Alt API documentation

How this endpoint behaves

Query parameters:

q (optional) — free-text search across item name, subject, brand, and variety. Omit or pass * to browse every current Alt auction.
category (optional) — comma-separated card category filter. One or more of BASEBALL_CARDS, POKEMON_CARDS, FOOTBALL_CARDS, BASKETBALL_CARDS, POP-CULTURE_CARDS, HOCKEY_CARDS, SOCCER_CARDS, ONE_PIECE_CARDS, OTHER_CARDS, TCG_CARDS, COMBAT_SPORTS_CARDS, RACING_CARDS, MAGIC_CARDS, YUGIOH_CARDS, GOLF_CARDS, TENNIS_CARDS. See alt-categories for live discovery.
grading_company (optional) — comma-separated grading company filter. One or more of PSA, CGC, BGS, CSG, SGC, PSA/DNA, BVG, BCCG, Factory Sealed, BAS, AUTHENTIC, TAG, RELABEL, RECASE, JSA/BVG, REVIEW, INTERNAL, NEW/, BULK, OTHERS, UNGRADED. See alt-categories.
sort (optional) — one of recommended (default), alt_value_desc, alt_value_asc, price_desc, price_asc, watched_desc, ending_soonest_asc, timestamp_desc.
page (optional) — 1-based page number, default 1.
per_page (optional) — results per page, default 24, max 100.

Notable response behavior:

Every result's auction_house is always Alt and listing_type is always AUCTION — there is no auction_house/listing_type filter param here since both are already fixed.

Live monitoring

Monitored request: GET /alt/auctions
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 3.03 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /alt/auctions?per_page=20
Items in results: 20
Fields filled in every checked item: 20
Fields empty in some or all items: 8

Field	Filled in, of 20 checked	Values in the sample
id	20
asset_id	20
listing_id	20
name	20	“1998 Pokemon Promo Japanese Corocoro Comics Holo Pikachu Il…” and 18 other values
subject	20	“Pikachu Illustrator” and 15 other values
year	20	1,998 to 2,025, median 2,004
brand	20	“Pokemon Promo Japanese” and 16 other values
variety	20	“Corocoro Comics Holo” and 12 other values
category	20	POKEMON_CARDS (15), BASKETBALL_CARDS (4), BASEBALL_CARDS (1)
auction_house	20	Alt in all 20
auction_name	20	Oct 02 - Oct 15, 2026 (13), Oct 09 - Oct 22, 2026 (7)
listing_type	20	AUCTION in all 20
grading_company	20	PSA (16), BGS (4)
grade	20	8 to 10, median 10
pop	20	1 to 151, median 28
price	20	32,943 to 2,048,295, median 283,219
alt_value	20	191,437.45 to 2,406,121.02, median 266,452.31
bid_count	18	2 to 36, median 14
watch_count	19	49 to 550, median 236
expires_at	20	2026-10-16 to 2026-10-23
created_at	20	2026-09-25 to 2026-10-13
images	20	median 2 entries
card_number	18	“78” and 16 other values
autograph	3	10
serial	5	1 to 78, median 38
print_run	5	1 to 99, median 50
view_count	15	26 to 568,876, median 20,468
badges	7	median 2 entries

Request parameters

Parameter	Type	Required	Description	Example
q	string	No	Free-text search across item name, subject, brand, and variety. Omit or pass * to browse every current Alt auction.	michael jordan
category	string	No	Comma-separated card category filter Allowed values: BASEBALL_CARDS, POKEMON_CARDS, FOOTBALL_CARDS, BASKETBALL_CARDS, POP-CULTURE_CARDS, HOCKEY_CARDS, SOCCER_CARDS, ONE_PIECE_CARDS, OTHER_CARDS, TCG_CARDS, COMBAT_SPORTS_CARDS, RACING_CARDS, MAGIC_CARDS, YUGIOH_CARDS, GOLF_CARDS, TENNIS_CARDS.
grading_company	string	No	Comma-separated grading company filter Allowed values: PSA, CGC, BGS, CSG, SGC, PSA/DNA, BVG, BCCG, Factory Sealed, BAS, AUTHENTIC, TAG, RELABEL, RECASE, JSA/BVG, REVIEW, INTERNAL, NEW/, BULK, OTHERS, UNGRADED.
sort	string	No	Result order. Default recommended. Allowed values: recommended, alt_value_desc, alt_value_asc, price_desc, price_asc, watched_desc, ending_soonest_asc, timestamp_desc.
page	integer	No	1-based page number, default 1
per_page	integer	No	Results per page, default 24, max 100
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/alt/auctions?q=coffee&category=BASEBALL_CARDS&grading_company=PSA&sort=recommended&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "*",
    "page": 1,
    "per_page": 24,
    "total": 653,
    "results": [
      {
        "id": "58e5a6a5-a7ad-417f-8cda-ceffb226928c",
        "name": "2007 Exquisite Collection Dual Logoman Autographs Kobe Bryant/Lebron James #DL-BJ /1",
        "subject": "Kobe Bryant/Lebron James",
        "year": 2007,
        "category": "BASKETBALL_CARDS",
        "auction_house": "Alt",
        "listing_type": "AUCTION",
        "grading_company": "PSA",
        "grade": "8.0",
        "price": 1772280,
        "alt_value": 8460808.16,
        "bid_count": 18,
        "watch_count": 849,
        "expires_at": "2026-09-25T01:00:00+00:00",
        "images": [
          {
            "position": "FRONT",
            "url": "https://onlyalt-images.s3.us-east-2.amazonaws.com/image/public/front.png"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/alt.auctionsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	alt.AuctionsResponse	No
data.page	integer	No
data.per_page	integer	No
data.query	string	No
data.results	array	No		Listing record, 30 fields: alt_value, asset_id, auction_house, auction_name, autograph, badges, bid_count, brand, card_number, category, created_at, expires_at and 16 more. Described under Alt search API.
data.total	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/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/auctions?q=coffee&category=BASEBALL_CARDS&grading_company=PSA&sort=recommended&page=1" \
  -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 card search API documentation Alt categories API documentation Alt listing API documentation Alt market trends API documentation Alt search API documentation

Open in Playground Back to group

Docs menu

Alt API endpoint

Alt auctions API

GETapiKey2 credits/requestAltalt.auctionsResponseDoc/alt/auctions

Endpoint facts

Method: GET
API path: /alt/auctions
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Alt
Response schema: #/definitions/alt.auctionsResponseDoc

Alt Scraper API Try Alt auctions API in Playground Alt API documentation

How this endpoint behaves

Query parameters:

q (optional) — free-text search across item name, subject, brand, and variety. Omit or pass * to browse every current Alt auction.
category (optional) — comma-separated card category filter. One or more of BASEBALL_CARDS, POKEMON_CARDS, FOOTBALL_CARDS, BASKETBALL_CARDS, POP-CULTURE_CARDS, HOCKEY_CARDS, SOCCER_CARDS, ONE_PIECE_CARDS, OTHER_CARDS, TCG_CARDS, COMBAT_SPORTS_CARDS, RACING_CARDS, MAGIC_CARDS, YUGIOH_CARDS, GOLF_CARDS, TENNIS_CARDS. See alt-categories for live discovery.
grading_company (optional) — comma-separated grading company filter. One or more of PSA, CGC, BGS, CSG, SGC, PSA/DNA, BVG, BCCG, Factory Sealed, BAS, AUTHENTIC, TAG, RELABEL, RECASE, JSA/BVG, REVIEW, INTERNAL, NEW/, BULK, OTHERS, UNGRADED. See alt-categories.
sort (optional) — one of recommended (default), alt_value_desc, alt_value_asc, price_desc, price_asc, watched_desc, ending_soonest_asc, timestamp_desc.
page (optional) — 1-based page number, default 1.
per_page (optional) — results per page, default 24, max 100.

Notable response behavior:

Every result's auction_house is always Alt and listing_type is always AUCTION — there is no auction_house/listing_type filter param here since both are already fixed.

Live monitoring

Monitored request: GET /alt/auctions
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 3.03 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /alt/auctions?per_page=20
Items in results: 20
Fields filled in every checked item: 20
Fields empty in some or all items: 8

Field	Filled in, of 20 checked	Values in the sample
id	20
asset_id	20
listing_id	20
name	20	“1998 Pokemon Promo Japanese Corocoro Comics Holo Pikachu Il…” and 18 other values
subject	20	“Pikachu Illustrator” and 15 other values
year	20	1,998 to 2,025, median 2,004
brand	20	“Pokemon Promo Japanese” and 16 other values
variety	20	“Corocoro Comics Holo” and 12 other values
category	20	POKEMON_CARDS (15), BASKETBALL_CARDS (4), BASEBALL_CARDS (1)
auction_house	20	Alt in all 20
auction_name	20	Oct 02 - Oct 15, 2026 (13), Oct 09 - Oct 22, 2026 (7)
listing_type	20	AUCTION in all 20
grading_company	20	PSA (16), BGS (4)
grade	20	8 to 10, median 10
pop	20	1 to 151, median 28
price	20	32,943 to 2,048,295, median 283,219
alt_value	20	191,437.45 to 2,406,121.02, median 266,452.31
bid_count	18	2 to 36, median 14
watch_count	19	49 to 550, median 236
expires_at	20	2026-10-16 to 2026-10-23
created_at	20	2026-09-25 to 2026-10-13
images	20	median 2 entries
card_number	18	“78” and 16 other values
autograph	3	10
serial	5	1 to 78, median 38
print_run	5	1 to 99, median 50
view_count	15	26 to 568,876, median 20,468
badges	7	median 2 entries

Request parameters

Parameter	Type	Required	Description	Example
q	string	No	Free-text search across item name, subject, brand, and variety. Omit or pass * to browse every current Alt auction.	michael jordan
category	string	No	Comma-separated card category filter Allowed values: BASEBALL_CARDS, POKEMON_CARDS, FOOTBALL_CARDS, BASKETBALL_CARDS, POP-CULTURE_CARDS, HOCKEY_CARDS, SOCCER_CARDS, ONE_PIECE_CARDS, OTHER_CARDS, TCG_CARDS, COMBAT_SPORTS_CARDS, RACING_CARDS, MAGIC_CARDS, YUGIOH_CARDS, GOLF_CARDS, TENNIS_CARDS.
grading_company	string	No	Comma-separated grading company filter Allowed values: PSA, CGC, BGS, CSG, SGC, PSA/DNA, BVG, BCCG, Factory Sealed, BAS, AUTHENTIC, TAG, RELABEL, RECASE, JSA/BVG, REVIEW, INTERNAL, NEW/, BULK, OTHERS, UNGRADED.
sort	string	No	Result order. Default recommended. Allowed values: recommended, alt_value_desc, alt_value_asc, price_desc, price_asc, watched_desc, ending_soonest_asc, timestamp_desc.
page	integer	No	1-based page number, default 1
per_page	integer	No	Results per page, default 24, max 100
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/alt/auctions?q=coffee&category=BASEBALL_CARDS&grading_company=PSA&sort=recommended&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "*",
    "page": 1,
    "per_page": 24,
    "total": 653,
    "results": [
      {
        "id": "58e5a6a5-a7ad-417f-8cda-ceffb226928c",
        "name": "2007 Exquisite Collection Dual Logoman Autographs Kobe Bryant/Lebron James #DL-BJ /1",
        "subject": "Kobe Bryant/Lebron James",
        "year": 2007,
        "category": "BASKETBALL_CARDS",
        "auction_house": "Alt",
        "listing_type": "AUCTION",
        "grading_company": "PSA",
        "grade": "8.0",
        "price": 1772280,
        "alt_value": 8460808.16,
        "bid_count": 18,
        "watch_count": 849,
        "expires_at": "2026-09-25T01:00:00+00:00",
        "images": [
          {
            "position": "FRONT",
            "url": "https://onlyalt-images.s3.us-east-2.amazonaws.com/image/public/front.png"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/alt.auctionsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	alt.AuctionsResponse	No
data.page	integer	No
data.per_page	integer	No
data.query	string	No
data.results	array	No		Listing record, 30 fields: alt_value, asset_id, auction_house, auction_name, autograph, badges, bid_count, brand, card_number, category, created_at, expires_at and 16 more. Described under Alt search API.
data.total	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/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/auctions?q=coffee&category=BASEBALL_CARDS&grading_company=PSA&sort=recommended&page=1" \
  -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 auctions 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 auctions 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