{ "openapi": "3.0.1", "info": { "title": "Patiotuerca Scraper - Ecuador Used Cars & Dealer Phones", "description": "Scrape used cars, motorcycles, trucks and machinery from Patiotuerca, Ecuador's top car marketplace. Get price, discounts, km, year, specs, city and photos, plus seller phone, WhatsApp, dealer and equipment. Filter by brand, model, province, city, price, year, km, fuel and more.", "version": "1.0", "x-build-id": "wak7D8r2QGsdSpg05" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~patiotuerca-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-patiotuerca-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/normdata~patiotuerca-scraper/runs": { "post": { "operationId": "runs-sync-normdata-patiotuerca-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/normdata~patiotuerca-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-patiotuerca-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": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many vehicles in total. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "vehicleTypes": { "title": "Vehicle types", "type": "array", "description": "Empty = every type.", "items": { "type": "string", "enum": [ "cars", "motorcycles", "trucks", "machinery", "boats", "bicycles", "other" ], "enumTitles": [ "Cars", "Motorcycles", "Trucks and buses", "Heavy machinery", "Boats and jet skis", "Bicycles", "Other (trailers, campers, golf carts)" ] } }, "sortBy": { "title": "Sort by", "enum": [ "ultimos-publicados", "recomendado", "menor-precio", "mayor-precio", "menor-kilometraje", "mayor-kilometraje", "mas-reciente", "menos-reciente", "mas-visto" ], "type": "string", "description": "The order the site lists them in. Empty = newest listings." }, "searchTerms": { "title": "Search words", "type": "array", "description": "Keep only vehicles whose name has every word of one of these, like \"hilux 4x4\" or \"rav4 hybrid\". Matches brand, model, year, body, city and color.", "items": { "type": "string" } }, "brands": { "title": "Brands", "type": "array", "description": "Only these brands, like \"Toyota\", \"Chevrolet\" or \"Kia\". Empty = every brand.", "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Only these models, like \"Hilux\", \"Sportage\" or \"D-Max\". \"Hilux\" also finds \"Hilux CD 4x4 Diesel\" and \"New Hilux SR\". Empty = every model.", "items": { "type": "string" } }, "provinces": { "title": "Provinces", "type": "array", "description": "Only vehicles in these provinces. Empty = all of Ecuador.", "items": { "type": "string", "enum": [ "Pichincha", "Guayas", "Azuay", "Tungurahua", "Manabí", "Imbabura", "Loja", "Santo Domingo de los Tsachilas", "Cotopaxi", "El Oro", "Chimborazo", "Los Rios", "Cañar", "Esmeraldas", "Santa Elena", "Bolivar", "Sucumbios", "Morona Santiago", "Orellana", "Pastaza", "Napo", "Carchi", "Zamora Chinchipe", "Galápagos" ], "enumTitles": [ "Pichincha", "Guayas", "Azuay", "Tungurahua", "Manabí", "Imbabura", "Loja", "Santo Domingo de los Tsachilas", "Cotopaxi", "El Oro", "Chimborazo", "Los Rios", "Cañar", "Esmeraldas", "Santa Elena", "Bolivar", "Sucumbios", "Morona Santiago", "Orellana", "Pastaza", "Napo", "Carchi", "Zamora Chinchipe", "Galápagos" ] } }, "cities": { "title": "Cities", "type": "array", "description": "Only vehicles in these cities, like \"Quito\", \"Guayaquil\", \"Cuenca\" or \"Cumbayá\".", "items": { "type": "string" } }, "includeDetails": { "title": "Vehicle details (seller phone, WhatsApp, dealer, specs, equipment)", "type": "boolean", "description": "Also read each vehicle page for the seller phone and WhatsApp, seller type, dealer name, rating and logo, fuel, drive, engine, A/C, windows, steering, upholstery, plate hints, province, description, equipment, extras, promotions and every full-size photo. Charged per vehicle as an add-on." }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Asking price in US dollars." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Asking price in US dollars." }, "minYear": { "title": "From year", "minimum": 0, "type": "integer", "description": "Model year, like 2018." }, "maxYear": { "title": "To year", "minimum": 0, "type": "integer", "description": "Model year, like 2024." }, "minMileage": { "title": "Minimum km", "minimum": 0, "type": "integer", "description": "Kilometers driven." }, "maxMileage": { "title": "Maximum km", "minimum": 0, "type": "integer", "description": "Kilometers driven, like 80000. 0 = new or unused." }, "fuels": { "title": "Fuel", "type": "array", "description": "Keep only these fuels.", "items": { "type": "string", "enum": [ "Gasolina", "Diesel", "Híbrido", "Eléctrico", "4T", "2T", "Gasolina / Gas LGP" ], "enumTitles": [ "Gasoline", "Diesel", "Hybrid", "Electric", "4-stroke (motorcycles)", "2-stroke (motorcycles)", "Gasoline / LPG" ] } }, "transmissions": { "title": "Transmission", "type": "array", "description": "Keep only these transmissions.", "items": { "type": "string", "enum": [ "Automática", "Manual", "Tiptronic", "CVT", "StepTronic", "7G-tronic", "9G-Tronic", "SpeedTronic", "Secuencial", "DSG", "Multitronic", "ECVT", "4G Matic", "6 velocidades", "5 velocidades", "4 velocidades", "3 velocidades" ], "enumTitles": [ "Automatic", "Manual", "Tiptronic", "CVT", "StepTronic", "7G-tronic", "9G-Tronic", "SpeedTronic", "Sequential", "DSG", "Multitronic", "ECVT", "4G Matic", "6-speed (motorcycles)", "5-speed (motorcycles)", "4-speed (motorcycles)", "3-speed (motorcycles)" ] } }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Keep only these body types.", "items": { "type": "string", "enum": [ "Todoterreno", "SUV", "Sedán", "Camioneta Doble Cabina", "Camioneta Cabina Simple", "Camioneta Cabina y Media", "Hatchback (5 Puertas)", "Hatchback (3 Puertas)", "Crossover", "Coupé", "Todoterreno Ligero", "Van", "Mini van (MPV)", "Van Pasajeros", "Van de Carga", "Convertible", "Station Wagon", "Utilitario", "Furgoneta", "Buggy", "Sport", "Doble Propósito", "Paseo", "Adventure", "Scooter", "Motocross", "Cuadrón", "Naked", "Enduro", "Cruiser", "Touring", "Camión Ligero (0 a 3 ton)", "Camión Pequeño (3 a 6 ton)", "Camión Mediano (6 a 15 ton)", "Camión Grande (más de 15 ton)", "Cabezal", "Volqueta", "Autobús", "Excavadora", "Retroexcavadora", "Minicargadora", "Montacarga", "Bote", "Yate", "Lancha", "Moto de Agua", "Remolque", "Otro" ], "enumTitles": [ "Off-road / SUV (Todoterreno)", "SUV", "Sedan", "Pickup, double cab", "Pickup, single cab", "Pickup, extended cab", "Hatchback, 5 doors", "Hatchback, 3 doors", "Crossover", "Coupe", "Light off-road", "Van", "Minivan (MPV)", "Passenger van", "Cargo van", "Convertible", "Station wagon", "Utility", "Panel van", "Buggy", "Motorcycle: Sport", "Motorcycle: Dual purpose", "Motorcycle: Street", "Motorcycle: Adventure", "Motorcycle: Scooter", "Motorcycle: Motocross", "Motorcycle: Quad", "Motorcycle: Naked", "Motorcycle: Enduro", "Motorcycle: Cruiser", "Motorcycle: Touring", "Truck: light (0 to 3 t)", "Truck: small (3 to 6 t)", "Truck: medium (6 to 15 t)", "Truck: large (over 15 t)", "Truck: tractor unit", "Truck: dump truck", "Bus", "Machinery: Excavator", "Machinery: Backhoe", "Machinery: Skid steer", "Machinery: Forklift", "Boat", "Yacht", "Motorboat", "Jet ski", "Trailer", "Other" ] } }, "colors": { "title": "Color", "type": "array", "description": "Keep only these colors.", "items": { "type": "string", "enum": [ "Blanco", "Plata", "Plomo", "Negro", "Rojo", "Azul", "Gris", "Vino", "Verde", "Dorado", "Crema", "Café", "Beige", "Celeste", "Naranja", "Amarillo", "Cobre", "Morado", "Perla", "Bronce", "Turquesa" ], "enumTitles": [ "White", "Silver", "Lead grey (Plomo)", "Black", "Red", "Blue", "Grey", "Wine", "Green", "Gold", "Cream", "Brown", "Beige", "Light blue", "Orange", "Yellow", "Copper", "Purple", "Pearl", "Bronze", "Turquoise" ] } }, "drives": { "title": "Drive", "type": "array", "description": "Keep only these drive types.", "items": { "type": "string", "enum": [ "4 x 2", "4 x 4", "AWD", "6 x 4" ], "enumTitles": [ "4x2", "4x4", "AWD", "6x4 (trucks)" ] } }, "sellerType": { "title": "Seller", "enum": [ "dealer", "private" ], "type": "string", "description": "Dealers or private sellers. Empty = both." }, "onlyOnPromotion": { "title": "Only on promotion", "type": "boolean", "description": "Keep only vehicles in a site promotion (a sale price until a set date)." }, "onlyDiscounted": { "title": "Only discounted", "type": "boolean", "description": "Keep only vehicles with any price cut: promotions and lowered prices (the old price is in originalPrice). Checks every listing, so it takes a few minutes." }, "onlyNew": { "title": "Only new vehicles", "type": "boolean", "description": "Skip vehicles saved by earlier runs with the same monitor name." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share their history. Use a different name for each schedule." }, "startUrls": { "title": "Links", "type": "array", "description": "Vehicle pages (https://ecuador.patiotuerca.com/vehicle/autos-changan-uni-t-quito-2023/1961665) or search results pages with any filters you set on the site, like https://ecuador.patiotuerca.com/usados/pichincha-quito/autos/-/toyota/fortuner?year_min=2020.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }