Does eBay API return sold listings?

# browse_to_sold.py  (pip install requests)
import os
import requests

# A Browse API search: keywords, a category, and filters for condition and price.
browse = {
    "q": "iphone 15 pro 256gb",
    "category_ids": "9355",
    "filter": "conditions:{USED},price:[300..700],priceCurrency:USD",
    "limit": 50,
}
# The same search on GET /sold. Every result sold, so there is no sold filter to add.
filters = dict(f.split(":", 1) for f in browse["filter"].split(","))
low, high = filters["price"].strip("[]").split("..")
r = requests.get("https://api.trawl.dev/ebay/v1/sold", timeout=30, headers={"x-api-key": os.environ["TRAWL_API_KEY"]}, params={
    "query": browse["q"],
    "category": browse["category_ids"],
    "condition": filters["conditions"].strip("{}").lower().replace("|", ","),  # USED -> used
    "min_price": low,
    "max_price": high,
    "max_pages": 1,  # a page is 100 results
})
r.raise_for_status()
sold = r.json()
print(f"{sold['count']} sold items, {sold['credits_charged']} credit")
for s in sold["results"][:5]:
    print(f"{s['date_sold'][:10]}  {s['currency']} {s['sale_price']:>7.2f}  {s['title'][:56]}")

// browse_to_sold.mjs  (Node 18 or newer, no package)
// A Browse API search: keywords, a category, and filters for condition and price.
const browse = {
  q: "iphone 15 pro 256gb",
  category_ids: "9355",
  filter: "conditions:{USED},price:[300..700],priceCurrency:USD",
  limit: 50,
};
// The same search on GET /sold. Every result sold, so there is no sold filter to add.
const filters = Object.fromEntries(browse.filter.split(",").map((f) =>; f.split(/:(.*)/s).slice(0, 2)));
const [low, high] = filters.price.replace(/[[\]]/g, "").split("..");
const params = new URLSearchParams({
  query: browse.q,
  category: browse.category_ids,
  condition: filters.conditions.replace(/[{}]/g, "").toLowerCase().replaceAll("|", ","),  // USED -> used
  min_price: low,
  max_price: high,
  max_pages: 1,  // a page is 100 results
});
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();
console.log(`${sold.count} sold items, ${sold.credits_charged} credit`);
for (const s of sold.results.slice(0, 5)) {
  console.log(`${s.date_sold.slice(0, 10)}  ${s.currency} ${s.sale_price.toFixed(2).padStart(7)}  ${s.title.slice(0, 56)}`);
}

// browse_to_sold.go  (Go 1.22 or newer, standard library only)
package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "os"
)

type sold struct {
    Count   int `json:"count"`
    Credits int `json:"credits_charged"`
    Results []struct {
        Title     string  `json:"title"`
        SalePrice float64 `json:"sale_price"`
        Currency  string  `json:"currency"`
        DateSold  string  `json:"date_sold"`
    } `json:"results"`
}

func main() {
    // A Browse API search: q=iphone 15 pro 256gb, category_ids=9355,
    // filter=conditions:{USED},price:[300..700],priceCurrency:USD.
    // The same search on GET /sold. Every result sold, so there is no sold filter to add.
    q := url.Values{
        "query":     {"iphone 15 pro 256gb"}, // was q
        "category":  {"9355"},                // was category_ids
        "condition": {"used"},                // was conditions:{USED}
        "min_price": {"300"},                 // was price:[300..700]
        "max_price": {"700"},
        "max_pages": {"1"}, // a page is 100 results
    }
    req, _ := http.NewRequest("GET", "https://api.trawl.dev/ebay/v1/sold?"+q.Encode(), nil)
    req.Header.Set("x-api-key", os.Getenv("TRAWL_API_KEY"))
    res, err := http.DefaultClient.Do(req)
    if err != nil || res.StatusCode != 200 {
        panic(fmt.Sprint(err, res))
    }
    var s sold
    json.NewDecoder(res.Body).Decode(&;s)
    fmt.Printf("%d sold items, %d credit\n", s.Count, s.Credits)
    for _, it := range s.Results[:5] {
        fmt.Printf("%s  %s %7.2f  %.56s\n", it.DateSold[:10], it.Currency, it.SalePrice, it.Title)
    }
}