{ "openapi": "3.0.1", "info": { "title": "Webmotors Vehicle Scraper 🚗", "description": "Extract car listings from Webmotors Brazil with vehicle prices, makes, models, years, mileage, specifications, images, seller details, locations, and URLs. Ideal for used car market research, price tracking, competitor analysis, dealership insights, and automotive datasets.", "version": "0.0", "x-build-id": "B5hR5Tg8eIElpZyLn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~webmotors-vehicle-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-webmotors-vehicle-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/shahidirfan~webmotors-vehicle-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-webmotors-vehicle-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/shahidirfan~webmotors-vehicle-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-webmotors-vehicle-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": "Start URL", "type": "string", "description": "A Webmotors search results URL (for example, the page you see after applying filters on webmotors.com.br). A Start URL you provide takes priority over the filters below. If you leave it as the default and only fill in filters, the filters are used instead.", "default": "https://www.webmotors.com.br/carros/estoque?tipoveiculo=carros&page=1" }, "location": { "title": "Location", "type": "string", "description": "Filter by state or city, used only when no Start URL is provided. A state abbreviation works best (for example, SP, RJ, MG)." }, "brand": { "title": "Brand", "type": "string", "description": "Filter by brand/make, used only when no Start URL is provided (for example, HONDA, TOYOTA, BMW)." }, "model": { "title": "Model", "type": "string", "description": "Filter by model, used only when no Start URL is provided (for example, CIVIC, COROLLA, ONIX)." }, "bodyType": { "title": "Body type", "type": "string", "description": "Filter by body type, used only when no Start URL is provided. Use the exact Webmotors value (for example, Hatchback, Sedã, Utilitário Esportivo)." }, "minPrice": { "title": "Minimum price (BRL)", "minimum": 0, "type": "integer", "description": "Minimum listing price in Brazilian reais, used only when no Start URL is provided." }, "maxPrice": { "title": "Maximum price (BRL)", "minimum": 0, "type": "integer", "description": "Maximum listing price in Brazilian reais, used only when no Start URL is provided." }, "yearFrom": { "title": "Year from", "minimum": 1900, "type": "integer", "description": "Minimum manufacturing year, used only when no Start URL is provided." }, "yearTo": { "title": "Year to", "minimum": 1900, "type": "integer", "description": "Maximum manufacturing year, used only when no Start URL is provided." }, "vehicleType": { "title": "Vehicle type", "enum": [ "carros", "motos" ], "type": "string", "description": "Vehicle category used to build the search URL when no Start URL is provided.", "default": "carros" }, "results_wanted": { "title": "Maximum number of listings", "minimum": 1, "type": "integer", "description": "The maximum number of listings to collect.", "default": 20 }, "max_pages": { "title": "Maximum number of pages", "minimum": 1, "type": "integer", "description": "A safety cap on how many result pages to read.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Car searches work without a proxy. Motorcycle searches are more reliable with Apify Proxy using the RESIDENTIAL group and country BR.", "default": { "useApifyProxy": 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 } } } } } } } } } }