{ "openapi": "3.0.1", "info": { "title": "SuperCarros Scraper - Dominican Republic Cars & Dealer Leads", "description": "Scrape cars, motorcycles, boats and trucks from SuperCarros.com, the top car marketplace of the Dominican Republic. Get price, year, km, specs and photos, plus seller phones, WhatsApp, email and address. Filter by brand, model, province, price, year, km, fuel, body and more.", "version": "1.0", "x-build-id": "N5sQLja6heYou4xiS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~supercarros-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-supercarros-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~supercarros-scraper/runs": { "post": { "operationId": "runs-sync-normdata-supercarros-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~supercarros-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-supercarros-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", "boats", "heavy", "other" ], "enumTitles": [ "Cars", "Motorcycles and ATVs", "Boats and jet skis", "Trucks, buses and machinery", "Other (golf carts, buggies, generators, campers)" ] } }, "sortBy": { "title": "Sort by", "enum": [ "default", "price-asc", "price-desc", "year-desc", "year-asc" ], "type": "string", "description": "The order the site lists them in. Searches over 1,000 results are read in parts, so the order holds inside each part." }, "brands": { "title": "Brands", "type": "array", "description": "Only these brands, like \"Toyota\", \"Hyundai\" or \"Mercedes\". Empty = every brand.", "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Only these models, like \"Corolla\", \"CR-V\" or \"Toyota Hilux\". Works with or without brands. Empty = every model.", "items": { "type": "string" } }, "searchTerms": { "title": "Search words", "type": "array", "description": "Keep only vehicles whose title has every word of one of these, like \"hilux 4x4\" or \"sport hybrid\".", "items": { "type": "string" } }, "includeDetails": { "title": "Vehicle details (seller phones, WhatsApp, email, address, specs)", "type": "boolean", "description": "Also read each vehicle page for the seller name and type, every phone and WhatsApp number, email, contact person, address and map location, dealer page, plus body, engine, colors, transmission, drive, doors, seats, price in pesos, views, description, equipment and video. Charged per vehicle as an add-on." }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Keep only these body types.", "items": { "type": "string", "enum": [ "Coupé/Deportivo", "Sedán", "Hatchback", "Furgoneta", "StationWagon", "MiniVán", "Convertible", "Jeepeta", "Jeep", "Camioneta", "Coupé", "Four Wheel", "Motocicleta", "Pasola", "Bote", "JetSki", "Autobús", "Camión", "Pala Mecánica", "Tractor", "Grua", "Rodillo", "Monta Carga", "Retroexcavadora", "Iluminadora", "Retropala", "Afartadora", "Pala", "Volteo", "Minibus", "Minitruck (Camioncito)", "Excavadora", "Camión de Basura", "Planta Electrica", "Buggy", "Carro de Golf", "Desmoledora", "Casa Rodante" ], "enumTitles": [ "Coupe / sports car", "Sedan", "Hatchback", "Panel van", "Station wagon", "Minivan", "Convertible", "SUV (Jeepeta)", "Jeep", "Pickup (Camioneta)", "Coupe", "Motorcycles: ATV / UTV (Four Wheel)", "Motorcycles: Motorcycle", "Motorcycles: Scooter (Pasola)", "Boats: Boat", "Boats: Jet ski", "Heavy: Bus", "Heavy: Truck", "Heavy: Power shovel", "Heavy: Tractor", "Heavy: Crane / tow truck", "Heavy: Road roller", "Heavy: Forklift", "Heavy: Backhoe", "Heavy: Light tower", "Heavy: Backhoe loader", "Heavy: Afartadora", "Heavy: Loader", "Heavy: Dump truck", "Heavy: Minibus", "Heavy: Mini truck", "Heavy: Excavator", "Heavy: Garbage truck", "Other: Generator", "Other: Buggy", "Other: Golf cart", "Other: Demolition machine", "Other: Camper" ] } }, "condition": { "title": "Condition", "enum": [ "new", "used" ], "type": "string", "description": "New or used. Empty = both." }, "sellerType": { "title": "Seller", "enum": [ "dealer", "private" ], "type": "string", "description": "Dealers or private sellers. Empty = both." }, "provinces": { "title": "Provinces", "type": "array", "description": "Only vehicles in these provinces or areas. Empty = the whole country.", "items": { "type": "string", "enum": [ "Azua", "Bani", "Barahona", "Bonao", "Dajabon", "Distrito Nacional", "Duarte", "El Seibo", "Espaillat", "Hato Mayor", "Hermanas Mirabal", "Higuey", "Jarabacoa", "La Romana", "La Vega", "Maria Trinidad Sanchez", "Monseñor Nouel", "Monte Cristi", "Monte Plata", "Puerto Plata", "Samana", "San Cristobal", "San Jose De Ocoa", "San Juan de la Maguana", "San Pedro de Macoris", "Sanchez Ramirez", "Santiago", "Santiago Rodriguez", "Santo Domingo Este", "Santo Domingo Norte", "Santo Domingo Oeste", "Valverde Mao" ], "enumTitles": [ "Azua", "Bani", "Barahona", "Bonao", "Dajabon", "Distrito Nacional", "Duarte", "El Seibo", "Espaillat", "Hato Mayor", "Hermanas Mirabal", "Higuey", "Jarabacoa", "La Romana", "La Vega", "Maria Trinidad Sanchez", "Monseñor Nouel", "Monte Cristi", "Monte Plata", "Puerto Plata", "Samana", "San Cristobal", "San Jose De Ocoa", "San Juan de la Maguana", "San Pedro de Macoris", "Sanchez Ramirez", "Santiago", "Santiago Rodriguez", "Santo Domingo Este", "Santo Domingo Norte", "Santo Domingo Oeste", "Valverde Mao" ] } }, "currency": { "title": "Price currency", "enum": [ "USD", "DOP" ], "type": "string", "description": "Only vehicles priced in this currency. The price filters below use it too (US dollars when empty)." }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "In the price currency above." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "In the price currency above." }, "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 mileage", "minimum": 0, "type": "integer", "description": "Distance driven, as the seller wrote it (km or miles)." }, "maxMileage": { "title": "Maximum mileage", "minimum": 0, "type": "integer", "description": "Distance driven, as the seller wrote it (km or miles). New vehicles with no mileage are included." }, "fuels": { "title": "Fuel", "type": "array", "description": "Keep only these fuels.", "items": { "type": "string", "enum": [ "gasoline", "diesel", "lpg", "electric", "hybrid" ], "enumTitles": [ "Gasoline", "Diesel", "LPG (GLP)", "Electric", "Hybrid" ] } }, "transmissions": { "title": "Transmission", "type": "array", "description": "Keep only these transmissions.", "items": { "type": "string", "enum": [ "Automática", "Mecánica", "Sincronizada", "Semiautomática", "Mecánica o Automática" ], "enumTitles": [ "Automatic", "Manual", "Synchronized manual", "Semi-automatic", "Manual or automatic" ] } }, "drives": { "title": "Drive", "type": "array", "description": "Keep only these drive types.", "items": { "type": "string", "enum": [ "Delantera", "Trasera", "2WD", "4WD", "4WD Full Time", "AWD", "6x4" ], "enumTitles": [ "Front-wheel", "Rear-wheel", "2WD", "4WD", "4WD full time", "AWD", "6x4 (trucks)" ] } }, "cylinders": { "title": "Cylinders", "type": "array", "description": "Keep only engines with this many cylinders.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "8", "10", "12" ], "enumTitles": [ "1 cylinder", "2 cylinders", "3 cylinders", "4 cylinders", "5 cylinders", "6 cylinders", "8 cylinders", "10 cylinders", "12 cylinders" ] } }, "colors": { "title": "Exterior color", "type": "array", "description": "Keep only these colors.", "items": { "type": "string", "enum": [ "Amarillo", "Azul", "Azul Agua", "Azul Cielo", "Azul claro", "Azul Marino", "Azul/Grís", "Beige", "Blanco", "Blanco perla", "Bronce", "Champang", "Crema", "Dorado", "Gris", "Gris oscuro", "Gris Plata", "Ladrillo", "Marrón", "Morado", "Morado/Gris", "Naranja", "Negro", "Negro/Crema", "Negro/Gris", "Negro/Rojo", "Plata", "Rojo", "Rojo Esacarlata", "Rojo Vino", "Rojo/Dorado", "Rosado", "Silver", "Terracota", "Verde", "Verde/Gris", "Vino" ], "enumTitles": [ "Yellow", "Blue", "Azul Agua", "Azul Cielo", "Azul claro", "Azul Marino", "Azul/Grís", "Beige", "White", "Blanco perla", "Bronze", "Champang", "Cream", "Gold", "Grey", "Gris oscuro", "Gris Plata", "Ladrillo", "Brown", "Purple", "Morado/Gris", "Orange", "Black", "Negro/Crema", "Negro/Gris", "Negro/Rojo", "Silver (Plata)", "Red", "Rojo Esacarlata", "Rojo Vino", "Rojo/Dorado", "Pink", "Silver", "Terracota", "Green", "Verde/Gris", "Wine" ] } }, "equipment": { "title": "Equipment", "type": "array", "description": "Keep only vehicles with all of these.", "items": { "type": "string", "enum": [ "thirdRow", "powerTrunk", "leatherSeats", "sunroof", "panoramicRoof", "smartKey", "multimediaRadio", "xenonLights", "navigation", "reverseCamera" ], "enumTitles": [ "Third row of seats", "Power trunk", "Leather seats", "Sunroof", "Panoramic roof", "Smart key / push start", "Multimedia radio", "Halogen / xenon lights", "Navigation", "Reverse camera" ] } }, "onlyElectric": { "title": "Only electric", "type": "boolean", "description": "Keep only electric vehicles (the site's Eléctricos section)." }, "onlyWithVideo": { "title": "Only with video", "type": "boolean", "description": "Keep only listings that have a video." }, "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://www.supercarros.com/toyota-corolla/1640451/) or search results pages with any filters you set on the site, like https://www.supercarros.com/carros/jeepeta/santiago/toyota/.", "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 } } } } } } } } } }