{ "openapi": "3.0.1", "info": { "title": "OLX Brazil Scraper - Classifieds, Cars, Real Estate & Leads", "description": "Scrape OLX Brasil (olx.com.br) classified ads with no login or API key. Get title, price, condition, category, seller, location, images plus typed car specs (make, model, year, km, fuel) and real estate specs (bedrooms, area, condo fee). Filter by keyword, state and price. Export JSON, CSV, Excel.", "version": "0.2", "x-build-id": "FAdAyy6LvFO24YWYP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~olx-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-olx-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/scrapers_lat~olx-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-olx-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/scrapers_lat~olx-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-olx-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": { "startUrl": { "title": "Search URL", "type": "string", "description": "An OLX Brazil (olx.com.br) search or category URL. Apply any filters on the site and paste the resulting URL, e.g. https://www.olx.com.br/brasil?q=iphone or https://www.olx.com.br/autos-e-pecas/carros-vans-e-utilitarios" }, "startUrls": { "title": "Start URLs (batch)", "type": "array", "description": "Multiple OLX Brazil search/category URLs to scrape in one run. Each may carry its own filters.", "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Search term. Added as ?q= to each URL; on its own it searches all of Brazil." }, "maxListings": { "title": "Max Listings", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of listings to collect. Leave empty for no limit (paid plans). Free plans are capped at 10 per run." }, "withDetails": { "title": "Scrape detail pages (paid add-on)", "type": "boolean", "description": "When enabled (paid plans only), each listing's detail page is fetched to add the full description, complete image gallery and a stable seller ID. Free-plan runs return listing data only.", "default": true }, "minPrice": { "title": "Min price (R$)", "type": "integer", "description": "Only keep listings priced at or above this value. Listings without a price are always kept." }, "maxPrice": { "title": "Max price (R$)", "type": "integer", "description": "Only keep listings priced at or below this value." }, "condition": { "title": "Condition", "type": "string", "description": "Keep listings whose condition contains this text, e.g. 'Novo' or 'Usado'." }, "state": { "title": "State (UF)", "type": "string", "description": "Two-letter Brazilian state code, e.g. SP, RJ, MG." }, "sellerType": { "title": "Seller type", "enum": [ "", "dealer", "private" ], "type": "string", "description": "Keep only 'dealer' (professional) or 'private' sellers." }, "minYear": { "title": "Min year (vehicles)", "type": "integer", "description": "Vehicles: minimum registration/model year." }, "maxYear": { "title": "Max year (vehicles)", "type": "integer", "description": "Vehicles: maximum registration/model year." }, "maxMileage": { "title": "Max mileage km (vehicles)", "type": "integer", "description": "Vehicles: maximum odometer reading in kilometers." }, "fuel": { "title": "Fuel (vehicles)", "type": "string", "description": "Vehicles: keep listings whose fuel contains this text, e.g. 'Flex', 'Gasolina', 'Diesel'." }, "transmission": { "title": "Transmission (vehicles)", "type": "string", "description": "Vehicles: keep listings whose transmission contains this text, e.g. 'Automático', 'Manual'." }, "propertyType": { "title": "Property type (real estate)", "type": "string", "description": "Real estate: keep listings whose property type contains this text, e.g. 'Apartamento', 'Casa'." }, "minBedrooms": { "title": "Min bedrooms (real estate)", "type": "integer", "description": "Real estate: minimum number of bedrooms." } } }, "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 } } } } } } } } } }