# IronPlanet · List equipment

Get product, price and seller data with IronPlanet · List equipment from Alexandria through one Spiral API key. Browse or filter equipment for sale by category or make; discover filter values via `include_facets`; paginate with `continuation`. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: E-commerce
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `ironplanet-com/equipment-auctions/list_equipment`
- Page: https://spiral.ai/tools/alexandria/ironplanet-com/equipment-auctions/list_equipment

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `url` | text |  | — | Alternatively a pasted listing URL such as https://www.ironplanet.com/Excavators?c=3&sm=0&m=Bobcat; its slug and recognised query parameters are used. |
| `make` | text |  | — | Make filter (`m`), e.g. `Bobcat`, `John Deere`. |
| `sort` | one of | bm asc, p asc, p desc, d asc, ad asc, ad desc, yr desc | bm asc | Sort key as the site encodes it: `bm asc` Best Match, `p asc`/`p desc` price, `d asc` closest to the exit IP (not reproducible), `ad asc`/`ad desc` ending sooner/later, `yr desc` year (newest first). |
| `type_id` | number | 1 to … | — | Sub-type id within the category (`t`), e.g. 12912 Tracked Excavator; discover via `include_facets`. |
| `location` | text |  | — | Location code (`l2`): a country (`USA`, `CAN`, `MEX`) or country-region (`USA-TX`). Pattern: ^[A-Z]{2,3}(-[A-Z0-9]{2,3})?$. |
| `page_size` | one of | 20, 60, 100 | 20 | Items per page (`prows`). |
| `marketplace` | one of | I, M, T, G, R, S | — | Marketplace (`ms`): I IronPlanet, M Marketplace-E, T TruckPlanet, G GovPlanet, R Ritchie Bros. Auctioneers, S SalvageSale. |
| `sale_format` | one of | D, A, L, S, B, M | — | Buying format (`fp`): D any auction, A online auction, L on-site auction, S sealed auction, B Buy Now, M Make Offer. |
| `year_bucket` | one of | 2020, 2015, 2010, 2000, 1900 | — | Model-year bucket (`yr`): 2020 = 2020 and newer, 2015 = 2015-2019, 2010 = 2010-2014, 2000 = 2000-2009, 1900 = before 2000. |
| `continuation` | text |  | — | Continuation cursor: the `next_offset` of the previous page as a decimal string. Pattern: ^[0-9]{1,7}$. |
| `price_bucket` | number | -1 to … | — | USD price bucket lower bound (`p_us`): -1 any USD price, 1000, 5000, 10000, 50000, 100000, 500000, 1000000. |
| `category_slug` | text |  | — | Path segment of a category or make listing page, as in the site's URLs: `Excavators`, `Bobcat`, `Truck+Tractors`, `Skid+Steer+Loaders`, `Cat-Excavators`. Spaces are accepted and encoded as `+`. Pattern: ^[A-Za-z0-9][A-Za-z0-9 +._&',()-]*$. |
| `include_facets` | true or false |  | — | Also return the page's facet links (type, buying format, make, location, year, price, marketplace) with counts. |
| `ironclad_assurance` | true or false |  | — | Only items with (true) or without (false) IronClad Assurance (`ica`). |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "ironplanet-com/equipment-auctions/list_equipment",
    "input": {
      "url": "<url>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=ironplanet-com%2Fequipment-auctions%2Flist_equipment

## Common questions

### IronPlanet · List equipment

**How much does IronPlanet · List equipment cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use IronPlanet · List equipment through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "ironplanet-com/equipment-auctions/list_equipment"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use IronPlanet · List equipment?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use IronPlanet · List equipment?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

