Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the MachineryZone API page →
docs / machineryzone

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.

base /machineryzone/v110 endpoints
post/machineryzone/v1/detail3 credits

One 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.

ParameterAllowed / rangeDescription
listing_idrequired—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 = euoptionalar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · usWhich 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.
Try in playground →
post/machineryzone/v1/categories3 credits

MachineryZone'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.

ParameterAllowed / rangeDescription
market = euoptionalar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · usWhich 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.
Try in playground →
post/machineryzone/v1/facets3 credits

The 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.

ParameterAllowed / rangeDescription
market = euoptionalar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · usWhich 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.
queryoptional—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.
keywordoptional—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_idoptional1–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_typeoptionalsale · wanted · auction · rentalWhat 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.
countryoptionalAE · 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 · USSeller 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.
Try in playground →
post/machineryzone/v1/suggest1 credit

MachineryZone's own autocomplete for a typed prefix: whole search phrases, and categories with their numeric ids and live counts.

ParameterAllowed / rangeDescription
queryrequired—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 = euoptionalar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · usWhich 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.
Try in playground →
post/machineryzone/v1/dealers3 credits

The 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.

ParameterAllowed / rangeDescription
market = euoptionalar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · usWhich 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.
companyoptional—Filter the dealer directory by company name (the source's own `all_company` field).
countryoptionalAE · 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 · USSeller 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 = 1optional1–400Directory page, 50 dealers each.
sort = nameoptionalname · name_desc · listings_asc · listings_desc · defaultDirectory 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.
Try in playground →
post/machineryzone/v1/dealer3 credits

One 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.

ParameterAllowed / rangeDescription
dealer_idrequired—The dealer's own numeric id, as `dealers`, `search` and `detail` return it.
market = euoptionalar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · usWhich 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.
Try in playground →
post/machineryzone/v1/dealer_listings3 credits

One dealer's actual stock on MachineryZone, paged — the same row shape as `search`, 50 rows a page.

ParameterAllowed / rangeDescription
dealer_idrequired—The dealer's own numeric id, as `dealers`, `search` and `detail` return it.
market = euoptionalar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · usWhich 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 = 1optional1–200Page 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.
Try in playground →
post/machineryzone/v1/price_index2 credits

The 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.

ParameterAllowed / rangeDescription
market = euoptionalar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · usWhich 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_idoptional1–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_idoptional1–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.
modeloptional—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.
yearoptional1900–2100Year 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.
Try in playground →
post/machineryzone/v1/locations1 credit

The 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).

ParameterAllowed / rangeDescription
market = euoptionalar · br · ca_fr · cz · de · es · eu · fi · fr · hu · in · it · lt · nl · no · pl · pt · ro · rs · se · tr · ua · usWhich 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.
countryoptionalAE · 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 · USCountry, 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_idoptional1–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.
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.