equipmenttrader.com APIequipmenttrader.com ↗
Search and retrieve industrial machinery listings from Equipment Trader. Get pricing, specs, hours, seller contacts, and location data via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/0813e3f4-48e4-4fd7-b93b-2a1a6517c470/search_listings?page=1&keyword=excavator' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for industrial machinery listings on Equipment Trader. Returns paginated results with listing summaries including pricing, location, and seller information.
| Param | Type | Description |
|---|---|---|
| zip | string | Zip code for location-based search |
| make | string | Filter by make (e.g., CATERPILLAR, KUBOTA, JOHN DEERE) |
| page | integer | Page number for pagination |
| sort | string | Sort order. Accepted values: relevance:desc, price:asc, price:desc, year:desc, year:asc |
| model | string | Filter by model |
| radius | integer | Search radius in miles |
| keyword | string | Search keyword (e.g., excavator, forklift) |
{
"type": "object",
"fields": {
"page": "integer current page number",
"listings": "array of listing objects with id, title, year, make, model, category, class, price, description, hours, condition, location, seller, url, stock_number, serial_number",
"total_pages": "integer total number of pages",
"total_results": "integer total count of matching listings"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"id": 5032146644,
"url": "https://www.equipmenttrader.com/listing/2023-CATERPILLAR-308+CR-5032146644",
"make": "CATERPILLAR",
"year": 2023,
"class": "EARTHMOVING",
"hours": 1569,
"model": "308 CR",
"price": 124700,
"title": "2023 CATERPILLAR 308 CR",
"seller": {
"name": "Clark Equipment Rental and Sales",
"phones": [
{
"type": "",
"number": "8887096223"
}
],
"website": "http://www.clarkrents.com",
"dealer_id": "5000009463"
},
"category": [
"Excavators"
],
"location": {
"zip": "13032",
"city": "canastota",
"state": "NY",
"latitude": "43.08030",
"longitude": "-75.76430"
},
"condition": "Used",
"description": "2023 CATERPILLAR, 308 CR Excavators - Crawler, Hydraulic quick coupler...",
"stock_number": "9025",
"serial_number": "009025"
}
],
"total_pages": 11,
"total_results": 3489
},
"status": "success"
}
}About the equipmenttrader.com API
The Equipment Trader API provides access to machinery inventory across Equipment Trader's marketplace through 2 endpoints. Use search_listings to query listings by make, model, keyword, zip code, and radius, or call get_listing_details with a specific ad ID to retrieve full specs, hours, price, and seller contact information including phone numbers and dealer website.
Searching Machinery Inventory
The search_listings endpoint accepts up to seven optional parameters. You can filter by make (e.g., CATERPILLAR, JOHN DEERE, KUBOTA), model, and keyword to narrow by equipment type such as excavator or forklift. Location filtering uses zip and radius (in miles). Results are paginated; the response includes total_results, total_pages, and the current page number alongside an array of listing objects. Each listing summary contains id, title, year, make, model, category, class, price, description, hours, condition, location, and seller information.
Listing Detail Fields
The get_listing_details endpoint takes a single required parameter, ad_id, and returns the full record for that listing. Response fields include id, url, make, model, year, class, hours, price, and a constructed title. The seller object includes name, dealer_id, website, and a phones array, making it straightforward to surface contact information alongside equipment specs.
Sorting and Pagination
Search results can be ordered using the sort parameter, which accepts relevance:desc, price:asc, price:desc, year:desc, and year:asc. Pagination is handled by passing an integer page value; the response always echoes back total_pages so you can iterate through large result sets programmatically.
- Aggregate machinery pricing data by make and model for market valuation benchmarks
- Build a fleet procurement tool that queries listings by zip and radius to surface nearby equipment
- Monitor used equipment hours and condition fields to flag low-hour units as they appear
- Enrich a dealer directory with seller names, phone numbers, and websites from listing detail responses
- Compare new vs. used pricing across categories using the condition field in search results
- Track year-over-year price trends for specific makes by sorting results with price:asc and year:desc
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Equipment Trader have an official developer API?+
What seller information does get_listing_details return?+
seller object includes the dealer name, a dealer_id, the dealer's website URL, and a phones array. It does not include an email address or a direct messaging endpoint. The API covers search and detail retrieval; you can fork it on Parse and revise to add any additional contact fields if they become available.Can I filter search results by equipment category or condition?+
search_listings endpoint currently accepts make, model, keyword, zip, radius, sort, and page as filter parameters. Category and condition are returned as fields in each listing object but are not exposed as direct filter inputs. You can fork the API on Parse and revise it to add category or condition as filterable parameters.Does the API return images for listings?+
search_listings or get_listing_details response schemas. The API covers pricing, specs, hours, location, and seller contact data. You can fork it on Parse and revise to add image fields if that data is needed.How fresh is the listing data, and can inactive listings cause errors?+
ad_id that was valid in a prior search may return an empty or error response if the listing has since been taken down.