Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link: My profile

What does Vehis Vehicle & Model Scraper do?

Introduction

Vehis.pl is Poland's innovative car leasing and financing marketplace, offering an extensive selection of new, used, and post-lease vehicles from multiple brands with transparent online financing options. As one of Poland's leading automotive e-commerce platforms, Vehis.pl represents a comprehensive source of vehicle and pricing data for businesses, researchers, and developers seeking automotive market intelligence across various brands, models, and leasing configurations.

The challenge lies in manually browsing through thousands of vehicle listings and model configurations to analyze pricing strategies, leasing terms, and market availability. Our Vehis Vehicle & Model Scraper eliminates this time-consuming process by automating data extraction from both aggregated model listings and individual vehicle offers, providing structured access to vehicle data with lease configurations, pricing parameters, and availability metrics that can drive market research and competitive analysis in the automotive sector.

Scraper Overview

The Vehis Vehicle & Model Scraper is designed to extract both aggregated model data and individual vehicle listings from Vehis.pl with precision and reliability. This scraper intelligently detects URL patterns and applies the appropriate extraction strategy for model listings or individual vehicle offers with lease configurations.

Key advantages include intelligent URL pattern detection for automatic extraction strategy selection, comprehensive lease configuration extraction (period, initial payment %, buyout %, customer type), high-performance processing, and configurable retry mechanisms for reliability. The scraper is particularly valuable for automotive market researchers analyzing vehicle availability and pricing trends, leasing companies monitoring competitive financing terms, car dealerships tracking market inventory and pricing strategies, and data analysts building automotive databases from marketplace data.

Target users include automotive analysts, leasing and financing companies, car marketplace platforms, automotive publishers and media, fleet management companies, and data scientists working with Polish automotive market data.

Input and Output Specifications

Example URLs

Example URL 1 (Individual Vehicles): https://vehis.pl/wybierz/audi/a5?body=kombi

Example URL 2 (Model Listings - Base Search): https://vehis.pl/samochody?brand=MERCEDES-BENZ

Example URL 3 (Model Listings - Advanced Search): https://vehis.pl/wyszukaj?brand=BMW&bodyType=SUV&priceMin=50000

---

Input Format

The scraper accepts JSON configuration with the following parameters:

{
  "urls": [
    "https://vehis.pl/wybierz/audi/a5?body=kombi",
    "https://vehis.pl/samochody?brand=MERCEDES-BENZ",
    "https://vehis.pl/wyszukaj?brand=BMW&bodyType=SUV"
  ],
  "max_items_per_url": 100,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}

urls - An array containing Vehis.pl URLs to scrape. Supported formats:

• /wybierz/{brand}/{model} for individual vehicles with lease configurations
• /samochody (base URL) or /wyszukaj?... for aggregated model listings

IMPORTANT: Brand filter URLs like /samochody/audi are NOT supported. Use /samochody?brand=AUDI or /wybierz/audi/{model} instead.

max_items_per_url - Maximum number of items to scrape per URL (default: 0 for unlimited). The scraper automatically processes all available results up to this limit.

max_retries_per_url - Maximum number of retry attempts for failed requests (default: 2, range: 0-10). Configures resilience against temporary network issues.

proxy - Optional proxy configuration object. Set useApifyProxy: true to use Apify Proxy for enhanced reliability and reduced blocking risks. Leave as false for development or when proxies are not required.

---

Output

The scraper returns different data structures depending on the URL type. You get the output stored in a dataset. The following are examples of the information fields collected.

Output Type 1: Individual Vehicle Offers (from /wybierz/ URLs)

Returns individual, specific vehicles with complete lease configuration:

[
  {
    "offerId": "AUA52BPPZJ5",
    "url": "https://vehis.pl/oferta/AUA52BPPZJ5",
    "vehicleTitle": "AUDI A5 TFSI 110 kW S tronic",
    "image": "https://images.vehistools.pl/imagin/?make=audi&modelFamily=a5&modelRange=a5&modelVariant=es&modelYear=2025&paintId=pspc0033&customer=plvehis-sp-z-oo&trim=0&fileType=webp&angle=28&width=400",
    "year": 2025,
    "mileage": 0,
    "price": 1530,
    "currency": "PLN",
    "leasePeriod": 60,
    "initialPaymentPercent": 25,
    "buyoutValuePercent": 35,
    "customerType": "company",
    "availableLeasePeriods": [36, 48, 60],
    "catalogPrice": 143906,
    "priceForYou": 135100,
    "initialPayment": 35975,
    "buyoutValue": 50400
  }
]

Field descriptions for vehicle offers:

offerId - Unique vehicle offer identifier in Vehis system, essential for tracking specific vehicles and accessing detailed offer information.

url - Direct link to the vehicle offer detail page, enabling deep linking and integration with detail extraction workflows.

vehicleTitle - Complete vehicle specification including brand, model, engine, and transmission details as displayed in listings.

image - Vehicle image URL from Vehis's image CDN, generated dynamically with specified angle, size, and styling parameters.

year - Production year of the vehicle, critical for age-based analysis and pricing comparisons.

mileage - Current mileage in kilometers, essential for used vehicle valuation and condition assessment. Returns 0 for new vehicles.

price - Base monthly leasing rate in PLN displayed in listing, fundamental for quick price comparison across offers.

currency - Price currency specification (PLN for Vehis.pl), ensuring accurate financial analysis.

leasePeriod - Currently selected lease period in months (typically 36, 48, or 60), showing the active configuration on the page.

initialPaymentPercent - Initial payment percentage of total vehicle value (e.g., 25%), critical for understanding upfront costs and lease structure.

buyoutValuePercent - Residual value percentage at lease end (e.g., 35%), essential for lease-vs-buy analysis and total cost calculations.

customerType - Indicates whether the configuration is for "company" (business) or "private" (individual) customers, affecting tax and pricing structures.

availableLeasePeriods - Array of available lease period options (e.g., [36, 48, 60] months), showing configuration flexibility.

catalogPrice - Official catalog price of the vehicle in PLN (MSRP), essential for understanding baseline pricing and calculating discounts.

priceForYou - Discounted "price for you" in PLN after applying promotions and dealer incentives, showing actual purchase price available to customers.

initialPayment - Calculated initial payment amount in PLN based on the configured percentage, critical for understanding upfront cash requirements.

buyoutValue - Calculated residual buyout value in PLN at lease end based on the configured percentage, essential for total cost of ownership analysis.

Output Type 2: Aggregated Model Listings (from /samochody/ or /wyszukaj URLs)

Returns aggregated model groups with availability and configuration options:

[
  {
    "brand": "AUDI",
    "model": "A5",
    "version": "Sportback 40 TFSI",
    "bodyType": "Kombi",
    "price": 1570,
    "consumerPrice": 1570,
    "basicPrice": 143906,
    "currency": "PLN",
    "installment": 1570,
    "consumerInstallment": 1570,
    "discount": 12,
    "gain": 19135,
    "image": "https://images.vehistools.pl/imagin/?make=audi&modelFamily=a5...",
    "imageLeftFront": "https://images.vehistools.pl/imagin/?angle=29...",
    "imageRightFront": "https://images.vehistools.pl/imagin/?angle=09...",
    "gearboxTypes": ["Automatyczna skrzynia biegów"],
    "driveTypes": ["Napęd przedni"],
    "fuelTypes": ["Benzyna"],
    "states": ["Nowy"],
    "count": 20,
    "usedCount": 0,
    "postLeaseCount": 0,
    "labels": [],
    "purposes": ["company"]
  }
]

Field descriptions for model listings:

brand - Vehicle brand name (e.g., "AUDI", "BMW"), essential for brand-level analysis and filtering.

model - Model name (e.g., "A5", "X5"), enabling model-specific comparisons and tracking.

version - Specific trim or variant name (e.g., "Sportback 40 TFSI"), providing detailed model differentiation.

bodyType - Body style classification (Sedan, Kombi, SUV, Hatchback), critical for segment analysis.

price - Starting monthly leasing rate for this model configuration, key metric for quick pricing comparisons.

consumerPrice - Monthly rate for private customers, enabling B2B vs B2C pricing analysis.

basicPrice - Base vehicle catalog price before financing, essential for calculating financing terms and discounts.

installment - Monthly payment amount for business customers, reflecting company leasing rates.

consumerInstallment - Monthly payment for private customers, showing consumer-focused pricing.

discount - Discount percentage or amount applied to this model, indicating promotional intensity.

gain - Total savings amount in PLN from promotions and discounts, quantifying customer value proposition.

image / imageLeftFront / imageRightFront - Multiple vehicle image URLs at different angles, enabling comprehensive visual representation.

gearboxTypes - Array of available transmission types for this model group (Manual, Automatic).

driveTypes - Array of available drivetrain configurations (Front-wheel, All-wheel, Rear-wheel).

fuelTypes - Array of available fuel/power types (Benzyna, Diesel, Hybryda, Elektryk).

states - Array of available vehicle conditions (Nowy, Używany, Poleasingowy), showing inventory composition.

count - Total number of available vehicles matching this model configuration, critical for inventory analysis.

usedCount - Number of used vehicles in this model group, enabling new vs used ratio analysis.

postLeaseCount - Number of post-lease vehicles available, showing remarketed inventory levels.

labels - Array of special labels or badges applied to this model, indicating marketing priorities.

purposes - Target customer segments for this configuration (company, private), showing market positioning.

---

Usage Guide

Understanding URL Types

The scraper automatically detects two distinct URL patterns and applies the appropriate extraction strategy:

Pattern 1: /wybierz/{brand}/{model} - Individual Vehicle Listings

These URLs show specific, individual vehicles available for lease with complete configuration details. Use these URLs when you need:

• Specific vehicle data (exact year, mileage, offer ID)
• Current lease configuration (period, payments, customer type)
• Individual vehicle tracking and monitoring
• Detailed offer-level analysis

Examples:

• https://vehis.pl/wybierz/audi/a5?body=kombi
• https://vehis.pl/wybierz/mercedes-benz/glc?body=suv
• https://vehis.pl/wybierz/bmw/seria-5

Pattern 2: /samochody or /wyszukaj?... - Model Listings

These URLs show aggregated model groups from the Vehis API with availability counts and configuration options. Use these URLs when you need:

• Market overview and model availability
• Brand-level or segment-level analysis
• Inventory counts (new, used, post-lease)
• Available configuration options across models

Examples:

• https://vehis.pl/samochody (all vehicles)
• https://vehis.pl/samochody?brand=AUDI (specific brand with query param)
• https://vehis.pl/wyszukaj?brand=BMW&bodyType=SUV&priceMin=50000

IMPORTANT: Brand path URLs like https://vehis.pl/samochody/audi are NOT supported. Use query parameters instead: https://vehis.pl/samochody?brand=AUDI

Configuration Guide

Configure the input JSON with your target URLs based on the analysis type needed. Set max_items_per_url to control data collection volume - particularly useful for large model catalogs or extensive vehicle listings.

The scraper automatically handles URL pattern detection, pagination, lease configuration extraction, and data normalization.

Best Practices:

• Use /wybierz/{brand}/{model} URLs for monitoring specific vehicle offers and lease configurations
• Use /samochody or /wyszukaj URLs (with query params) for market research and brand/model analysis
• AVOID brand path URLs like /samochody/audi - they are not supported
• USE query parameters instead: /samochody?brand=AUDI
• Start with reasonable limits (50-100 items) to validate URLs before scaling
• Monitor log output for pagination status and item counts
• Combine both URL types for comprehensive market intelligence
• Export data to separate datasets based on URL type for clearer analysis

Common scenarios:

• Lease term monitoring - Use /wybierz/{brand}/{model} URLs to track how lease configurations affect monthly payments across brands
• Market inventory analysis - Use /samochody?brand=AUDI URLs to analyze brand availability and model mix
• Competitive pricing - Compare monthly rates across similar models using /wybierz/ URLs with filters
• Brand portfolio tracking - Monitor model lineup and availability using /samochody?brand=AUDI URLs
• Segment analysis - Use filtered /wyszukaj URLs to analyze SUV, sedan, or electric vehicle markets

Common errors and solutions:

• URL rejected (brand filter not supported) - You're using /samochody/audi format. Change to /samochody?brand=AUDI or /wybierz/audi/{model}
• No items found - Verify the URL returns results when accessed manually; some brand/model combinations may have no available inventory
• Missing lease configuration - Ensure URL starts with /wybierz/; model listing URLs don't include lease details
• Different output format - Check URL type; /wybierz/ and /samochody return different data structures
• Count mismatches - For model listings, count shows total available, but API may paginate results

Monitor scraper performance through detailed logging including URL validation, pattern detection, items found per page, and total items collected per URL.

---

Benefits and Applications

The scraper delivers significant time savings by automating manual browsing across vehicle listings and model catalogs. For a typical market research task covering 500 vehicles across multiple brands, manual collection could require days of work, while automated scraping completes in minutes.

Real-world applications include:

• Automotive market intelligence for understanding brand positioning and pricing strategies
• Lease rate monitoring to track financing terms across brands and models
• Inventory analysis leveraging availability counts and vehicle state distribution
• Competitive benchmarking comparing lease configurations and monthly payments
• Brand portfolio tracking monitoring model lineup changes and new vehicle introductions
• Customer segment analysis through company vs private pricing and configuration differences
• Market sizing by analyzing vehicle counts and availability across segments

Business value extends to:

• Identifying pricing patterns and leasing strategies across automotive brands
• Monitoring new vehicle launches and model updates through inventory tracking
• Analyzing lease term preferences and configuration trends in the market
• Supporting market entry decisions with comprehensive brand and model data
• Generating competitive intelligence reports for automotive sector
• Building training datasets for pricing algorithms and recommendation systems
• Tracking seasonal trends and promotional campaigns through periodic scraping

Integration opportunities:

• Feed into business intelligence dashboards for automotive market monitoring
• Export to databases for lease rate history tracking and trend analysis
• Power automotive comparison and recommendation engines
• Support fleet management decision-making with market data
• Enable dynamic pricing strategies for automotive platforms

---

Conclusion

The Vehis Vehicle & Model Scraper transforms tedious manual research into automated, structured data collection from Poland's innovative automotive leasing marketplace. Whether you're conducting market research across brands, monitoring competitive lease rates, tracking inventory availability, or building automotive databases, this scraper provides the reliable foundation for data-driven decision making in the automotive sector.

The intelligent URL pattern detection and dual extraction strategies make this scraper ideal for both detailed vehicle-level analysis and broad market intelligence operations. With support for lease configuration extraction and high-performance processing, you can efficiently gather the automotive data you need.

Ready to unlock Vehis's automotive data for your market research needs? Start extracting valuable vehicle and leasing insights today with our comprehensive scraping solution.

---

Your Feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Vehis Vehicle & Model Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.