Search government surplus auctions
search_auctionsFind active GovDeals government surplus auctions by keyword, state, category, price, or closing time; returns normalized listings with current bid, end time, and location, sorted by soonest ending.
Instructions
Search active government surplus auctions on GovDeals. Returns normalized listings (title, current bid, end time, location) sorted by soonest ending, plus a per-site status. Use get_auction_details for mileage, VIN, buyer's premium and pickup info.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_auctions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results to return (default 10) | |
| state | No | Two-letter US state where the item is located, e.g. TX. Omit to search nationwide. | |
| keyword | No | What to look for, e.g. "pickup truck", "F-150", "excavator", "laptop" | |
| category | No | Item category. "vehicles" and "trailers" are filtered natively on GovDeals; other categories are matched by keyword. | |
| max_price | No | Only auctions whose current bid is at or below this many USD | |
| min_price | No | Only auctions whose current bid is at least this many USD | |
| ending_within_hours | No | Only auctions closing within this many hours (max 336, i.e. 14 days) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auctions | Yes | ||
| warnings | Yes | ||
| total_returned | Yes |