MachineryZone
Used construction machinery from MachineryZone as JSON: excavators, mini diggers, telehandlers and forklifts with price, year, hours, the dealer and the site's own price band.
/machineryzone/v1/search4 creditsSearch or browse MachineryZone's construction, earthmoving and handling machinery. Combine free text with the typed filters the source supports natively — category, manufacturer, model, advert type (sale, wanted, auction, rental), year of construction, hour meter, price band in EUR, seller country, region and department, professional or private, with a photo, posted this week — and sort by price, year, hours, model, manufacturer or listing date. 50 rows a page; the source caps depth at 200 pages = 10,000 rows per query, so narrow rather than page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| market = eu | optional | ar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · us | Which MachineryZone national host to read, i.e. the LANGUAGE of the labels and category names: eu = www.machineryzone.eu (English, the default), us = www.machineryzone.com, fr, de, es, it, nl, pl, pt, ro, se, fi, no, cz, hu, lt, rs, in, tr, br, ua, ca_fr (fr.machineryzone.com), ar (es.machineryzone.com). Listing, category and dealer ids and the totals are the same on every host, but the first pages of the default order put the host country's sellers first (measured 2026-11-22: track excavators, 52/52 rows German sellers on de, 6,250 in total; a newest-first excavator search on eu, 50/50 rows from the UK and Ireland); filter on `country` for one seller country. |
| query | optional | — | Free-text search across the whole listing (title, model and description), as the site's own search box does it, in the market's language (excavator on eu, pelle on fr, bagger on de). Either `query` or `category_id` is the normal starting point; `keyword` is the narrower, title/model-weighted text match. |
| keyword | optional | — | A narrower text match than `query` (the site's `search[keyword]` field, title/model-weighted). It is a text filter, not a category filter. |
| model | optional | — | The model designation as the seller typed it (the site's own `search[modele]` field). Combine with `manufacturer` for a comparable set; use `price_index` for the market price band of a make and model. |
| category_id | optional | 1– | MachineryZone's own category (tree) id — 2007 is Track excavators, 2302 Mini digger, 2187 Wheeled excavator. The id is language-invariant (the same on every host). Get ids from `categories`, `facets` or `suggest`. The source will not take a category together with other filters in one request (it answers 0 rows), so the engine sends the category first and the rest afterwards — one extra upstream request when you combine them. |
| manufacturer | optional | — | Manufacturer by NAME (Caterpillar, Komatsu, Hitachi, Volvo, JCB…), resolved live against the source's own facet list for your query, so a misspelling is a clear error with the real options. Costs one extra upstream request; pass `manufacturer_id` from `facets` for the cheaper call. |
| manufacturer_id | optional | 1– | Manufacturer by the source's own facet id, as `facets` publishes it (7861 = Caterpillar, 8577 = Komatsu, 8027 = JCB on MachineryZone). NOT the price observatory's make id for the same brand — the observatory keeps its own ids. |
| listing_type | optional | sale · wanted · auction · rental | What kind of advert: sale, wanted, auction or rental. Defaults to everything, which MIXES machines on offer with 'wanted' adverts, auctions and rentals — pass `sale` for machines actually offered for sale. |
| year_min | optional | 1900–2100 | Earliest year of construction, inclusive. 🔴 A YEAR, not a timestamp: this source takes 2015 and the filter bites (33,942 -> 24,718). A unix timestamp is ACCEPTED and answers 7,786 rows of nonsense, so the engine rejects anything that is not a plausible year instead of forwarding it. |
| year_max | optional | 1900–2100 | Latest year of construction, inclusive. |
| year_known | optional | — | Only listings whose year of construction is published at all. Useful because a year range on this source silently also drops the rows that have no year. |
| operating_hours_min | optional | 0– | Lowest hour-meter reading, inclusive. This is the machine's own hour counter (`h`), kept strictly separate from any odometer reading, which the source publishes as a distance property of its own. |
| operating_hours_max | optional | 0– | Highest hour-meter reading, inclusive. |
| operating_hours_known | optional | — | Only listings that publish an hour-meter reading at all. |
| price_min | optional | 0– | Lowest price, in EUR, VAT-excluded — the source's own reference price, the same number on every MachineryZone host (a dealer who prices in GBP is filtered on the EUR figure the search rows carry). |
| price_max | optional | 0– | Highest price, in EUR, VAT-excluded. |
| with_price_only | optional | — | Only listings that publish a price. 'Price on request' is a STATE here, not a missing value: those rows come back with `price: null` and `price_on_request: true` (25 of 50 rows on a newest-first excavator search, 2026-11-22). |
| country | optional | AE · AL · AM · AT · BA · BE · BG · CA · CH · CL · CN · CZ · DE · DK · EE · ES · FR · GB · GR · HR · HU · ID · IE · IT · LT · LU · LV · MD · ME · MK · MU · MX · NL · NO · PA · PH · PL · PT · PY · RO · RS · RU · SE · SI · SK · TH · TW · UA · US | Seller country, as an ISO-3166-1 alpha-2 code (GB, IE, FR, DE, IT, NL, BE…). An enum because the source takes a numeric area id of its own and answers a DIFFERENT, WRONG result set to an id it does not know; the ids behind these codes were read off the source's own select. |
| region_id | optional | 1– | Seller region, by the source's own id, which `locations` publishes for a country. Requires `country`, and the engine checks the id against the source's own live region list for that country before sending it — see the note on `country` for why. |
| department_id | optional | 1– | Seller department / province, by the source's own id, which `locations` publishes for a region. Requires `region_id`. |
| postcode | optional | — | Centre a radius search on a postcode YOU supply, together with `radius_km`. 🔴 The site's own 'around me' radius and its distance column are computed from the viewer's position, which for an API means the location of whichever server made the call — so neither is offered. A postcode you pass is a property of your question, not of our exit, which is why this form is. |
| radius_km | optional | 1–1000 | Radius in kilometres around `postcode`. Requires `postcode` and `country`. |
| seller_type | optional | professional · private | Whether the advert comes from a business or a private seller. Dealer adverts carry the company name, its town and its logo; private ones carry a location only. |
| has_photo | optional | — | Only listings with at least one photo. |
| has_video | optional | — | Only listings with a video. |
| posted_within_week | optional | — | Only listings published in the last seven days — the only recency window the source itself offers, so no other one is invented here. Pair it with `sort=newest` to watch a market. |
| flash_deal | optional | — | Only the source's own 'flash sale' adverts. |
| sort = newest | optional | newest · price_asc · price_desc · year_asc · year_desc · hours_asc · hours_desc · model_asc · model_desc · manufacturer_asc · manufacturer_desc · rental_price_asc · rental_price_desc | Result order. 🔴 The source also offers an ascending and a descending DISTANCE order; neither is exposed, because the distance it sorts on is measured from the caller's own position, which for an API is the server that made the request — the same reason no distance field is published. `dealer_price_ref_*` is likewise not offered: the source only reveals it to a logged-in professional. |
| page = 1 | optional | 1–200 | Result page, 50 rows each. 🔴 The ceiling is 200 pages = 10,000 rows per query no matter what `total` says, and page 201 does not error — it answers a redirect back to PAGE 1, so a naive pager re-reads the first page forever. Asking beyond the ceiling is an error here. To go deeper, narrow: category, manufacturer, year, price and country all bite hard (22,115 -> 6,787 -> 947 on one measured chain). |
| include_facets | optional | — | Also return the source's own live filter counts for this query in `meta.facets` — the categories, manufacturers, conditions and numeric ranges that actually have stock, with the ids the filters accept. |
/machineryzone/v1/detail3 creditsOne MachineryZone listing in full, by id: manufacturer, model, year of construction, condition, availability, hour meter, the price as the seller printed it with its currency (a UK dealer's machine prints in GBP) next to the page's own schema.org price in EUR — a disagreement is reported in `meta.warnings` — every row of the spec table, the seller's description, the gallery, the category breadcrumb and the dealer with the named contact persons and phone numbers the page prints.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_id | required | — | The numeric MachineryZone listing id, as `search` returns it and as it appears in the listing URL (www.machineryzone.eu/used/track-excavator/46842731/...). The slugs in the URL are ignored by the source; a listing that has gone answers NOT_FOUND. |
| market = eu | optional | ar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · us | Which MachineryZone national host to read, i.e. the LANGUAGE of the labels and category names: eu = www.machineryzone.eu (English, the default), us = www.machineryzone.com, fr, de, es, it, nl, pl, pt, ro, se, fi, no, cz, hu, lt, rs, in, tr, br, ua, ca_fr (fr.machineryzone.com), ar (es.machineryzone.com). Listing, category and dealer ids and the totals are the same on every host, but the first pages of the default order put the host country's sellers first (measured 2026-11-22: track excavators, 52/52 rows German sellers on de, 6,250 in total; a newest-first excavator search on eu, 50/50 rows from the UK and Ireland); filter on `country` for one seller country. |
/machineryzone/v1/categories3 creditsMachineryZone's own category tree (construction equipment, excavators, loaders, handling, lifting, trucks, attachments and spare parts…) with the numeric ids every other action takes and the source's own live counts; `meta.ids_matched` / `meta.ids_missing` say how complete the id join was.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| market = eu | optional | ar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · us | Which MachineryZone national host to read, i.e. the LANGUAGE of the labels and category names: eu = www.machineryzone.eu (English, the default), us = www.machineryzone.com, fr, de, es, it, nl, pl, pt, ro, se, fi, no, cz, hu, lt, rs, in, tr, br, ua, ca_fr (fr.machineryzone.com), ar (es.machineryzone.com). Listing, category and dealer ids and the totals are the same on every host, but the first pages of the default order put the host country's sellers first (measured 2026-11-22: track excavators, 52/52 rows German sellers on de, 6,250 in total; a newest-first excavator search on eu, 50/50 rows from the UK and Ireland); filter on `country` for one seller country. |
/machineryzone/v1/facets3 creditsThe source's own live filter vocabulary and counts for a MachineryZone query: which categories and manufacturers have stock and how much, the four advert types, conditions, seller countries and the real minimum and maximum of every numeric property. A value the source does not recognise answers 0 rows rather than an error, so take ids from here.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| market = eu | optional | ar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · us | Which MachineryZone national host to read, i.e. the LANGUAGE of the labels and category names: eu = www.machineryzone.eu (English, the default), us = www.machineryzone.com, fr, de, es, it, nl, pl, pt, ro, se, fi, no, cz, hu, lt, rs, in, tr, br, ua, ca_fr (fr.machineryzone.com), ar (es.machineryzone.com). Listing, category and dealer ids and the totals are the same on every host, but the first pages of the default order put the host country's sellers first (measured 2026-11-22: track excavators, 52/52 rows German sellers on de, 6,250 in total; a newest-first excavator search on eu, 50/50 rows from the UK and Ireland); filter on `country` for one seller country. |
| query | optional | — | Free-text search across the whole listing (title, model and description), as the site's own search box does it, in the market's language (excavator on eu, pelle on fr, bagger on de). Either `query` or `category_id` is the normal starting point; `keyword` is the narrower, title/model-weighted text match. |
| keyword | optional | — | A narrower text match than `query` (the site's `search[keyword]` field, title/model-weighted). It is a text filter, not a category filter. |
| category_id | optional | 1– | MachineryZone's own category (tree) id — 2007 is Track excavators, 2302 Mini digger, 2187 Wheeled excavator. The id is language-invariant (the same on every host). Get ids from `categories`, `facets` or `suggest`. The source will not take a category together with other filters in one request (it answers 0 rows), so the engine sends the category first and the rest afterwards — one extra upstream request when you combine them. |
| listing_type | optional | sale · wanted · auction · rental | What kind of advert: sale, wanted, auction or rental. Defaults to everything, which MIXES machines on offer with 'wanted' adverts, auctions and rentals — pass `sale` for machines actually offered for sale. |
| country | optional | AE · AL · AM · AT · BA · BE · BG · CA · CH · CL · CN · CZ · DE · DK · EE · ES · FR · GB · GR · HR · HU · ID · IE · IT · LT · LU · LV · MD · ME · MK · MU · MX · NL · NO · PA · PH · PL · PT · PY · RO · RS · RU · SE · SI · SK · TH · TW · UA · US | Seller country, as an ISO-3166-1 alpha-2 code (GB, IE, FR, DE, IT, NL, BE…). An enum because the source takes a numeric area id of its own and answers a DIFFERENT, WRONG result set to an id it does not know; the ids behind these codes were read off the source's own select. |
/machineryzone/v1/suggest1 creditMachineryZone's own autocomplete for a typed prefix: whole search phrases, and categories with their numeric ids and live counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What the user has typed so far (at least three characters). Answers in two buckets: whole search phrases and categories with their numeric ids and live counts. |
| market = eu | optional | ar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · us | Which MachineryZone national host to read, i.e. the LANGUAGE of the labels and category names: eu = www.machineryzone.eu (English, the default), us = www.machineryzone.com, fr, de, es, it, nl, pl, pt, ro, se, fi, no, cz, hu, lt, rs, in, tr, br, ua, ca_fr (fr.machineryzone.com), ar (es.machineryzone.com). Listing, category and dealer ids and the totals are the same on every host, but the first pages of the default order put the host country's sellers first (measured 2026-11-22: track excavators, 52/52 rows German sellers on de, 6,250 in total; a newest-first excavator search on eu, 50/50 rows from the UK and Ireland); filter on `country` for one seller country. |
/machineryzone/v1/dealers3 creditsThe MachineryZone dealer directory: company name, activity, country, town, department, further addresses, the manufacturer ranges they carry and how many adverts they have online, 50 a page. Searchable by company name, filterable by country.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| market = eu | optional | ar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · us | Which MachineryZone national host to read, i.e. the LANGUAGE of the labels and category names: eu = www.machineryzone.eu (English, the default), us = www.machineryzone.com, fr, de, es, it, nl, pl, pt, ro, se, fi, no, cz, hu, lt, rs, in, tr, br, ua, ca_fr (fr.machineryzone.com), ar (es.machineryzone.com). Listing, category and dealer ids and the totals are the same on every host, but the first pages of the default order put the host country's sellers first (measured 2026-11-22: track excavators, 52/52 rows German sellers on de, 6,250 in total; a newest-first excavator search on eu, 50/50 rows from the UK and Ireland); filter on `country` for one seller country. |
| company | optional | — | Filter the dealer directory by company name (the source's own `all_company` field). |
| country | optional | AE · AL · AM · AT · BA · BE · BG · CA · CH · CL · CN · CZ · DE · DK · EE · ES · FR · GB · GR · HR · HU · ID · IE · IT · LT · LU · LV · MD · ME · MK · MU · MX · NL · NO · PA · PH · PL · PT · PY · RO · RS · RU · SE · SI · SK · TH · TW · UA · US | Seller country, as an ISO-3166-1 alpha-2 code (GB, IE, FR, DE, IT, NL, BE…). An enum because the source takes a numeric area id of its own and answers a DIFFERENT, WRONG result set to an id it does not know; the ids behind these codes were read off the source's own select. |
| page = 1 | optional | 1–400 | Directory page, 50 dealers each. |
| sort = name | optional | name · name_desc · listings_asc · listings_desc · default | Directory order, using the source's own five sort values. The default here is `name` rather than the source's `default`, because `default` is exactly that — an order the source does not name and does not document, so a caller paging through 2,600 dealers would be relying on something that can change under them. Pass `default` explicitly if you want the source's own ordering. |
/machineryzone/v1/dealer3 creditsOne dealer's public business profile by id: company name, activity, how long they have been on the marketplace, website, follower count, street address, the manufacturer ranges they carry and their stock broken down by category with live counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| dealer_id | required | — | The dealer's own numeric id, as `dealers`, `search` and `detail` return it. |
| market = eu | optional | ar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · us | Which MachineryZone national host to read, i.e. the LANGUAGE of the labels and category names: eu = www.machineryzone.eu (English, the default), us = www.machineryzone.com, fr, de, es, it, nl, pl, pt, ro, se, fi, no, cz, hu, lt, rs, in, tr, br, ua, ca_fr (fr.machineryzone.com), ar (es.machineryzone.com). Listing, category and dealer ids and the totals are the same on every host, but the first pages of the default order put the host country's sellers first (measured 2026-11-22: track excavators, 52/52 rows German sellers on de, 6,250 in total; a newest-first excavator search on eu, 50/50 rows from the UK and Ireland); filter on `country` for one seller country. |
/machineryzone/v1/dealer_listings3 creditsOne dealer's actual stock on MachineryZone, paged — the same row shape as `search`, 50 rows a page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| dealer_id | required | — | The dealer's own numeric id, as `dealers`, `search` and `detail` return it. |
| market = eu | optional | ar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · us | Which MachineryZone national host to read, i.e. the LANGUAGE of the labels and category names: eu = www.machineryzone.eu (English, the default), us = www.machineryzone.com, fr, de, es, it, nl, pl, pt, ro, se, fi, no, cz, hu, lt, rs, in, tr, br, ua, ca_fr (fr.machineryzone.com), ar (es.machineryzone.com). Listing, category and dealer ids and the totals are the same on every host, but the first pages of the default order put the host country's sellers first (measured 2026-11-22: track excavators, 52/52 rows German sellers on de, 6,250 in total; a newest-first excavator search on eu, 50/50 rows from the UK and Ireland); filter on `country` for one seller country. |
| page = 1 | optional | 1–200 | Page of this dealer's stock, 50 rows each; `meta.pagination.last_page` is the source's own last page for that dealer. The cap of 200 is carried over from the search route, where it was measured; the dealer route's own ceiling was not measured, and no dealer in the directory has anything close to 10,000 adverts online, so it has never been reached. |
/machineryzone/v1/price_index2 creditsThe marketplace's own PRICE OBSERVATORY: minimum, maximum and average asking price for a rubric, make, model and year, plus how many listings the figure rests on, in EUR, VAT-excluded. Call it with nothing for the rubric list, with `rubric_id` for its makes, with `rubric_id` + `make_id` for its models, and with `model` + `year` on top for the price band itself. Its ids are its own, not the search ids.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| market = eu | optional | ar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · us | Which MachineryZone national host to read, i.e. the LANGUAGE of the labels and category names: eu = www.machineryzone.eu (English, the default), us = www.machineryzone.com, fr, de, es, it, nl, pl, pt, ro, se, fi, no, cz, hu, lt, rs, in, tr, br, ua, ca_fr (fr.machineryzone.com), ar (es.machineryzone.com). Listing, category and dealer ids and the totals are the same on every host, but the first pages of the default order put the host country's sellers first (measured 2026-11-22: track excavators, 52/52 rows German sellers on de, 6,250 in total; a newest-first excavator search on eu, 50/50 rows from the UK and Ireland); filter on `country` for one seller country. |
| rubric_id | optional | 1– | The price observatory's own rubric id — 304 is Mini digger, 223 Asphalt Pavers, 224 Articulated Dump Truck. NOT the search `category_id` for the same thing (Mini digger is 2302 in search): the observatory keeps its own id space and answers an EMPTY result rather than an error when given the other one. Call this action with no parameters for the rubric list. |
| make_id | optional | 1– | The price observatory's own make id — 3174 is Kubota, 3201 Yanmar, 3049 Caterpillar in the Mini digger rubric. NOT the search facet's manufacturer id. Requires `rubric_id`; with only `rubric_id` this action returns the make list. |
| model | optional | — | The model, as the observatory spells it. Requires `rubric_id` and `make_id`; with only those two this action returns the model list, which is the spelling to use. |
| year | optional | 1900–2100 | Year of construction. With `rubric_id`, `make_id` and `model` this is what turns the call into the actual price band: minimum, maximum and average asking price plus how many listings that figure rests on. |
/machineryzone/v1/locations1 creditThe geography the filters accept: the country list, a country's regions and a region's departments with the ids `search` wants (GB answers England, Northern Ireland, Scotland, Wales).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| market = eu | optional | ar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · us | Which MachineryZone national host to read, i.e. the LANGUAGE of the labels and category names: eu = www.machineryzone.eu (English, the default), us = www.machineryzone.com, fr, de, es, it, nl, pl, pt, ro, se, fi, no, cz, hu, lt, rs, in, tr, br, ua, ca_fr (fr.machineryzone.com), ar (es.machineryzone.com). Listing, category and dealer ids and the totals are the same on every host, but the first pages of the default order put the host country's sellers first (measured 2026-11-22: track excavators, 52/52 rows German sellers on de, 6,250 in total; a newest-first excavator search on eu, 50/50 rows from the UK and Ireland); filter on `country` for one seller country. |
| country | optional | AE · AL · AM · AT · BA · BE · BG · CA · CH · CL · CN · CZ · DE · DK · EE · ES · FR · GB · GR · HR · HU · ID · IE · IT · LT · LU · LV · MD · ME · MK · MU · MX · NL · NO · PA · PH · PL · PT · PY · RO · RS · RU · SE · SI · SK · TH · TW · UA · US | Country, as an ISO-3166-1 alpha-2 code. With no country this action returns the country list itself; with one it returns that country's regions; with `region_id` as well, that region's departments. |
| region_id | optional | 1– | Seller region, by the source's own id, which `locations` publishes for a country. Requires `country`, and the engine checks the id against the source's own live region list for that country before sending it — see the note on `country` for why. |
curl -X POST https://api.reefapi.com/machineryzone/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"excavator","listing_type":"sale","sort":"newest"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.