Shipping rates

Landed cost matters. We report what sellers actually charged for shipping on real sold listings, plus a clearly-labelled estimate.

Request

curl -X POST https://grail.solutions/v1/shipping/rates \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"charizard base set","weight_oz":3}'

Response

{
  "schema": "grail.shipping.1",
  "keyword": "charizard base set",
  "marketplace": "EBAY_US",
  "observed": {
    "count": 84,
    "median": 5.99,
    "freeShippingPct": 41,
    "min": 0,
    "max": 18.5
  },
  "estimate": {
    "label": "estimate",
    "low": 4.5,
    "high": 7.5,
    "basis": "weight + observed typical"
  },
  "limitations": ["observed from Grail's own corpus"]
}

Honest by default

The observed block is computed from real sold listings we own. The estimate block is labelled as such — we never present a fabricated carrier quote as fact. When we lack observations, the endpoint fails closed rather than inventing numbers.