New

Marketplace Search

Search what's for sale right now by listing title — no card ID needed. Find active auctions and Buy It Now listings with direct links to buy

What This Does

Free-text fuzzy search over marketplace listing titles for currently active listings
Returns a flat, relevance-ranked list that spans many cards — not scoped to a single card ID
Each result includes price, condition, bid count, end date, and a direct link to the listing
Each result carries the canonical card it matched (when matched) plus grade context for graded listings
Surfaces raw listings — including ones our AI isn't confident in matching to a card in our catalog

When To Use This

You have a card's name/year/set as text but not its UUID
Showing users where to buy a card right now, searched straight from a text box
Finding active listings our AI isn't confident in matching, or with unusual seller titles
Comparing current asking prices across many active listings at once

Real Example

Scenario

You want active listings for a 1989 Upper Deck Ken Griffey Jr rookie but only have the text, not a card ID

Sample Request

GET

/v1/marketplace/search?q=ken griffey jr 1989 upper deck&listing_type=both

What You Get Back

{
  "query": {
    "q": "ken griffey jr 1989 upper deck",
    "listing_type": "both",
    "limit": 50,
    "as_of_date": "2026-06-30"
  },
  "results": [
    {
      "title": "1989 Upper Deck #1 Ken Griffey Jr RC Rookie PSA 10",
      "price": 1399.99,
      "source": "ebay",
      "listing_type": "fixed",
      "url": "https://www.ebay.com/itm/...",
      "image_url": "https://i.ebayimg.com/...",
      "condition": "Graded",
      "end_date": "2026-07-05T00:00:00Z",
      "bid_count": null,
      "matched_card": {
        "card_id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Ken Griffey Jr.",
        "number": "1",
        "set": {
          "set_id": "...",
          "name": "Base Set",
          "year": "1989",
          "release": "1989 Upper Deck"
        }
      },
      "grade": {
        "grade_id": "...",
        "grade_value": "10",
        "company_name": "PSA",
        "company_id": "..."
      }
    },
    {
      "title": "Griffey 1989 UD rookie raw auction no reserve",
      "price": 25.5,
      "source": "ebay",
      "listing_type": "auction",
      "end_date": "2026-07-02T00:00:00Z",
      "bid_count": 7
    }
  ],
  "meta": {
    "sources": [
      {
        "source": "ebay",
        "count": 18
      }
    ],
    "total_records": 18
  }
}