New

Pricing Search

Search historical listings by title — no card ID needed. Great for surfacing listings our AI isn't yet confident in matching, or sellers who use unusual titles

What This Does

Free-text fuzzy search over marketplace listing titles for historical pricing
Returns a flat, relevance-ranked list that spans many cards — not scoped to a single card ID
Auctions show what buyers actually paid (bid); Buy It Now shows seller asking prices (ask)
Each result carries the canonical card it matched (when matched) plus grade context for graded sales
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
Pricing listings our AI isn't confident in matching, or sellers who use unusual titles
Quick "what's this going for" lookups straight from a search box
Comparing auction prices (bid) vs Buy It Now (ask) across many listings at once

Real Example

Scenario

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

Sample Request

GET

/v1/pricing/search?q=ken griffey jr 1989 upper deck&period=90d&listing_type=both

What You Get Back

{
  "query": {
    "q": "ken griffey jr 1989 upper deck",
    "listing_type": "both",
    "period": "90d",
    "limit": 50,
    "as_of_date": "2026-06-30"
  },
  "results": [
    {
      "title": "1989 Upper Deck #1 Ken Griffey Jr RC Rookie PSA 10",
      "price": 1250,
      "date": "2026-06-15T00:00:00Z",
      "source": "ebay",
      "listing_type": "auction",
      "url": "https://www.ebay.com/itm/...",
      "image_url": "https://i.ebayimg.com/...",
      "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 nice card",
      "price": 39.99,
      "date": "2026-06-10T00:00:00Z",
      "source": "ebay",
      "listing_type": "fixed"
    }
  ],
  "meta": {
    "sources": [
      {
        "source": "ebay",
        "count": 42
      }
    ],
    "total_records": 42
  }
}