{ "openapi": "3.0.1", "info": { "title": "CRautos Scraper - Costa Rica Used Cars & Seller Phones", "description": "Scrape every used and new car on CRautos.com, the top car marketplace of Costa Rica. Get price in colones and US$, year, specs, plate digit and photos, plus km, seller name, phones, WhatsApp, address and equipment. Filter by brand, model, body, fuel, province, year and price.", "version": "1.0", "x-build-id": "i0E9bSFjTu4nceLfK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~crautos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-crautos-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~crautos-scraper/runs": { "post": { "operationId": "runs-sync-normdata-crautos-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~crautos-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-crautos-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." }, "brands": { "title": "Brands", "type": "array", "description": "Only these brands. Empty = every brand.", "items": { "type": "string", "enum": [ "Acura", "Aion", "Alfa Romeo", "AMC", "Aro", "Asia", "Aston Martin", "Audi", "Austin", "BAIC", "Baw", "Bentley", "Bluebird", "BMW", "Brilliance", "Buick", "BYD", "Cadillac", "Chana", "Changan", "Chery", "Chevrolet", "Chrysler", "Citroen", "CMC", "Dacia", "Daewoo", "Daihatsu", "Datsun", "Dodge/RAM", "Donfeng (ZNA)", "Eagle", "Faw", "Ferrari", "Fiat", "Ford", "Foton", "Freightliner", "Geely", "Genesis", "Geo", "GMC", "Gonow", "Great Wall", "Hafei", "Haima", "Haval", "Heibao", "Higer", "Hino", "Honda", "Hummer", "Hycan", "Hyundai", "Infiniti", "International", "Isuzu", "Iveco", "JAC", "Jaecoo", "Jaguar", "Jeep", "Jetour", "Jinbei", "JMC", "Jonway", "Kaiyi", "Kenworth", "Kia", "Lada", "Lamborghini", "Lancia", "Land Rover", "Lexus", "Lifan", "Lincoln", "Lotus", "Mack", "Magiruz", "Mahindra", "Marcopolo", "Maserati", "Maxus", "Mazda", "Mercedes Benz", "Mercury", "MG", "Mini", "Mitsubishi", "Neta", "Nissan", "Oldsmobile", "Omoda", "Opel", "Peterbilt", "Peugeot", "Piaggio", "Plymouth", "Polarsun", "Pontiac", "Porsche", "Proton", "Rambler", "Renault", "Reva", "Rivian", "Rolls Royce", "Rover", "Saab", "Samsung", "Saturn", "Scania", "Scion", "Seat", "Shineray", "Skoda", "Smart", "Soueast", "Ssang Yong", "Subaru", "Suzuki", "Tesla", "Tianma", "Tiger Truck", "Toyota", "VGV", "Volkswagen", "Volvo", "Western Star", "Xiaomi", "Xpeng", "Yugo", "Zap", "Zeekr", "Zotye" ], "enumTitles": [ "Acura", "Aion", "Alfa Romeo", "AMC", "Aro", "Asia", "Aston Martin", "Audi", "Austin", "BAIC", "Baw", "Bentley", "Bluebird", "BMW", "Brilliance", "Buick", "BYD", "Cadillac", "Chana", "Changan", "Chery", "Chevrolet", "Chrysler", "Citroen", "CMC", "Dacia", "Daewoo", "Daihatsu", "Datsun", "Dodge/RAM", "Donfeng (ZNA)", "Eagle", "Faw", "Ferrari", "Fiat", "Ford", "Foton", "Freightliner", "Geely", "Genesis", "Geo", "GMC", "Gonow", "Great Wall", "Hafei", "Haima", "Haval", "Heibao", "Higer", "Hino", "Honda", "Hummer", "Hycan", "Hyundai", "Infiniti", "International", "Isuzu", "Iveco", "JAC", "Jaecoo", "Jaguar", "Jeep", "Jetour", "Jinbei", "JMC", "Jonway", "Kaiyi", "Kenworth", "Kia", "Lada", "Lamborghini", "Lancia", "Land Rover", "Lexus", "Lifan", "Lincoln", "Lotus", "Mack", "Magiruz", "Mahindra", "Marcopolo", "Maserati", "Maxus", "Mazda", "Mercedes Benz", "Mercury", "MG", "Mini", "Mitsubishi", "Neta", "Nissan", "Oldsmobile", "Omoda", "Opel", "Peterbilt", "Peugeot", "Piaggio", "Plymouth", "Polarsun", "Pontiac", "Porsche", "Proton", "Rambler", "Renault", "Reva", "Rivian", "Rolls Royce", "Rover", "Saab", "Samsung", "Saturn", "Scania", "Scion", "Seat", "Shineray", "Skoda", "Smart", "Soueast", "Ssang Yong", "Subaru", "Suzuki", "Tesla", "Tianma", "Tiger Truck", "Toyota", "VGV", "Volkswagen", "Volvo", "Western Star", "Xiaomi", "Xpeng", "Yugo", "Zap", "Zeekr", "Zotye" ] } }, "models": { "title": "Models", "type": "array", "description": "Only models whose name has this text, like \"Corolla\", \"RAV4\" or \"Cross\" (finds Corolla Cross and Yaris Cross). Up to 30 letters each.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "price-asc", "year-asc", "brand", "model" ], "type": "string", "description": "The order the site lists them in. Featured listings come first, as on the site." }, "includeDetails": { "title": "Vehicle details (km, seller phones, WhatsApp, address, equipment)", "type": "boolean", "description": "Also read each vehicle page for mileage, condition, doors, taxes paid, negotiable price, trade-in, date listed, views and favorites, plus the seller name and type, every phone, WhatsApp, address, dealer page, every photo and the equipment list. Charged per vehicle as an add-on." }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Keep only these body types.", "items": { "type": "string", "enum": [ "Sedán", "Station Wagon", "Hatchback", "Pick Up 2WD", "Pick Up 4WD", "Pánel", "Microbús/Minivan", "SUV 2WD", "SUV 4WD/AWD", "Casa Rodante", "Comercial 1.0-3.5 Ton.", "Comercial 4.0-4.5 Ton.", "Comercial 5.0-7.5 Ton.", "Comercial 8.0-9.5 Ton.", "Comercial 10.0+ Ton." ], "enumTitles": [ "Sedan", "Station Wagon", "Hatchback", "Pick Up 2WD", "Pick Up 4WD", "Panel van", "Minibus / minivan", "SUV 2WD", "SUV 4WD/AWD", "Camper (Casa Rodante)", "Commercial 1.0 to 3.5 t", "Commercial 4.0 to 4.5 t", "Commercial 5.0 to 7.5 t", "Commercial 8.0 to 9.5 t", "Commercial 10 t or more" ] } }, "fuels": { "title": "Fuel", "type": "array", "description": "Keep only these fuels.", "items": { "type": "string", "enum": [ "Gasolina", "Diesel", "Híbrido", "Eléctrico" ], "enumTitles": [ "Gasoline", "Diesel", "Hybrid", "Electric" ] } }, "transmissions": { "title": "Transmission", "type": "array", "description": "Keep only these transmissions.", "items": { "type": "string", "enum": [ "Manual", "Automática" ], "enumTitles": [ "Manual", "Automatic" ] } }, "provinces": { "title": "Provinces", "type": "array", "description": "Only vehicles in these provinces. Empty = the whole country.", "items": { "type": "string", "enum": [ "Alajuela", "Cartago", "Guanacaste", "Heredia", "Limón", "Puntarenas", "San José" ], "enumTitles": [ "Alajuela", "Cartago", "Guanacaste", "Heredia", "Limón", "Puntarenas", "San José" ] } }, "doors": { "title": "Doors", "enum": [ "2-3", "4+" ], "type": "string", "description": "Empty = any." }, "minYear": { "title": "From year", "minimum": 0, "type": "integer", "description": "Model year, like 2018 (the site lists 1960 and later)." }, "maxYear": { "title": "To year", "minimum": 0, "type": "integer", "description": "Model year, like 2024." }, "priceCurrency": { "title": "Price filter currency", "enum": [ "CRC", "USD" ], "type": "string", "description": "The currency of the minimum and maximum price below. Vehicles priced in the other currency are compared at the site's own exchange rate." }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "In the currency above (colones when empty)." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "In the currency above (colones when empty)." }, "onlyUsed": { "title": "Only used", "type": "boolean", "description": "Leave out new vehicles (the site lists both by default)." }, "onlyWithFinancing": { "title": "Only with financing", "type": "boolean", "description": "Keep only listings that offer financing." }, "onlyAcceptsTrade": { "title": "Only if they take a trade-in", "type": "boolean", "description": "Keep only sellers who accept a vehicle as part of the payment." }, "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://crautos.com/autosusados/cardetail.cfm?c=9700597) or a seller's page with all their vehicles (https://crautos.com/autosusados/ssearchresults.cfm?c=JHL2158). Search results links do not hold their filters, so use the filters above for searches.", "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 } } } } } } } } } }