{ "openapi": "3.0.1", "info": { "title": "Landwirt Scraper: Tractors, Farm Machinery, Ads & Dealers", "description": "Scrape landwirt.com: used, demo and rental tractors and farm machinery with price, year, hours, power, location and photos, plus classified ads and the dealer directory. Filter by brand, country, price and year, monitor new listings. No login. Export JSON, CSV or Excel.", "version": "0.1", "x-build-id": "TjkVYvwtgD0HjZPLk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/recordsdata~landwirt-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-recordsdata-landwirt-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/recordsdata~landwirt-scraper/runs": { "post": { "operationId": "runs-sync-recordsdata-landwirt-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/recordsdata~landwirt-scraper/run-sync": { "post": { "operationId": "run-sync-recordsdata-landwirt-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "What to collect", "enum": [ "search", "urls", "dealers" ], "type": "string", "description": "search = machine and classified listings for the sections and filters below. urls = listing, classified and dealer addresses (or numbers) you provide, always with full detail. dealers = the dealer directory (company profiles).", "default": "search" }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stops after this many rows (all record types together). Free plans are limited to 10 items per run.", "default": 50 }, "sections": { "title": "Sections", "type": "array", "description": "Which parts of the marketplace to read (search mode). Dealer sections are priced as machine records, classified ads as classified records. New machines and auction lots are not covered. Empty means used machines.", "items": { "type": "string", "enum": [ "used-machines", "demo-machines", "rental-machines", "classifieds" ], "enumTitles": [ "Used machines from dealers", "Demonstration machines from dealers", "Rental machines from dealers", "Classified ads (private sellers and small businesses)" ] }, "default": [ "used-machines" ] }, "searchQuery": { "title": "Search words", "type": "string", "description": "Optional. Words searched in the listing title and text, for example \"Fendt 724\" or \"Frontlader\". Empty means every listing of the chosen sections.", "default": "" }, "groups": { "title": "Category groups", "type": "array", "description": "Optional. Keep only listings of these category groups (agricultural machinery, forestry, construction, cars and trucks and so on). Empty means all groups.", "items": { "type": "string", "enum": [ "agricultural-machinery", "forestry", "feed", "livestock", "direct-sales", "contract-work-jobs", "municipal", "construction", "cars-trucks-mopeds", "real-estate", "other" ], "enumTitles": [ "Agricultural machinery (Landtechnik)", "Forestry equipment (Forsttechnik)", "Feed (Futtermittel)", "Livestock market (Tiermarkt)", "Direct sales (Direktvermarktung)", "Contract work and jobs (Lohnarbeit und Jobs)", "Municipal equipment (Kommunaltechnik)", "Construction equipment (Bautechnik)", "Cars, trucks and mopeds (PKW / LKW / Moped)", "Real estate (Realitaetenmarkt)", "Other (Sonstiges)" ] } }, "brands": { "title": "Brands", "type": "array", "description": "Optional. Brand names as the site writes them, for example Fendt, John Deere, Claas or Case IH. Several brands are searched together.", "items": { "type": "string" } }, "model": { "title": "Model", "type": "string", "description": "Optional. Model name or designation, for example \"724 Vario\". Use together with a brand for exact results.", "default": "" }, "countries": { "title": "Countries", "type": "array", "description": "Optional. Keep only listings located in these countries (search mode) or dealers based there (dealers mode). Empty means every country.", "items": { "type": "string", "enum": [ "AT", "DE", "CH", "NL", "PL", "IT", "NO", "HR", "SI", "SK", "DK", "HU", "FR", "SE", "EE", "CZ", "RO", "BE", "LV", "LU", "RS", "BA", "BG", "GR", "IE", "LI", "GB" ], "enumTitles": [ "Austria", "Germany", "Switzerland", "Netherlands", "Poland", "Italy", "Norway", "Croatia", "Slovenia", "Slovakia", "Denmark", "Hungary", "France", "Sweden", "Estonia", "Czechia", "Romania", "Belgium", "Latvia", "Luxembourg", "Serbia", "Bosnia and Herzegovina", "Bulgaria", "Greece", "Ireland", "Liechtenstein", "United Kingdom" ] } }, "states": { "title": "Regions (federal states)", "type": "array", "description": "Optional. Region names or numbers of the site, for example Oberoesterreich or Bayern. Needs exactly one country in \"Countries\". Listings without a region on the site are not returned when this is set.", "items": { "type": "string" } }, "dealerIds": { "title": "Dealer numbers", "type": "array", "description": "Optional. Only machines offered by these dealers (search mode, machine sections). The dealer number is the number at the end of a dealer page address.", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Only listings priced at or above this amount in euros. Listings without a price are not returned when a price limit is set. Leave 0 for no limit." }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Only listings priced at or below this amount in euros. Leave 0 for no limit." }, "minYear": { "title": "Minimum year of build", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Only machines built in or after this year, for example 2015. Leave 0 for no limit." }, "maxYear": { "title": "Maximum year of build", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Only machines built in or before this year. Leave 0 for no limit." }, "minPowerHp": { "title": "Minimum power (hp)", "minimum": 0, "type": "integer", "description": "Only machines with at least this power in horsepower (PS). Leave 0 for no limit." }, "maxPowerHp": { "title": "Maximum power (hp)", "minimum": 0, "type": "integer", "description": "Only machines with at most this power in horsepower (PS). Leave 0 for no limit." }, "minHours": { "title": "Minimum operating hours", "minimum": 0, "type": "integer", "description": "Only machines with at least this many operating hours. Leave 0 for no limit." }, "maxHours": { "title": "Maximum operating hours", "minimum": 0, "type": "integer", "description": "Only machines with at most this many operating hours. Machines that show no hours are not returned when a limit is set. Leave 0 for no limit." }, "onlyWithPrice": { "title": "Only listings with a price", "type": "boolean", "description": "Skip listings that show \"price on request\" or no price.", "default": false }, "onlyWithImages": { "title": "Only listings with photos", "type": "boolean", "description": "Skip listings without any photo.", "default": false }, "onlyWithVideo": { "title": "Only listings with a video", "type": "boolean", "description": "Keep only listings that have a video.", "default": false }, "postedWithin": { "title": "Posted within", "enum": [ "any", "1", "7", "30" ], "type": "string", "description": "Keep only listings created within the last 1, 7 or 30 days. Dealer machine offers carry no creation date on the site, so this works best on classifieds.", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "default", "newest", "price-asc", "price-desc", "year-desc", "power-desc", "hours-asc" ], "type": "string", "description": "Order of the results. Pick a sort when you use a small Maximum items value and want, for example, the cheapest or newest listings first.", "default": "default" }, "startUrls": { "title": "Listing and dealer addresses", "type": "array", "description": "Used in mode \"urls\". Machine listing addresses (https://www.landwirt.com/detail/name-1234567), classified ad addresses (https://www.landwirt.com/kleinanzeigen/detail/name-12345678) and dealer page addresses (https://www.landwirt.com/dealer/info/name-1234).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingIds": { "title": "Listing numbers", "type": "array", "description": "Used in mode \"urls\". Listing numbers (the number at the end of a listing address); machine and classified numbers are recognised automatically.", "items": { "type": "string" } }, "dealerQuery": { "title": "Dealer name search", "type": "string", "description": "Used in mode \"dealers\". Keep only dealers whose name contains these words.", "default": "" }, "dealerPremiumLevel": { "title": "Dealer premium level", "enum": [ "any", "1", "2", "3" ], "type": "string", "description": "Used in mode \"dealers\". Keep only dealers with this premium level of the site (3 is the highest).", "default": "any" }, "fetchDetails": { "title": "Read detail pages", "type": "boolean", "description": "Adds the full text, all photos, equipment, specifications, dealer rating and exact location of each listing (and opening hours, branches and services of each dealer). Billed as the detail record events.", "default": false }, "includeContactDetails": { "title": "Include dealer contact details", "type": "boolean", "description": "Adds the dealer company phone exactly as the site publishes it. Private sellers and contact persons are never output.", "default": false }, "includeRaw": { "title": "Include raw data", "type": "boolean", "description": "Adds a \"raw\" field with the unprocessed answers of the site (large rows).", "default": false }, "onlyNew": { "title": "Only new listings (monitor mode)", "type": "boolean", "description": "Return only records that earlier runs with the same inputs have not delivered yet. Seen records are remembered in a key-value store of your account and are not charged again. Use a bounded search (a dealer, a country, \"posted within\") for scheduled monitoring.", "default": false }, "stateKey": { "title": "Monitor label", "type": "string", "description": "Optional name to keep several monitors with the same inputs apart.", "default": "" }, "resetSeen": { "title": "Reset monitor memory", "type": "boolean", "description": "Forget everything this monitor has seen and start again.", "default": false }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 4, "type": "integer", "description": "How many detail requests run at once. The Actor always keeps its overall pace to about 3 requests per second.", "default": 2 }, "maxScanSeconds": { "title": "Time limit (seconds)", "minimum": 10, "maximum": 86400, "type": "integer", "description": "Stops reading new pages after this many seconds and finishes with what was collected.", "default": 3000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }