{ "openapi": "3.0.1", "info": { "title": "OLX Brasil Carros Data Scraper", "description": "🚗💨 Scrape OLX Brazil car listings with precision! Advanced filters: state, brand, price, mileage, year, color, FIPE. 🛡️ Anti-bot tech, unlimited pagination. 📊 Extract complete vehicle data + high-res photos. 🇧🇷 180+ brands, all states!", "version": "1.0", "x-build-id": "u04rGcWv5wWAAVBjS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/israeloriente~olx-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-israeloriente-olx-cars-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/israeloriente~olx-cars-scraper/runs": { "post": { "operationId": "runs-sync-israeloriente-olx-cars-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/israeloriente~olx-cars-scraper/run-sync": { "post": { "operationId": "run-sync-israeloriente-olx-cars-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", "required": [ "state" ], "properties": { "state": { "title": "Brazilian State (UF)", "enum": [ "ac", "al", "ap", "am", "ba", "ce", "df", "es", "go", "ma", "mt", "ms", "mg", "pa", "pb", "pr", "pe", "pi", "rj", "rn", "rs", "ro", "rr", "sc", "sp", "se", "to" ], "type": "string", "description": "Select the Brazilian state to search for vehicle listings. Covers all 27 states including São Paulo (sp), Rio de Janeiro (rj), Minas Gerais (mg), and others. This defines the geographic region for your search." }, "search": { "title": "Search Query (Optional)", "type": "string", "description": "Free-text search for specific vehicle models, features, or keywords. Example: 'polo tsi', 'corolla xei automatico', 'civic touring'. Combines with other filters for precise targeting." }, "ads_limit": { "title": "Maximum Ads to Scrape", "minimum": 1, "maximum": 300, "type": "integer", "description": "Maximum number of vehicle advertisements to extract. The scraper will automatically paginate through listings until this limit is reached. Range: 1-300. Recommended: 10-50 for testing, 100-300 for comprehensive data collection." }, "fpdll": { "title": "Filter Below FIPE Price", "type": "boolean", "description": "When enabled, shows only vehicles priced BELOW the FIPE table reference value. FIPE is Brazil's official vehicle pricing guide. This filter helps identify potential deals and underpriced listings. Recommended for investment opportunities and bargain hunting." }, "brand": { "title": "Vehicle Brand (Optional)", "enum": [ "Acura", "Agrale", "Alfa Romeo", "AM GEN", "Americar", "Asia Motors", "Aston Martin", "Audi", "Austin", "Baby", "Bentley", "BMW", "BRM", "Bugatti", "Buggy", "Bugre", "BYD", "CAB Motors", "Cadillac", "CAN AM", "CBT Jipe", "Chana", "Changan", "Chery", "Chevrolet", "Chrysler", "Citroen", "Cross Lander", "D2D", "Dacon", "Daewoo", "Daihatsu", "DFSK", "DKW Vemag", "Dodge", "Effa", "Engesa", "Envemo", "Ferrari", "Fever", "Fiat", "Fibravan", "Ford", "Foton", "Fyber", "GAC Motors", "Geely", "GMC", "Great Wall", "Gurgel", "GWM", "Hafei", "Hitech Eletric", "Honda", "Hyundai", "Infiniti", "Isuzu", "Iveco", "JAC", "Jaecoo", "Jaguar", "Jeep", "Jinbei", "JPX", "Kia Motors", "Lada", "Lamborghini", "Land Rover", "Landwind", "Lexus", "Lifan", "Lobini", "Lotus", "Mahindra", "Maserati", "Matra", "Mazda", "McLaren", "Mercedes-Benz", "Mercury", "MG", "Mini", "Mitsubishi", "Miura", "Mon", "MP Lafer", "Neta", "Nissan", "Omoda", "Peugeot", "Plymouth", "Pontiac", "Porsche", "Puma", "Ram", "Rely", "Renault", "Rivian", "Rolls-Royce", "Rover", "Saab", "Saturn", "Seat", "Seres", "Shelby", "Shineray", "Smart", "Ssangyong", "Subaru", "Sunbeam Talbot", "Suzuki", "Swell Mini Veiculos", "TAC", "Tesla", "Toyota", "Troller", "Ventura", "Volkswagen", "Volvo", "VW", "Wake", "Walk", "Willys Overland", "Zeekr" ], "type": "string", "description": "Filter by car manufacturer/brand. Choose from 180+ brands including Toyota, Volkswagen, Chevrolet, Fiat, Ford, Honda, Hyundai, BMW, Mercedes-Benz, and more. Leave empty to search all brands." }, "mileage_from": { "title": "Minimum Mileage (km)", "minimum": 0, "type": "integer", "description": "Minimum odometer reading in kilometers. Use 0 for new or very low-mileage vehicles. Example: 0 (new), 30000 (moderate use). Filters vehicles with mileage greater than or equal to this value." }, "mileage_to": { "title": "Maximum Mileage (km)", "minimum": 0, "type": "integer", "description": "Maximum odometer reading in kilometers. Example: 50000 (low mileage), 100000 (moderate), 150000+ (high). Filters vehicles with mileage less than or equal to this value." }, "year_from": { "title": "Minimum Year", "minimum": 1900, "type": "integer", "description": "Minimum production/model year. Example: 2018 (recent models), 2010 (affordable used cars). Filters vehicles manufactured in or after this year." }, "year_to": { "title": "Maximum Year", "minimum": 1900, "type": "integer", "description": "Maximum production/model year. Example: 2024 (latest models), 2020 (slightly used). Filters vehicles manufactured in or before this year." }, "ps": { "title": "Minimum Price (R$)", "minimum": 0, "type": "integer", "description": "Minimum price in Brazilian Reais (BRL). Example: 30000 (R$ 30,000), 50000 (R$ 50,000). Sets the lower bound for vehicle pricing. Combine with maximum price for a specific budget range." }, "pe": { "title": "Maximum Price (R$)", "minimum": 0, "type": "integer", "description": "Maximum price in Brazilian Reais (BRL). Example: 80000 (R$ 80,000), 150000 (R$ 150,000). Sets the upper bound for vehicle pricing. Ideal for budget-conscious searches." }, "colors": { "title": "Vehicle Colors (Multi-Select)", "uniqueItems": true, "type": "array", "description": "Select one or multiple vehicle colors to filter listings. Options include: Preto (Black), Branco (White), Prata (Silver), Cinza (Gray), Azul (Blue), Vermelho (Red), Verde (Green), Amarelo (Yellow), Laranja (Orange), Outra (Other). Popular combinations: Black + Silver, White + Gray.", "items": { "type": "string", "enum": [ "Amarelo", "Azul", "Branco", "Cinza", "Laranja", "Prata", "Preto", "Verde", "Vermelho", "Outra" ] } } } }, "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 } } } } } } } } } }