{ "openapi": "3.0.1", "info": { "title": "Webmotors Scraper | Car Listings, Prices and FIPE", "description": "Webmotors scraper for Brazil's car and motorcycle marketplace: 20 listings in 5 seconds, 74 fields each. Search by make and model, paste a Webmotors page or a seller id. Get price, FIPE and market price, mileage, specs, equipment, dealer CNPJ, city and photos. No login, export to CSV or JSON.", "version": "1.0", "x-build-id": "AagUf2BLp8uFQtvL1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~webmotors-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-webmotors-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/silentflow~webmotors-scraper/runs": { "post": { "operationId": "runs-sync-silentflow-webmotors-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/silentflow~webmotors-scraper/run-sync": { "post": { "operationId": "run-sync-silentflow-webmotors-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": { "searches": { "title": "πŸš— Make and model", "type": "array", "description": "One search per line, the way you would say it: Toyota Corolla Cross, Honda Civic Touring 2020, Fiat Strada, Onix, Yamaha Fazer 250. A make alone (BMW) returns every model of the make. A year (2020, or 2019 2022 for a range) keeps those model years, and version words such as Touring or XEi keep the listings whose title holds them.

Leave this, the pages and the seller ids empty to browse every listing that matches the filters below.", "items": { "type": "string" } }, "startUrls": { "title": "πŸ”— Webmotors pages", "type": "array", "description": "Paste Webmotors addresses as they appear in your browser: a search with its filters (https://www.webmotors.com.br/carros-usados/sp, https://www.webmotors.com.br/motos/estoque/honda) or a single listing (https://www.webmotors.com.br/comprar/porsche/macan/.../80942460). A pasted search keeps its own filters; the filters below apply to the make and model searches.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sellerIds": { "title": "πŸͺ Seller ids", "type": "array", "description": "Read the whole stock of a dealer or shop, cars and motorcycles: one Webmotors seller id per line, such as 3917239. Take it from the sellerId column of any earlier run, or paste a Webmotors address that carries idrevendedor=. The condition, state and price filters below apply.", "items": { "type": "string" } }, "state": { "title": "πŸ“ State", "type": "string", "description": "Keep the listings of one Brazilian state. Pick it in the list, or type its code (SP) or its name (ParanΓ‘). Leave empty to search the whole of Brazil." }, "maxItems": { "title": "πŸ”’ Max listings", "minimum": 1, "type": "integer", "description": "How many listings to deliver in total, across all your searches and pages. A make and model search usually holds a few hundred to a few thousand listings; one search returns up to 10,000.", "default": 50 }, "vehicleType": { "title": "🏍️ Vehicle type", "enum": [ "car", "motorcycle" ], "type": "string", "description": "Search cars or motorcycles. A search that only exists for the other type, such as Yamaha Fazer 250 with cars selected, switches on its own.", "default": "car" }, "condition": { "title": "✨ Condition", "enum": [ "all", "used", "new" ], "type": "string", "description": "Keep used vehicles, new ones (0 km, mostly from dealers), or both.", "default": "all" }, "maxPrice": { "title": "πŸ’° Max price (BRL)", "minimum": 1, "type": "integer", "description": "Keep listings at or under this asking price in Brazilian reais, such as 120000." }, "sortBy": { "title": "↕️ Sort by", "enum": [ "relevance", "newest", "price_asc", "price_desc", "year_desc", "mileage_asc" ], "type": "string", "description": "The order Webmotors returns the listings in. With a cap on listings, the order decides which ones you get: Lowest price first gives the cheapest offers, Latest listings first the fresh stock.", "default": "relevance" }, "includeDetails": { "title": "πŸ“‹ Full listing details and market price", "type": "boolean", "description": "Adds what only the listing page holds: fuel, final plate digit, the full equipment list, the FIPE code and price, the dealer's CNPJ and years on Webmotors, the publication date, the 360Β° view and inspection report links, and the lowest, average and highest asking price of the same version and year on Webmotors. Turn it off for faster runs with the search card data only (price, mileage, specs, seller, city, photos).", "default": true } } }, "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 } } } } } } } } } }