The eBay sold comps API: comps for one item in one call

# comps.py  (pip install requests)
import os
import statistics
import requests

# Sold comps for one item: the last 100 sales of the same thing, used, priced from the sales.
r = requests.get(
    "https://api.trawl.dev/ebay/v1/sold",
    headers={"x-api-key": os.environ["TRAWL_API_KEY"]},
    params={
        "query": "iphone 15 pro 256gb",
        "condition": "used",
        "exclude": "max,case,cracked,parts,locked",
        "max_pages": 1,  # up to 100 sales, 1 credit
    },
    timeout=30,
)
r.raise_for_status()
sold = r.json()
sales = sold["results"]
prices = sorted(s["sale_price"] for s in sales)
n = len(prices)
print(f"{sold['count']} comps, {sold['credits_charged']} credit")
print(f"median {statistics.median(prices):.2f}, low {prices[0]:.2f}, high {prices[-1]:.2f}")
print(f"middle half {prices[n // 4]:.2f} to {prices[3 * n // 4]:.2f}")
print("latest five:")
for s in sales[:5]:
    print(f"  {s['date_sold'][:10]}  {s['sale_price']:>8.2f}  {s['title'][:56]}")

// comps.mjs  (Node 18 or newer, no packages)
const params = new URLSearchParams({
  query: "iphone 15 pro 256gb",
  condition: "used",
  exclude: "max,case,cracked,parts,locked",
  max_pages: "1", // up to 100 sales, 1 credit
});
const r = await fetch(`https://api.trawl.dev/ebay/v1/sold?${params}`, {
  headers: { "x-api-key": process.env.TRAWL_API_KEY },
});
if (!r.ok) throw new Error(`${r.status} ${await r.text()}`);
const sold = await r.json();
const sales = sold.results;
const prices = sales.map((s) =>; s.sale_price).sort((a, b) =>; a - b);
const n = prices.length;
const median = n % 2 ? prices[(n - 1) / 2] : (prices[n / 2 - 1] + prices[n / 2]) / 2;
console.log(`${sold.count} comps, ${sold.credits_charged} credit`);
console.log(`median ${median.toFixed(2)}, low ${prices[0].toFixed(2)}, high ${prices[n - 1].toFixed(2)}`);
console.log(`middle half ${prices[Math.floor(n / 4)].toFixed(2)} to ${prices[Math.floor((3 * n) / 4)].toFixed(2)}`);
console.log("latest five:");
for (const s of sales.slice(0, 5)) {
  console.log(`  ${s.date_sold.slice(0, 10)}  ${s.sale_price.toFixed(2).padStart(8)}  ${s.title.slice(0, 56)}`);
}