# Webmotors Scraper (`ribtools/webmotors-scraper`) Actor Extract vehicle listings from Webmotors.com.br including cars and motorcycles. Get detailed info: prices, specs, photos, seller data. Fast scraping with anti-detection. Perfect for market analysis and inventory tracking. - **URL**: https://apify.com/ribtools/webmotors-scraper.md - **Developed by:** [RibTools](https://apify.com/ribtools) (community) - **Categories:** Automation, E-commerce, Lead generation - **Stats:** 105 total users, 18 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Webmotors Scraper Extract comprehensive vehicle listings from Webmotors.com.br including **cars and motorcycles** with detailed specifications, pricing, seller information, and high-quality images. Perfect for market research, price comparison, and inventory analysis in the Brazilian automotive market. ### What is Webmotors Scraper? **Webmotors Scraper** is a powerful data extraction tool that automatically collects vehicle listings from [Webmotors.com.br](https://webmotors.com.br/), Brazil's leading automotive marketplace. Simply provide starting URLs and get structured data including vehicle specifications, pricing, seller contact details, and image galleries. This scraper handles authentication, pagination, and data normalization automatically, delivering clean, structured datasets ready for analysis or integration into your systems. ### What can this Actor do? - **Extract comprehensive vehicle data** - specifications, pricing, mileage, year, fuel type, transmission - **Collect seller information** - names, CNPJ, phone numbers, location (with add-on) - **Download vehicle images** - multiple high-resolution photos per listing - **Handle multiple entry points** - search pages and filtered searches - **Apply search filters** - brand, model, year range, price range, location - **Automatic pagination** - crawls through all search result pages - **Premium proxies included** - high-quality residential proxies built in at no additional cost - **Structured output** - JSON, CSV, Excel formats available - **API integration** - real-time data access through Apify API - **Scheduled runs** - automated daily/weekly data collection - **360° view URLs** - immersive vehicle views when available ### What data can Webmotors Scraper extract? | Field | Description | Example | | ---------------- | ---------------------- | ------------------------- | | **ID** | Unique vehicle ID | 61932185 | | **Title** | Full vehicle title | AUDI A3 2.0 40 TFSI | | **Make** | Vehicle manufacturer | AUDI, BMW, FORD | | **Model** | Specific vehicle model | A3, X1, Focus | | **Version** | Model variant/trim | 2.0 40 TFSI SPORTBACK | | **Year** | Manufacturing year | 2023 | | **Model Year** | Model year | 2024 | | **Price** | Listed price (BRL) | 241900 | | **FIPE Price** | Reference price (BRL) | 247439 | | **Mileage** | Kilometers driven | 29562 | | **Fuel Type** | Engine fuel | Gasolina, Diesel, Flex | | **Transmission** | Gearbox type | Automática, Manual | | **Body Type** | Vehicle category | Hatchback, Sedan, SUV | | **Color** | Primary vehicle color | Cinza, Branco, Preto | | **Doors** | Number of doors | 4, 2 | | **Armored** | Armor status | true, false | | **Final Plate** | License plate digit | 0, 1, 2 | | **Seller Info** | Contact details | Name, CNPJ, phones\* | | **Location** | Seller location | São Paulo, Rio de Janeiro | | **Images** | Photo URLs | Multiple high-res images | | **360° View** | Virtual tour URL | Interactive vehicle view | | **Optionals** | Equipment list | A/C, leather seats, GPS | | **Attributes** | Listing features | Aceita troca, Financiado | \*Seller details require the optional add-on ### How to scrape Webmotors.com.br vehicles #### Step-by-step tutorial: 1. **Add starting URLs** - Enter Webmotors.com.br search URLs (see compatible formats below) 2. **Enable seller add-on** (optional) - Get detailed seller information including CNPJ and phone 3. **Run the scraper** - Click "Start" and monitor progress in real-time 4. **Download results** - Export data in JSON, CSV, or Excel format Proxies are included automatically — no setup required. #### Compatible URL examples: - **Cars (used)**: `https://www.webmotors.com.br/carros-usados/sp?lkid=1000&tipoveiculo=carros-usados&estadocidade=São%20Paulo` - **Cars (new)**: `https://www.webmotors.com.br/carros-novos/sp?lkid=1001&tipoveiculo=carros-novos&estadocidade=São%20Paulo` - **Motorcycles (used)**: `https://www.webmotors.com.br/motos-usadas/sp?lkid=1002&tipoveiculo=motos-usadas&estadocidade=São%20Paulo` - **Motorcycles (new)**: `https://www.webmotors.com.br/motos-novas/sp?lkid=1002&tipoveiculo=motos-novas&estadocidade=São%20Paulo` - **Filtered search**: `https://www.webmotors.com.br/carros/sp-sao-paulo/bmw/x1?autocomplete=x1&autocompleteTerm=BMW%20X1&lkid=1705&tipoveiculo=carros&marca1=BMW&modelo1=X1` **Important**: Only URLs matching these patterns will work. ### How much does it cost to scrape Webmotors.com.br? Webmotors Scraper uses **pay-per-result (PPR)** pricing - you only pay for successfully extracted vehicles. #### Is scraping Webmotors.com.br free? The scraper follows Apify's PPR model with the following structure: - **Base extraction**: Standard vehicle data (specifications, pricing, images) - **Seller add-on**: Additional cost for detailed seller information (CNPJ, full phone numbers) Pricing is optimized for efficiency, using minimal compute units while maintaining high success rates. Contact support for volume discounts on large-scale projects. ### Input configuration The scraper accepts the following inputs: #### Start URLs Add one or more Webmotors.com.br search URLs where scraping should begin. The scraper supports: - Category pages (cars/motorcycles, new/used) - Filtered searches with applied criteria - Location-specific searches - Brand and model specific pages **Proxies included**: high-quality residential proxies are built into the Actor at no additional cost — no proxy configuration is required. #### Seller Data Add-on Optional feature that extracts detailed seller information including: - Full CNPJ (Brazilian tax ID) - Complete phone numbers - Additional contact details Enable this add-on for comprehensive seller data collection. ### Output example ```json { "id": 61932185, "url": "https://www.webmotors.com.br/comprar/audi/a3/20-40-tfsi-mhev-sportback-performance-black-s-tronic/4-portas/2023-2024/61932185", "title": "AUDI A3 2.0 40 TFSI MHEV SPORTBACK PERFORMANCE BLACK S-TRONIC", "vehicle_type": "car", "create_date": "2025-09-24T11:07:48+0000", "publish_date": "2025-09-25T04:33:07+0000", "make": "AUDI", "model": "A3", "version": "2.0 40 TFSI MHEV SPORTBACK PERFORMANCE BLACK S-TRONIC", "fabrication_year": 2023, "model_year": 2024, "km": 29562, "transmission": "Automática", "fuel_type": "Gasolina", "body_type": "Hatchback", "final_plate": "0", "is_armored": false, "price": 241900, "fipe_price": 247439, "color": "Cinza", "number_of_doors": 4, "optionals": [ "Ar condicionado", "Teto solar", "Vidros elétricos", "Bancos em couro" ], "attributes": ["Aceita troca"], "photos": [ "https://image.webmotors.com.br/_fotos/anunciousados/gigante/2025/202509/20250924/AUDI-A3-wmimagem11091476721.jpg" ], "view_360_url": "https://embed.spincar.com/spinbuilder/?vid=1d507d92977c1aafb03468cad375252d#", "seller": { "id": 3855155, "name": "Audi Center", "cnpj": "70404822000113", "phones": [], "seller_type": "PJ", "neighborhood": "Lapa", "city": "São Paulo", "state": "São Paulo (SP)", "zip_code": "05038000" } } ```` You can download the dataset extracted by **Webmotors Scraper** in various formats such as **JSON, HTML, CSV, or Excel**. The data is automatically cleaned and normalized for immediate use in analysis tools, databases, or business applications. ### Use cases and applications - **Automotive dealerships** - Monitor competitor pricing and inventory across Brazil - **Market researchers** - Analyze Brazilian automotive market trends and pricing - **Price comparison platforms** - Build comprehensive vehicle price databases - **Import/export businesses** - Track vehicle availability and market pricing - **Mobile apps** - Power vehicle search and comparison features - **Investment analysis** - Evaluate automotive market opportunities in Brazil - **Insurance companies** - Access current market values for vehicle assessment - **Fleet management** - Research vehicle options and market pricing ### Integrations and API access Webmotors Scraper seamlessly integrates with popular platforms: - **Zapier** - Automate data workflows and notifications (via [Apify Zapier integration](https://docs.apify.com/platform/integrations/zapier)) - **Make (Integromat)** - Create complex automation scenarios (via [Apify Make integration](https://www.make.com/en/integrations/apify)) - **Google Sheets** - Direct data export for analysis - **REST API** - Programmatic access to extracted data ([instructions here](https://docs.apify.com/academy/api/run-actor-and-retrieve-data-via-api)) - **Python/Node.js SDKs** - Easy integration into applications ([instructions here](https://docs.apify.com/academy/api/run-actor-and-retrieve-data-via-api#javascript-and-python-client)) ### FAQ and Support #### Do I need to configure a proxy? No. Webmotors.com.br implements anti-scraping measures that block direct requests, so the Actor includes high-quality residential proxies automatically at no additional cost. There's nothing to configure. #### Can I filter by specific brands or models? Yes! Use Webmotors.com.br's search filters in your browser, then copy the filtered URL. The scraper supports all native filtering options including brand, model, year range, price range, and location. #### What's included in the seller add-on? The seller add-on provides: - Complete CNPJ (Brazilian tax identification) - Full phone numbers (not masked) - Additional contact information when available - Enhanced seller profile data #### How often is the data updated? Webmotors.com.br updates listings in real-time. For fresh data, schedule regular scraper runs or use our API for on-demand extraction. #### What if some URLs don't work? The scraper only supports specific URL patterns from Webmotors.com.br. Ensure your URLs match the compatible formats listed above. URLs outside these patterns will be automatically blocked. #### Do you offer custom solutions? Absolutely! We can customize the scraper for specific requirements, additional data points, or integration with your existing systems. Contact us through the Issues tab for enterprise solutions. #### Need help or have feedback? - **Report issues**: Use the Issues tab for bug reports and feature requests - **Custom development**: Contact us for tailored solutions and enterprise integrations # Actor input Schema ## `startUrls` (type: `array`): One or more URLs of search pages where the crawler will start. You can apply filters by copying the URL from the browser like `https://www.webmotors.com.br/carros/sp-sao-paulo/bmw/x1?autocomplete=x1&autocompleteTerm=BMW%20X1&lkid=1705&tipoveiculo=carros&localizacao=-23.5505199%2C-46.6333094x100km&estadocidade=S%C3%A3o%20Paulo-S%C3%A3o%20Paulo&marca1=BMW&modelo1=X1&page=1` ## `maxRequests` (type: `integer`): Maximum number of vehicles to scrape (each result is a charged event). Leave empty for no limit. ## `sellerDataAddon` (type: `boolean`): Fetch seller data from listings, returning tax ID, phone number, location and all available information. Sometimes the phone number for some sellers can't be fetched. You will be charged only for successful results. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.webmotors.com.br/carros-usados/sp?lkid=1000&tipoveiculo=carros-usados&estadocidade=S%C3%A3o%20Paulo&page=1" } ], "maxRequests": 10, "sellerDataAddon": false } ``` # Actor output Schema ## `vehicles` (type: `string`): Vehicle listings extracted from Webmotors (cars and motorcycles) with prices, specs, photos and optional seller data. Each dataset item is a single vehicle. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.webmotors.com.br/carros-usados/sp?lkid=1000&tipoveiculo=carros-usados&estadocidade=S%C3%A3o%20Paulo&page=1" } ], "maxRequests": 10, "sellerDataAddon": false }; // Run the Actor and wait for it to finish const run = await client.actor("ribtools/webmotors-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.webmotors.com.br/carros-usados/sp?lkid=1000&tipoveiculo=carros-usados&estadocidade=S%C3%A3o%20Paulo&page=1" }], "maxRequests": 10, "sellerDataAddon": False, } # Run the Actor and wait for it to finish run = client.actor("ribtools/webmotors-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.webmotors.com.br/carros-usados/sp?lkid=1000&tipoveiculo=carros-usados&estadocidade=S%C3%A3o%20Paulo&page=1" } ], "maxRequests": 10, "sellerDataAddon": false }' | apify call ribtools/webmotors-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ribtools/webmotors-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Webmotors Scraper", "description": "Extract vehicle listings from Webmotors.com.br including cars and motorcycles. Get detailed info: prices, specs, photos, seller data. Fast scraping with anti-detection. Perfect for market analysis and inventory tracking.", "version": "2.0", "x-build-id": "OFT8QDEn1kaIHAC0g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ribtools~webmotors-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ribtools-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/ribtools~webmotors-scraper/runs": { "post": { "operationId": "runs-sync-ribtools-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/ribtools~webmotors-scraper/run-sync": { "post": { "operationId": "run-sync-ribtools-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "One or more URLs of search pages where the crawler will start.\n You can apply filters by copying the URL from the browser like `https://www.webmotors.com.br/carros/sp-sao-paulo/bmw/x1?autocomplete=x1&autocompleteTerm=BMW%20X1&lkid=1705&tipoveiculo=carros&localizacao=-23.5505199%2C-46.6333094x100km&estadocidade=S%C3%A3o%20Paulo-S%C3%A3o%20Paulo&marca1=BMW&modelo1=X1&page=1`", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxRequests": { "title": "Max results", "type": "integer", "description": "Maximum number of vehicles to scrape (each result is a charged event). Leave empty for no limit.", "default": 10 }, "sellerDataAddon": { "title": "Fetch seller data (add-on)", "type": "boolean", "description": "Fetch seller data from listings, returning tax ID, phone number, location and all available information. Sometimes the phone number for some sellers can't be fetched. You will be charged only for successful results.", "default": false } } }, "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 } } } } } } } } } } ```