# Car.gr Vehicles Search Scraper (`ecomscrape/car-gr-vehicles-search-scraper`) Actor

Automate vehicle listing extraction from Car.gr, Greece's leading automotive marketplace. Get comprehensive data on cars, motorcycles, commercial vehicles, boats, and more with pricing, specifications, seller information, and images for market analysis and inventory research.

- **URL**: https://apify.com/ecomscrape/car-gr-vehicles-search-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** Automation, E-commerce, Other
- **Stats:** 17 total users, 1 monthly users, 76.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$15.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)

## Car.gr Vehicle Search Scraper: Extract Greek Automotive Marketplace Data

### Introduction

Car.gr stands as Greece's premier online automotive marketplace, serving as the primary platform where Greek consumers and dealers buy and sell vehicles. With hundreds of thousands of active listings spanning cars, motorcycles, commercial vehicles, campers, boats, and specialty vehicles, Car.gr provides comprehensive coverage of the Greek automotive market.

For automotive dealers, market researchers, pricing analysts, and vehicle importers operating in or targeting the Greek market, accessing structured data from Car.gr is essential for competitive intelligence, pricing strategies, and market trend analysis. However, manually collecting vehicle data across multiple categories, brands, and regions is extremely time-consuming and impractical for large-scale research.

The Car.gr Vehicle Search Scraper automates this data extraction process, enabling systematic collection of detailed vehicle listings including specifications, pricing, seller information, location data, and multimedia content. Whether you're analyzing used car pricing trends in Athens, monitoring luxury vehicle inventory, tracking commercial vehicle availability, or conducting comprehensive Greek automotive market research, this scraper delivers structured data at scale.

### Scraper Overview

The Car.gr Vehicle Search Scraper is a specialized automotive data extraction tool designed to systematically collect vehicle listings from Greece's largest automotive marketplace. Using advanced web automation techniques, it navigates through search results across multiple vehicle categories to extract comprehensive listing information.

The tool offers several key advantages including configurable retry mechanisms for handling network issues, flexible pagination controls for managing large datasets, and proxy support for reliable access. It's particularly valuable for automotive dealers analyzing Greek market inventory, pricing analysts tracking vehicle values, importers researching market demand, competitive intelligence teams monitoring dealer activities, and market researchers studying Greek automotive trends.

The scraper handles diverse search parameters including vehicle type selection (cars, bikes, commercial vehicles, boats), condition filters (new vs used), keyword searches, comprehensive sorting options, and pagination controls. It maintains high data accuracy while implementing ethical scraping practices, allowing users to customize extraction for specific vehicle categories, price ranges, geographic regions, or technical specifications relevant to their automotive research objectives.

### Input and Output Details

Example url 1: https://www.car.gr/classifieds/cars/?category=15001\&condition=used\&pg=1\&sort=dm

Example url 2: https://www.car.gr/classifieds/boats/?category=15003

Example url 3: https://www.car.gr/classifieds/bikes/?category=15002\&pg=2

Example Screenshot of automotive list by query page:

![](https://i.ibb.co/Y7wPDvRF/Screenshot-from-2026-01-14-16-58-59.png)

#### Input Format

The scraper accepts JSON configuration for precise control over vehicle data extraction from Car.gr's platform.

##### Scrape with URLs:

```json
{
  "proxy": {
    "useApifyProxy": false
  },
  "ignore_url_failures": true,
  "max_retries_per_url": 2,
  "max_items_per_url": 20,
  "urls": [
    "https://www.car.gr/classifieds/cars/?category=15001&pg=1&q=suv&sort=prd",
    "https://www.car.gr/classifieds/bikes/?category=16001&pg=1&sort=dm",
    "https://www.car.gr/classifieds/commercials/?pg=1&sort=pra"
  ]
}
```

**The `urls` parameter**: Add URLs of vehicle search or category pages from Car.gr. You can paste URLs individually or use bulk edit to add prepared lists. This method is ideal when targeting specific vehicle categories, brands, or pre-filtered search results.

**The `ignore_url_failures` parameter**: When set to `true`, the scraper continues running even if some URLs fail after maximum retries. This ensures one problematic URL doesn't halt your entire vehicle data extraction job.

*When providing URLs, all "Scrape with search filters" options are disabled. The system collects data only from specified URLs.*

##### Scrape with Search Filters:

```json
{
  "keyword": "BMW X5",
  "vehical_type": "cars",
  "vehical_state": "used",
  "sort_by": "prd",
  "page": 1,
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "GR"
  }
}
```

**The `keyword` parameter**: Enter search terms to find specific vehicles (e.g., "BMW X5", "Mercedes C-Class", "Toyota Corolla", "Yamaha MT-07"). Use vehicle model names, brands, or features.

**The `vehical_type` parameter**: Select the vehicle category:

- `"cars"` - Passenger cars and SUVs
- `"bikes"` - Motorcycles and scooters
- `"commercials"` - Commercial vehicles and trucks
- `"campers"` - Motorhomes and camper vans
- `"bicycles"` - Bicycles and e-bikes
- `"hobby"` - Hobby and recreational vehicles
- `"boats"` - Boats and watercraft

**The `vehical_state` parameter**: Filter by vehicle condition:

- `""` (empty) - All vehicles (both new and used)
- `"used"` - Used vehicles only
- `"new"` - New vehicles only

**The `sort_by` parameter**: Sort listings by various criteria:

- `"dm"` - Classified age (newest listings first)
- `"pra"` - Cheap first (lowest price)
- `"prd"` - Expensive first (highest price)
- `"cr"` - Entry (most recent additions)
- `"popularity"` - Most popular listings
- `"red"` - New first (by vehicle age)
- `"rea"` - Old first (by vehicle age)
- `"ma"` - Brand/model alphabetical
- `"mid"` - Kilometers many (highest mileage)
- `"mia"` - Kilometers few (lowest mileage)
- `"pod"` - Horsepower many (highest power)
- `"poa"` - Horsepower few (lowest power)

**The `page` parameter**: Specify the starting page number for scraping. Useful for resuming interrupted scrapes or targeting specific result ranges.

*When using search filters, leave the `urls` field empty in the "Scrape with URLs" configuration.*

##### General Options:

**The `max_items_per_url` parameter**: Limit items per URL or search filter. Default value is 20, balancing batch size with comprehensive data collection.

**The `max_retries_per_url` parameter**: Set retry attempts for each URL if scraping encounters bot detection or page load failures. Default is 2, balancing thoroughness with efficiency.

**The `proxy` parameter**: Proxy configuration is essential for avoiding detection. For Car.gr, Greek proxies provide optimal access and performance.

#### Output Format

The scraper returns comprehensive vehicle listing data with each field serving specific automotive market analysis purposes:

- **Geolocation**: Geographic coordinates or location data. *Essential for regional market analysis, dealer location mapping, and geographic pricing variations.*

- **Marketplace**: Platform or marketplace identifier. *Tracks listing source and marketplace segmentation.*

- **Leasing**: Leasing availability indicator. *Important for financing analysis and identifying lease-eligible vehicles.*

- **Price Per Unit**: Unit pricing information if applicable. *Relevant for commercial vehicles or bulk listings.*

- **Pending Acceptance Audits Count**: Number of pending verifications. *Quality indicator for listing validation status.*

- **Consent**: User consent or agreement status. *Compliance and data usage metadata.*

- **Is New**: Boolean indicating if vehicle is new. *Critical filter for new vs used market segmentation.*

- **Foreign Number Plate**: Indicator of foreign registration. *Important for import analysis and cross-border vehicle trading.*

- **States**: Vehicle condition states or flags. *Details about vehicle status, damage, or special conditions.*

- **Label**: Classification labels or tags. *Additional categorization for filtering and analysis.*

- **Has Online Finance**: Boolean showing online financing availability. *Indicates dealer sophistication and financing options.*

- **Model Stub**: Model identifier or code. *Technical reference for model categorization.*

- **Thumbs**: Array of thumbnail image URLs. *Visual reference for vehicle condition and presentation quality.*

- **Registration**: Vehicle registration date. *Critical for determining actual vehicle age and depreciation analysis.*

- **SEO**: Search engine optimization metadata. *Technical metadata for listing visibility.*

- **Paid Features**: Array of premium listing features. *Indicates seller investment in listing promotion.*

- **Category IDs**: Numeric category identifiers. *System categorization for database organization.*

- **Dealer CLS**: Dealer classification status. *Distinguishes professional dealers from private sellers.*

- **ID**: Unique listing identifier. *Essential for tracking specific listings over time and duplicate detection.*

- **Category**: Human-readable category name. *Primary vehicle classification (cars, bikes, etc.).*

- **Price Debatable**: Boolean indicating negotiable pricing. *Important for understanding pricing flexibility.*

- **User ID**: Seller's user identifier. *Enables seller activity tracking and dealer inventory analysis.*

- **Thumb**: Primary thumbnail image URL. *Main visual representation for quick reference.*

- **Certificate**: Vehicle certification or inspection status. *Quality and verification indicator.*

- **Title**: Vehicle listing headline. *Primary descriptor containing make, model, and key features.*

- **Views**: Number of listing views. *Popularity metric indicating market interest.*

- **Without VAT**: Price excluding VAT information. *Important for B2B transactions and commercial buyers.*

- **Descriptive Title**: Detailed vehicle description title. *Extended information about vehicle specifications.*

- **Seller**: Seller name or company. *Identifies listing source for dealer analysis and outreach.*

- **Has Youtube**: Boolean showing YouTube video presence. *Indicates premium listing with video content.*

- **Created**: Listing creation timestamp. *Tracks listing age and market velocity.*

- **External Link**: Link to external resources. *Additional information sources or dealer websites.*

- **SEO JSON-LD**: Structured data for search engines. *Technical metadata for enhanced visibility.*

- **Compare**: Comparison feature availability. *Enables vehicle comparison functionality.*

- **Clicks**: Number of clicks or interactions. *Engagement metric showing buyer interest.*

- **Duplicate Classifieds ID**: Identifier for duplicate listings. *Helps identify republished or duplicated vehicles.*

- **URL Slug**: SEO-friendly URL identifier. *Human-readable listing reference.*

- **SEO URL**: Full SEO-optimized URL. *Complete link to listing page.*

- **Mileage**: Vehicle mileage/kilometers. *Critical specification for used vehicle valuation.*

- **Has Finance**: Boolean indicating financing availability. *Shows financing options presence.*

- **Key Features**: Array of notable vehicle features. *Highlights important specifications and equipment.*

- **Is Parked**: Boolean showing if listing is paused. *Indicates inactive or temporarily hidden listings.*

- **Price**: Vehicle price in euros. *Fundamental data point for pricing analysis and market valuation.*

- **Title Parts**: Deconstructed title components. *Structured breakdown of title information.*

- **Short Description**: Brief vehicle description. *Quick overview of vehicle highlights.*

- **Crashed**: Accident history indicator. *Critical information for vehicle condition assessment.*

- **Address Long**: Detailed address information. *Precise location for regional analysis.*

- **Thumbs Patterns**: Image pattern templates. *Technical metadata for image handling.*

- **Raw Price**: Unformatted price data. *Original price value for processing.*

- **Address**: Short-form address or location. *General location information.*

- **Own**: Ownership indicator or user relation. *Shows relationship to listing.*

- **Price Parked**: Stored price when listing is paused. *Historical pricing reference.*

- **Deleted Date**: Timestamp when listing was removed. *Tracks listing lifecycle and market velocity.*

- **Offer Type**: Type of offer (sale, trade, etc.). *Categorizes transaction type.*

- **Has Shorts**: Boolean for short-form video content. *Indicates modern media content presence.*

- **Has Certificate**: Vehicle certification presence. *Quality assurance indicator.*

- **Engine Size**: Engine displacement in cc or liters. *Key technical specification for performance analysis.*

- **Is Deleted**: Boolean showing if listing is deleted. *Status flag for active vs removed listings.*

- **Has Leasing**: Leasing option availability. *Alternative financing method indicator.*

- **Thumb Pattern**: Template for thumbnail generation. *Technical metadata for image processing.*

- **Discount**: Discount or price reduction information. *Identifies promotional pricing.*

- **From Promotion**: Boolean indicating promotional listing. *Shows special offers or campaigns.*

- **Finance Options**: Available financing methods. *Details about payment plans and financing.*

- **Dealers Only**: Restriction to dealer buyers. *B2B vs B2C classification.*

- **Modified**: Last modification timestamp. *Tracks listing updates and changes.*

- **All Final Category IDs**: Complete category hierarchy. *Detailed categorization structure.*

- **Length**: Vehicle length specification. *Physical dimension for commercial vehicles.*

- **Has 360 Photos**: 360-degree photo availability. *Premium visual content indicator.*

- **Vtype XYMA Or Part**: Vehicle type classification code. *System-specific categorization.*

- **Promotion**: Promotional campaign information. *Marketing and promotion metadata.*

- **Duplicate Classifieds**: Array of duplicate listing references. *Identifies related or republished listings.*

- **Fuel Type**: Fuel type (petrol, diesel, electric, hybrid). *Critical specification for vehicle classification and market segmentation.*

- **Has Photos**: Boolean indicating photo presence. *Basic quality indicator for listings.*

- **Suggested Category**: System-suggested categorization. *Automated classification assistance.*

- **Parked**: Listing pause status. *Indicates temporarily inactive listings.*

##### Example Output:

```json
[
  {
  "geolocation": {
    "geolocation": {
      "lat": 38.045654219844295,
      "lon": 23.774000630267174
    },
    "exact_location": false
  },
  "marketplace": null,
  "leasing": {
    "only_leasing": false,
    "default_leasing_option": null
  },
  "price_per_unit": null,
  "pending_acceptance_audits_count": 0,
  "consent": null,
  "is_new": false,
  "foreign_number_plate": false,
  "states": {
    "is_non_public": false,
    "is_deleted": false,
    "dealers_only": false,
    "is_ghosted": false,
    "is_removed": false,
    "is_unlisted": null,
    "is_dealers_only_cause_foreign": false,
    "is_hidden": false
  },
  "label": null,
  "has_online_finance": false,
  "model_stub": "Mercedes-Benz GLE 350 2021 59.000 χλμ | Plug-In Hybrid BENZINH | AMG Line/Night Package",
  "thumbs": {
    "count": 29,
    "urls": [
      "https://static.car.gr/51060553_3_m.jpg",
      "https://static.car.gr/51060553_0_m.jpg",
      "https://static.car.gr/51060553_2_m.jpg",
      "https://static.car.gr/51060553_4_m.jpg",
      "https://static.car.gr/51060553_k_m.jpg",
      "https://static.car.gr/51060553_a_m.jpg",
      "https://static.car.gr/51060553_h_m.jpg",
      "https://static.car.gr/51060553_b_m.jpg",
      "https://static.car.gr/51060553_j_m.jpg",
      "https://static.car.gr/51060553_9_m.jpg",
      "https://static.car.gr/51060553_f_m.jpg",
      "https://static.car.gr/51060553_e_m.jpg",
      "https://static.car.gr/51060553_c_m.jpg",
      "https://static.car.gr/51060553_1_m.jpg",
      "https://static.car.gr/51060553_5_m.jpg",
      "https://static.car.gr/51060553_7_m.jpg",
      "https://static.car.gr/51060553_q_m.jpg",
      "https://static.car.gr/51060553_v_m.jpg",
      "https://static.car.gr/51060553_w_m.jpg",
      "https://static.car.gr/51060553_t_m.jpg",
      "https://static.car.gr/51060553_u_m.jpg",
      "https://static.car.gr/51060553_p_m.jpg",
      "https://static.car.gr/51060553_r_m.jpg",
      "https://static.car.gr/51060553_s_m.jpg",
      "https://static.car.gr/51060553_x_m.jpg",
      "https://static.car.gr/51060553_y_m.jpg",
      "https://static.car.gr/51060553_A_m.jpg",
      "https://static.car.gr/51060553_z_m.jpg",
      "https://static.car.gr/51060553_o_m.jpg"
    ]
  },
  "registration": "9 / 2021",
  "seo": {
    "item_type": null,
    "item_prop": null,
    "name": null
  },
  "paid_features": {
    "is_promotion_enabled": true,
    "is_paid_classified": false,
    "is_paid_one_click_auto_touch_enabled": false
  },
  "category_ids": [
    20001,
    15000,
    15001,
    15218
  ],
  "dealer_cls": false,
  "id": 51060553,
  "category": "Αυτοκίνητο » Suv / Crossover / 4x4",
  "price_debatable": false,
  "user_id": 1001033314,
  "thumb": "https://static.car.gr/51060553_3_n.jpg",
  "certificate": {
    "is_public_available": true,
    "requested_by_user_id": 1001033314,
    "created": "2026-01-13 15:37:09"
  },
  "title": "Mercedes-Benz GLE 350 2021 59.000 χλμ | Plug-In Hybrid BENZINH | AMG Line/Night Package",
  "views": "-",
  "without_vat": false,
  "descriptive_title": "Mercedes-Benz GLE 350 2021 59.000 χλμ | Plug-In Hybrid BENZINH | AMG Line/Night Package - 9 / 2021 - 59.000 χλμ - Υβριδικό plug-in βενζίνη - 1.991 cc - 333 hp - 5 - Αυτόματο - Suv / Crossover / 4x4",
  "seller": {
    "name": "",
    "verification": {
      "telephone_verified": true,
      "credit_card_verified": false
    },
    "address": "ΝΕΟ ΗΡΑΚΛΕΙΟ Ν. ΑΤΤΙΚΗΣ 14121",
    "type": "Guest",
    "id": 1001033314,
    "avatar": null
  },
  "has_youtube": true,
  "created": "2025-12-27 13:53:38",
  "external_link": null,
  "seo_json_ld": {
    "url": "/classifieds/cars/view/51060553-mercedes-benz-gle-350",
    "@type": "Car"
  },
  "compare": {
    "is_in_comparison": false,
    "is_comparable": true
  },
  "clicks": "-",
  "duplicate_classifieds_id": 250848,
  "url_slug": "mercedes-benz-gle-350",
  "seo_url": "/classifieds/cars/view/51060553-mercedes-benz-gle-350?from-promotion=1",
  "mileage": "59.000 χλμ",
  "has_finance": false,
  "key_features": [
    {
      "key": "mileage",
      "value": "59.000 Km",
      "label": "Χιλιόμετρα"
    },
    {
      "label": "Κυβικά",
      "key": "engine_size",
      "value": "1.991 cc",
      "extra": null
    },
    {
      "key": "engine_power",
      "value": "333 hp",
      "label": "Ιπποδύναμη"
    },
    {
      "label": "Σασμάν",
      "key": "gearbox_type",
      "value": "Αυτόματο",
      "extra": null
    },
    {
      "key": "fuel_type",
      "value": "Υβριδικό plug-in βενζίνη",
      "label": "Καύσιμο"
    }
  ],
  "is_parked": false,
  "price": "63.499 €",
  "title_parts": {
    "category": null,
    "make": "Mercedes-Benz",
    "variant": "59.000 χλμ | Plug-In Hybrid BENZINH | AMG Line/Night Package",
    "model": "GLE 350",
    "year": 2021
  },
  "short_description": null,
  "crashed": false,
  "address_long": "ΝΕΟ ΗΡΑΚΛΕΙΟ Ν. ΑΤΤΙΚΗΣ 14121",
  "thumbs_patterns": {
    "stretch": {
      "list": false,
      "gallery": false
    },
    "count": 29,
    "urls": [
      "https://static.car.gr/51060553_3_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_0_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_2_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_4_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_k_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_a_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_h_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_b_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_j_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_9_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_f_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_e_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_c_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_1_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_5_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_7_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_q_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_v_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_w_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_t_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_u_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_p_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_r_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_s_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_x_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_y_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_A_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_z_%7Bsize%7D.jpg",
      "https://static.car.gr/51060553_o_%7Bsize%7D.jpg"
    ]
  },
  "raw_price": 63499,
  "address": "ΝΕΟ ΗΡΑΚΛΕΙΟ 14121",
  "own": false,
  "price_parked": "",
  "deleted_date": null,
  "offertype": "sale",
  "has_shorts": false,
  "has_certificate": true,
  "engine_size": "1.991 cc",
  "is_deleted": false,
  "has_leasing": false,
  "thumb_pattern": "https://static.car.gr/51060553_3_%7Bsize%7D.jpg",
  "discount": null,
  "from_promotion": true,
  "finance_options": null,
  "dealers_only": false,
  "modified": "2026-01-14 08:13:19",
  "all_final_category_ids": [
    15218
  ],
  "length": null,
  "has360photos": false,
  "vtype_xyma_or_part": "car",
  "promotion": {
    "available": true,
    "previous_promotions_count": 2,
    "active_promotion": {
      "available": true,
      "tier_days": 3,
      "is_promoted": true,
      "expires": "2026-01-16 16:15:42",
      "cost": 220,
      "tier": "super"
    },
    "preferred_payment": "stripe"
  },
  "duplicate_classifieds": null,
  "fueltype": "Υβριδικό plug-in βενζίνη",
  "has_photos": true,
  "suggested_category": null,
  "parked": "-",
  "from_url": "https://www.car.gr/classifieds/cars/?q=suv&condition=used&sort=pra&pg=1"
}
]
```

### Usage Guide

#### Option 1: Scraping with URLs

To use the scraper with URLs, navigate to Car.gr and perform vehicle searches using the platform's extensive filters for category, brand, model, price range, year, mileage, location, and technical specifications. Copy resulting URLs into the `urls` array.

Configure your JSON with appropriate retry limits and proxy settings. Set reasonable `max_items_per_url` values to balance extraction speed with system stability. Enable `ignore_url_failures` to prevent single URL failures from stopping the entire automotive data collection job.

**Best practices:**

- Test URLs from different vehicle categories individually before batch processing
- Monitor for blocked requests and adjust proxy settings accordingly
- Keep backup lists as Car.gr URLs may change structure with site updates
- Use category-specific URLs for focused vehicle data collection
- Include filter parameters in URLs for precise targeting

**Troubleshooting:**

- Adjust proxy settings if encountering access restrictions
- Reduce retry counts for persistent timeout issues
- Verify URL formats match current Car.gr structure
- Check that URLs contain valid category and filter parameters
- Ensure page numbers in URLs are within available range

#### Option 2: Scraping with Search Filters

Use search filters to automatically generate vehicle searches without manually creating URLs. This method excels for systematic automotive data collection across categories, brands, and conditions.

**Step 1: Select Vehicle Type**

Choose your target vehicle category using the `vehical_type` parameter:

- **Cars** (`"cars"`): Passenger vehicles, SUVs, crossovers - the largest marketplace segment
- **Bikes** (`"bikes"`): Motorcycles, scooters, ATVs - popular Greek transportation
- **Commercials** (`"commercials"`): Vans, trucks, commercial vehicles - business segment
- **Campers** (`"campers"`): Motorhomes, camper vans - tourism and recreation
- **Bicycles** (`"bicycles"`): Bicycles, e-bikes - growing urban mobility
- **Hobby** (`"hobby"`): Specialty and recreational vehicles
- **Boats** (`"boats"`): Watercraft, yachts - significant Greek market

**Step 2: Define Vehicle Condition**

Set the `vehical_state` parameter:

- Leave empty (`""`) for all vehicles (comprehensive market view)
- `"used"` for used vehicles only (largest market segment)
- `"new"` for new vehicles only (dealer inventory and pricing)

**Step 3: Enter Search Keyword**

Define search terms in the `keyword` parameter:

- **Brand searches**: "BMW", "Mercedes", "Toyota", "Volkswagen"
- **Model searches**: "Golf", "Corolla", "X5", "C-Class"
- **Specific variants**: "BMW 320d", "Mercedes E200", "Audi A4 Quattro"
- **Vehicle features**: "4x4", "automatic", "diesel", "hybrid"
- **Motorcycles**: "Yamaha MT-07", "Honda CB500", "BMW GS"

**Step 4: Configure Sorting**

Set the `sort_by` parameter based on research objectives:

- **Price analysis**: `"pra"` (cheap first) or `"prd"` (expensive first)
- **Recent listings**: `"dm"` (newest classified) or `"cr"` (latest entries)
- **Vehicle age**: `"red"` (newest vehicles) or `"rea"` (oldest vehicles)
- **Mileage analysis**: `"mia"` (lowest km) or `"mid"` (highest km)
- **Performance**: `"pod"` (highest HP) or `"poa"` (lowest HP)
- **Market popularity**: `"popularity"` for trending listings
- **Alphabetical**: `"ma"` for brand/model organization

**Step 5: Set Pagination**

Configure the `page` parameter:

- Set to `1` for beginning of search results
- Use incremental values to continue through results
- Plan pagination based on `max_items_per_url` setting
- Resume interrupted scrapes by setting to last collected page

##### Best Practices for Filter-Based Vehicle Scraping

**Vehicle Type Strategy:**

- Start with `"cars"` for mainstream automotive market analysis
- Use `"commercials"` for business vehicle and fleet research
- Select `"bikes"` for two-wheeler market intelligence
- Choose specific types for targeted niche market research

**Keyword Optimization:**

- Use exact model names for precise targeting
- Include generation or year for specific model variants
- Add transmission type (automatic/manual) for refined results
- Combine brand and features for comprehensive searches
- Test keywords on Car.gr directly before bulk scraping

**Condition-Based Analysis:**

- Use `"used"` for secondary market pricing trends
- Select `"new"` for dealer inventory and MSRP analysis
- Leave empty for complete market coverage comparison
- Compare new vs used pricing for depreciation analysis

**Sorting for Different Objectives:**

- **Pricing research**: Sort by price (ascending/descending) to identify market ranges
- **Market velocity**: Sort by listing age to track turnover rates
- **Vehicle condition**: Sort by mileage to analyze usage patterns
- **Performance analysis**: Sort by horsepower for segment comparison
- **Popularity tracking**: Use popularity sort to identify trending models

##### Data Validation and Quality Control

After extraction, verify:

- Vehicle specifications match search criteria (type, condition, keyword)
- Prices are within expected ranges for vehicle category and age
- Mileage readings are reasonable for vehicle registration year
- Location data is properly formatted for Greek regions
- Images and media references are accessible
- No duplicate listings across multiple scrapes
- Dealer vs private seller classification is accurate
- Registration dates align with new/used classification

##### Common Issue Resolution

**Empty Results:**

- Verify keywords match terminology used on Car.gr
- Check vehicle type selection matches search intent
- Try broader search terms if specific queries return nothing
- Test search parameters on Car.gr website directly first
- Ensure combination of filters doesn't over-restrict results

**Pagination Issues:**

- Track page numbers to avoid gaps in data collection
- Adjust `max_items_per_url` based on total available results
- Handle end-of-results gracefully when pages exceed available data
- Use consistent page increments for systematic coverage
- Monitor for dynamic result counts that may change

**Filter Combination Problems:**

- Some filter combinations may yield no results
- Verify vehicle type supports selected condition (new/used)
- Check that sorting options are valid for selected category
- Test filter combinations on website before scraping
- Adjust one filter at a time to identify conflicts

**Proxy Configuration:**

- Use Greek proxies for optimal Car.gr access
- Enable residential proxies for better detection avoidance
- Rotate proxies if encountering rate limiting
- Monitor proxy performance across different vehicle categories
- Consider time of day for Greek market access patterns

##### Advanced Vehicle Market Research Techniques

**Comprehensive Market Analysis:**

- Run parallel scrapes across all vehicle types for complete market view
- Track listing volume by category to identify market segments
- Monitor price distributions across vehicle types
- Compare dealer vs private seller ratios by category
- Analyze geographic distribution of vehicle inventory

**Pricing Intelligence:**

- Extract same model across different conditions (new/used)
- Track price changes for identical listings over time
- Compare pricing across different Greek regions
- Analyze dealer markup vs private seller pricing
- Identify underpriced vehicles for investment opportunities

**Dealer Inventory Monitoring:**

- Filter by dealer classification to track professional inventory
- Monitor specific dealer user IDs for competitive intelligence
- Track dealer premium feature usage patterns
- Analyze dealer pricing strategies by region
- Identify high-volume dealers and market leaders

**Seasonal and Trend Analysis:**

- Schedule regular scrapes to track seasonal price variations
- Monitor new listing velocity by month and season
- Identify emerging vehicle segments and models
- Track electric/hybrid vehicle adoption trends
- Analyze tourism-related vehicle categories (campers, boats)

**Geographic Market Segmentation:**

- Extract data by major Greek cities (Athens, Thessaloniki, Patras)
- Compare urban vs rural vehicle preferences
- Analyze island markets for specific vehicle types
- Track regional price variations for same models
- Identify geographic gaps in vehicle availability

**Technical Specification Analysis:**

- Focus on engine size distribution by vehicle category
- Track fuel type trends (diesel, petrol, electric, hybrid)
- Analyze transmission preferences (manual vs automatic)
- Monitor mileage patterns by vehicle age
- Compare performance specifications across price segments

### Benefits and Applications

The Car.gr Vehicle Search Scraper delivers significant time savings for automotive market research, reducing days of manual browsing into hours of automated extraction. This efficiency enables focus on analysis and strategic decision-making rather than data gathering.

**Primary Applications:**

**Automotive Dealer Intelligence:** Monitor competitor inventory, track pricing strategies across dealers, analyze dealer locations and market coverage, identify high-performing dealerships, and benchmark your inventory against market standards.

**Vehicle Pricing Analysis:** Track market prices for specific makes and models, analyze depreciation rates across vehicle segments, identify pricing anomalies and opportunities, monitor price trends over time, and establish competitive pricing strategies.

**Import/Export Market Research:** Identify high-demand vehicles in Greek market, analyze foreign plate vehicle presence, track import trends and popular imported brands, compare Greek prices to other European markets, and identify export opportunities.

**Fleet Management Research:** Analyze commercial vehicle availability and pricing, track van and truck market inventory, monitor leasing and financing options, identify bulk purchase opportunities, and benchmark fleet vehicle costs.

**Investment and Arbitrage:** Identify underpriced vehicles for resale, track market inefficiencies across regions, monitor auction and quick-sale opportunities, analyze dealer liquidation patterns, and discover cross-border arbitrage potential.

**Market Trend Analysis:** Track electric and hybrid vehicle adoption in Greece, monitor motorcycle and scooter market trends, analyze boat and marine market seasonality, identify emerging vehicle categories, and forecast market demand shifts.

**The scraper provides competitive advantages through:**

- Comprehensive vehicle data across all major categories
- Detailed specifications including mileage, engine size, fuel type
- Dealer vs private seller classification for market segmentation
- Multimedia content indicators for listing quality assessment
- Geographic data for regional market analysis
- Financing and leasing indicators for purchase option analysis
- Scalable extraction supporting both narrow model research and broad market studies

Structured output integrates seamlessly with automotive pricing tools, CRM systems, inventory management platforms, and business intelligence tools, enabling immediate use for market analysis, competitive research, pricing optimization, and business development across Greek automotive markets.

### Conclusion

The Car.gr Vehicle Search Scraper transforms manual automotive marketplace research into efficient automated data collection. By providing structured access to Greece's largest vehicle marketplace, it empowers dealers, researchers, and businesses to make data-driven decisions about inventory, pricing, market entry, and competitive positioning.

Whether monitoring used car prices in Athens, tracking motorcycle trends, analyzing commercial vehicle inventory, researching boat market seasonality, or conducting comprehensive Greek automotive market intelligence, this scraper provides systematic extraction capabilities to accelerate business intelligence gathering.

Ready to streamline your Car.gr data collection? Start extracting valuable automotive marketplace insights today and transform your Greek vehicle market research capabilities.

## Your feedback

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

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the vehicles list page urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped after the maximum number of retries is reached.

## `keyword` (type: `string`):

Enter the keyword to search for items

## `vehical_type` (type: `string`):

Enter the vehical type to search for items

## `vehical_state` (type: `string`):

Enter the vehical state to search for items

## `sort_by` (type: `string`):

Filter items by (e.g., price, year, etc.)

## `page` (type: `integer`):

Specify the page number to start scraping from

## `max_items_per_url` (type: `integer`):

Limit the number of items per URL or search filters you want to scrape

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL or search filters if the scrape is detected as a bot or the page fails to load

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://www.car.gr/classifieds/cars/?category=15001&pg=1&q=suv&sort=prd"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# 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 = {
    "urls": [
        "https://www.car.gr/classifieds/cars/?category=15001&pg=1&q=suv&sort=prd"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/car-gr-vehicles-search-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 = {
    "urls": ["https://www.car.gr/classifieds/cars/?category=15001&pg=1&q=suv&sort=prd"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/car-gr-vehicles-search-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 '{
  "urls": [
    "https://www.car.gr/classifieds/cars/?category=15001&pg=1&q=suv&sort=prd"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call ecomscrape/car-gr-vehicles-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ecomscrape/car-gr-vehicles-search-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/sbGTGJEpr6GADleYV/builds/aaS1V4cl2kUCkEOMV/openapi.json