Shopgoodwill Search
shopgoodwill_searchSearch active auctions on shopgoodwill.com, the online auction site run by Goodwill member organizations, cameras, jewelry, watches, art, collectibles, electronics, clothing. Returns live listings with current bid price, bid count, buy-now price, category, end time and listing URL. Bids are served through a 5-minute result cache, so the current bid can be up to five minutes old: near the close of an auction treat it as a lower bound, never as the final price. Sourced from the shopgoodwill.com search API.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "nikon",
"per_page": 5
},
"name": "shopgoodwill_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Result page, starting at 1 | |
| query | Yes | Search keywords, e.g. "nikon d750" or "sterling silver" | |
| per_page | No | Max results to return, up to 40 (each source page holds 40 rows; use page to paginate) | |
| max_price | No | Maximum current price in USD | |
| min_price | No | Minimum current price in USD | |
| category_id | No | Optional ShopGoodwill category id to narrow results (e.g. 15 = Art, 99 = Books) | |
| buy_now_only | No | Only listings with a Buy Now price |