{
"openapi": "3.0.1",
"info": {
"title": "John Deere Spain — Products & Specs Scraper",
"description": "Extracts product listings and technical specifications from the John Deere Spain website (deere.es). Supports filtering by series and leveling configuration.",
"version": "0.1",
"x-build-id": "RlZc3J6dqRpDtC6gV"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/rastriq~john-deere-es-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-rastriq-john-deere-es-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/rastriq~john-deere-es-scraper/runs": {
"post": {
"operationId": "runs-sync-rastriq-john-deere-es-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/rastriq~john-deere-es-scraper/run-sync": {
"post": {
"operationId": "run-sync-rastriq-john-deere-es-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": {
"market": {
"title": "🌍 Market",
"enum": [
"at",
"de",
"es",
"fi",
"fr",
"gb",
"it",
"nl",
"no",
"pl",
"pt",
"se",
"us"
],
"type": "string",
"description": "John Deere website to scrape. Each market uses its own domain and returns data in its local language — product titles, specs labels, and filter values are all localized. The underlying product catalog is global (same models, same counts across all 13 markets).",
"default": "es"
},
"category": {
"title": "🏗️ Categoría de producto",
"enum": [
"front-end-loaders",
"tractors",
"compact-tractors",
"combines",
"balers",
"mowers",
"drills",
"seeding-equipment",
"gator-utility-vehicles",
"forwarders"
],
"type": "string",
"description": "Categoría a extraer. Todas confirmadas en ES; disponibles en los 16 mercados con la misma estructura de API.",
"default": "front-end-loaders"
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Maximum number of products to extract. Default is 20 — use the prefilled value of 5 for a quick first test.
Leave empty to use the default (20), or increase it to extract more products from the category.",
"default": 20
},
"shopBySeries": {
"title": "🏷️ Series de equipo",
"type": "array",
"description": "Filtra por serie de tractores/cargadores. El actor busca automáticamente la etiqueta correcta en el idioma del mercado seleccionado — no necesitas saber cómo se llama en alemán, francés, etc.
Deja vacío para extraer todas las series.",
"items": {
"type": "string",
"enum": [
"R",
"M",
"E",
"H",
"compact"
],
"enumTitles": [
"Serie R — alta potencia (100-400 CV)",
"Serie M — media potencia (65-130 CV)",
"Serie E — entrada de gama / económica",
"Serie H — especializada",
"Tractores compactos / Kompakt"
]
}
},
"levelingType": {
"title": "⚙️ Tipo de nivelación",
"type": "array",
"description": "Filtra por sistema de nivelación del cargador frontal. El actor localiza el valor exacto en el idioma del mercado vía la API.
Deja vacío para incluir todos los tipos.",
"items": {
"type": "string",
"enum": [
"MSL_mechanical",
"MSL_auto",
"NSL"
],
"enumTitles": [
"Nivelación mecánica (MSL) — sin electrónica",
"Nivelación automática (AutoMSL) — electrónica",
"Sin nivelación (NSL)"
]
}
},
"includeSpecifications": {
"title": "Include technical specifications",
"type": "boolean",
"description": "If enabled, each product is enriched with its full technical spec sheet.
Disabling this roughly halves the run time and number of API calls.",
"default": true
},
"minLiftHeight": {
"title": "Min. lift height (mm)",
"minimum": 0,
"maximum": 10000,
"type": "integer",
"description": "Minimum loader maximum lift height at max tilt cylinder (AMTC). Leave empty for no lower bound."
},
"maxLiftHeight": {
"title": "Max. lift height (mm)",
"minimum": 0,
"maximum": 10000,
"type": "integer",
"description": "Maximum loader maximum lift height at max tilt cylinder (AMTC). Leave empty for no upper bound."
},
"minLiftCapacity": {
"title": "Min. lift capacity (kg)",
"minimum": 0,
"type": "integer",
"description": "Minimum loader lift capacity at maximum height. Leave empty for no lower bound.
⚠️ Only models that have this field indexed as a filterable facet will be filtered at API level — others may still appear in results."
},
"maxLiftCapacity": {
"title": "Max. lift capacity (kg)",
"minimum": 0,
"type": "integer",
"description": "Maximum loader lift capacity at maximum height. Leave empty for no upper bound."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Select proxies for the scraping run. Apify Proxy recommended if you encounter blocking."
},
"shopByFilterRaw": {
"title": "🏷️ Series — valores exactos (override)",
"type": "array",
"description": "Override avanzado: introduce los valores de serie exactamente como los devuelve la API del mercado (p.ej. Serie R en ES, R-Serie en DE). Usa Discover filters para obtener los valores. Si está relleno, tiene prioridad sobre «Series de equipo».",
"items": {
"type": "string"
}
},
"levelingFilterRaw": {
"title": "⚙️ Nivelación — valores exactos (override)",
"type": "array",
"description": "Override avanzado: valores exactos del checkbox de nivelación tal y como los devuelve la API. Tiene prioridad sobre «Tipo de nivelación» si está relleno.",
"items": {
"type": "string"
}
},
"discoverFilters": {
"title": "🔍 Discover filters (instead of scraping)",
"type": "boolean",
"description": "When enabled, the actor outputs the available filter values for the selected market and category instead of scraping products. Use this to find out which series names, leveling options, and slider ranges exist in your target language before running a full scrape.",
"default": false
},
"specSchemaId": {
"title": "Spec schema ID",
"type": "string",
"description": "432824 confirmed for Spain; used as default for all markets. Only change if technical specifications are not loading — inspect the network requests on the product page of your target market to find the correct value."
},
"debugMode": {
"title": "Debug mode",
"type": "boolean",
"description": "Enable verbose logging for troubleshooting.",
"default": false
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}