# Web Auto Scraper (`ribtools/web-auto-scraper`) Actor

Extract vehicle listings from WebAuto.com.py including cars and motorcycles with comprehensive details like pricing, specifications, seller information, and images. Supports search across different brands and automatically handles pagination to collect complete datasets.

- **URL**: https://apify.com/ribtools/web-auto-scraper.md
- **Developed by:** [RibTools](https://apify.com/ribtools) (community)
- **Categories:** Automation, E-commerce, Lead generation
- **Stats:** 5 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 1,000 vehicles

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## WebAuto Scraper

Extract comprehensive vehicle listings from WebAuto.com.py 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 Paraguayan automotive market.

### What is WebAuto Scraper?

**WebAuto Scraper** is a powerful data extraction tool that automatically collects vehicle listings from [WebAuto.com.py](https://webauto.com.py/), Paraguay'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, phone numbers, email addresses, location
- **Download vehicle images** - multiple high-resolution photos per listing
- **Handle multiple entry points** - home page, search pages, specific vehicle pages
- **Apply search filters** - brand, model, year range, price range, mileage
- **Automatic pagination** - crawls through all search result pages
- **Proxy support** - built-in rotation for reliable scraping
- **Structured output** - JSON, CSV, Excel formats available
- **API integration** - real-time data access through Apify API
- **Scheduled runs** - automated daily/weekly data collection

### What data can WebAuto Scraper extract?

| Field                 | Description            | Example                   |
| --------------------- | ---------------------- | ------------------------- |
| **Brand**             | Vehicle manufacturer   | TOYOTA, BMW, FORD         |
| **Model**             | Specific vehicle model | Land Cruiser, 118, Focus  |
| **Version**           | Model variant          | Vx, Sport, Titanium       |
| **Year**              | Manufacturing year     | 2020, 2018, 2015          |
| **Price**             | Listed price           | 45000                     |
| **Currency**          | Price currency         | USD, PYG                  |
| **Mileage**           | Kilometers driven      | 15000                     |
| **Fuel Type**         | Engine fuel            | Diesel, Gasolina, Híbrido |
| **Transmission**      | Gearbox type           | Automático, Manual        |
| **Body Style**        | Vehicle category       | SUV, Sedan, Hatchback     |
| **Color**             | Primary vehicle color  | Blanco, Negro, Gris       |
| **Location**          | Seller city/state      | Asunción, Central         |
| **Seller Info**       | Contact details        | Name, phone, email        |
| **Description**       | Vehicle description    | Features, condition notes |
| **Images**            | Photo URLs             | Multiple high-res images  |
| **Optional Features** | Equipment list         | A/C, leather seats, GPS   |

### How to scrape WebAuto.com.py vehicles

#### Step-by-step tutorial:

1. **Add starting URLs** - Enter WebAuto.com.py URLs (home page, search results, or specific listings)
2. **Set result limits** - Choose maximum number of vehicles to extract (default: 1000)
3. **Configure proxies** (optional) - Enable proxy rotation for large-scale scraping
4. **Run the scraper** - Click "Start" and monitor progress in real-time
5. **Download results** - Export data in JSON, CSV, or Excel format

#### URL examples:

- **Home page**: `https://webauto.com.py/`
- **Car search**: `https://webauto.com.py/es/autos`
- **Motorcycle search**: `https://webauto.com.py/es/motos`
- **Filtered search**: `https://webauto.com.py/es/autos/bmw/118?marca=bmw&modelo=118&anodel=2008&anoal=&valordel=&valoral=`

### How much does it cost to scrape WebAuto.com.py?

WebAuto Scraper uses **consumption-based pricing (PPR)** - you only pay for what you use. The cost depends on the number of vehicles extracted.

**Paid plan**: **$5 per 1,000 results**

Discounts for Bronze+ plans.

The scraper is optimized for efficiency, using minimal compute units while maintaining high success rates.

### Input configuration

The scraper accepts the following inputs through an intuitive form interface:

#### Start URLs

Add one or more WebAuto.com.py URLs where scraping should begin. Supports:

- Home page for broad collection
- Category pages (cars/motorcycles)
- Search results with applied filters
- Individual vehicle listing pages

#### Maximum Results

Set the limit for total vehicles to extract (default: 1000). Useful for:

- Testing with small datasets
- Budget control
- Targeted data collection

#### Proxy Configuration

Optional proxy settings for enhanced reliability:

- Apify Proxy integration
- Custom proxy groups
- Automatic rotation

### Output example

```json
{
  "id": 565,
  "brand": "TOYOTA",
  "model": "Land Cruiser",
  "version": "Vx",
  "year": 2010,
  "price": 45000,
  "price_currency": "USD",
  "km": 10,
  "fuel_type": "Diesel",
  "transmission_type": "Autom�tico",
  "body_style": "SUV",
  "primary_color": "Gris",
  "secondary_color": "",
  "vehicle_type": "Auto",
  "description": "MOTOR V8\r\nFACELIFT 2020",
  "city": "Asuncion",
  "state": "Central",
  "seller_name": "Darling Vega Nascimento",
  "seller_phone": "+595981124005",
  "seller_email": "vegadarling45@gmail.com",
  "create_date": "2024-10-07T16:14:45Z",
  "images": [
    "https://webauto.com.py/public/images/autos/vehicle1.jpeg",
    "https://webauto.com.py/public/images/autos/vehicle2.jpeg"
  ],
  "optionals": [
    "Aire Acondicionado",
    "Asiento Con Regulación De Altura",
    "Vidrios Eléctricos"
  ],
  "additionalItems": ["A Transferir", "Acepto Cambios"]
}
```

You can download the dataset extracted by **WebAuto Vehicle 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
- **Market researchers** - Analyze automotive market trends in Paraguay
- **Price comparison platforms** - Build comprehensive vehicle price databases
- **Import/export businesses** - Track vehicle availability and pricing
- **Mobile apps** - Power vehicle search and comparison features
- **Investment analysis** - Evaluate automotive market opportunities

### Integrations and API access

WebAuto 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

#### What if I need more than 1000 results?

Simply increase the "Max Results" parameter or contact us for enterprise solutions supporting unlimited data extraction.

#### Can I filter by specific brands or models?

Yes! Use WebAuto.com.py's search filters in your browser, then copy the filtered URL to target specific vehicles.

#### How often is the data updated?

WebAuto.com.py updates listings in real-time. For fresh data, schedule regular scraper runs or use our API for on-demand extraction.

#### 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.

#### Need help or have feedback?

- **Report issues**: Use the Issues tab for bug reports and feature requests
- **Custom development**: Contact us for tailored solutions

# Changelog

This Actor's version history is a separate document: https://apify.com/ribtools/web-auto-scraper/changelog.md

# Actor input Schema

## `start_urls` (type: `array`):

One or more URLs of pages where the crawler will start.
It can be a vehicle page, home page or search page for cars or bikes.
You can apply filters by copying the URL from the browser like `https://webauto.com.py/es/autos/bmw/118?marca=bmw&modelo=118&anodel=2008&anoal=&valordel=&valoral=&kmdel=&kmal=`

## `maxResults` (type: `integer`):

Max number of results to be returned

## `proxyConfig` (type: `object`):

Proxy configuration

## Actor input object example

```json
{
  "start_urls": [
    {
      "url": "https://webauto.com.py/"
    }
  ],
  "maxResults": 10,
  "proxyConfig": {
    "useApifyProxy": false,
    "apifyProxyGroups": []
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "start_urls": [
        {
            "url": "https://webauto.com.py/"
        }
    ],
    "maxResults": 10,
    "proxyConfig": {
        "useApifyProxy": false,
        "apifyProxyGroups": []
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ribtools/web-auto-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "start_urls": [{ "url": "https://webauto.com.py/" }],
    "maxResults": 10,
    "proxyConfig": {
        "useApifyProxy": False,
        "apifyProxyGroups": [],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("ribtools/web-auto-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "start_urls": [
    {
      "url": "https://webauto.com.py/"
    }
  ],
  "maxResults": 10,
  "proxyConfig": {
    "useApifyProxy": false,
    "apifyProxyGroups": []
  }
}' |
apify call ribtools/web-auto-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ribtools/web-auto-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/xdlXuOE0PBdEdEWJL/builds/Au6HJatLalpZNjNbB/openapi.json