---
title: "Search Alt's aggregated card marketplace"
method: GET
path: "/alt/search"
tags: ["Alt"]
---

# Search Alt's aggregated card marketplace

`GET /alt/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/alt/search`
- Auth: API key in header `x-api-key`

Searches Alt's universal aggregator index -- live auction and fixed-price listings from Alt itself and every other source auction house its search carries (eBay, Fanatics Collect, Pristine Auction, Goldin, CardHobby, Memory Lane) -- by free-text query, category, source auction house, grading company, and listing type, in a caller-selected sort order. Only currently-live listings are returned; see alt-sold-listings for completed sales. See alt-categories for the accepted category/auction_house/grading_company/listing_type/sort values.

## Query parameters

- `q` string
- `category` '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'
- `auction_house` 'eBay' | 'Fanatics Collect' | 'Alt' | 'Pristine Auction' | 'Goldin' | 'CardHobby' | 'Memory Lane'
- `grading_company` 'PSA' | 'CGC' | 'BGS' | 'CSG' | 'SGC' | 'PSA/DNA' | 'BVG' | 'BCCG' | 'Factory Sealed' | 'BAS' | 'AUTHENTIC' | 'TAG' | 'RELABEL' | 'RECASE' | 'JSA/BVG' | 'REVIEW' | 'INTERNAL' | 'NEW/' | 'BULK' | 'OTHERS' | 'UNGRADED'
- `listing_type` 'AUCTION' | 'FIXED_PRICE' | 'EXTERNAL_AUCTION' | 'EXTERNAL_FIXED_PRICE'
- `sort` 'recommended' | 'alt_value_desc' | 'alt_value_asc' | 'price_desc' | 'price_asc' | 'watched_desc' | 'ending_soonest_asc' | 'timestamp_desc'
- `page` integer
- `per_page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AltSearchResponseDoc
  - `code` integer
  - `data` AltSearchResponse
    - `page` integer
    - `per_page` integer
    - `query` string
    - `results` AltListing[]
      - `alt_value` number
      - `asset_id` string
      - `auction_house` string
      - `auction_name` string
      - `autograph` string
      - `badges` string[]
      - `bid_count` integer
      - `brand` string
      - `card_number` string
      - `category` string
      - `created_at` integer
      - `expires_at` string
      - `grade` string
      - `grading_company` string
      - `id` string
      - `images` AltImage[]
        - `position` string
        - `url` string
      - `listing_id` string
      - `listing_type` string
      - `name` string
      - `pop` integer
      - `price` number
      - `print_run` integer
      - `serial` integer
      - `subject` string
      - `variety` string
      - `view_count` integer
      - `watch_count` integer
      - `year` integer
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)