# Autohebdo Automotive Search Scraper (`stealth_mode/autohebdo-automotive-search-scraper`) Actor

Scrape detailed automotive listings from AutoHebdo.net with precision. Collect vehicle information, pricing, availability, seller details, and 30+ data fields per listing — perfect for dealers, market researchers, and automotive data platforms.

- **URL**: https://apify.com/stealth\_mode/autohebdo-automotive-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

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/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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

## AutoHebdo Automotive Scraper: Extract Vehicle Listings & Pricing Data

---

### What Is AutoHebdo (autotrader.ca)?

AutoHebdo.net is a major French automotive marketplace specializing in used vehicle (occasion) listings. It aggregates thousands of cars from dealers and private sellers, complete with pricing, specifications, images, and availability status. Extracting this data manually is tedious and error-prone — the **AutoHebdo Automotive Scraper** automates the process, delivering clean, structured vehicle records at scale.

---

### Overview

The **AutoHebdo Automotive Scraper** extracts search result pages and detail listings from AutoHebdo.net, transforming raw HTML into machine-readable vehicle data. It is designed for:

- **Car dealerships** monitoring competitor inventory and pricing strategies
- **Market researchers** analyzing used vehicle trends and price movements
- **Aggregator platforms** feeding automotive inventory into multi-listing services
- **Price intelligence tools** building automotive cost benchmarks
- **Data analysts** studying the French automotive secondary market

Key strengths include pagination support, high-volume collection (up to 200 items per URL), and resilience via `ignore_url_failures` for uninterrupted bulk scraping.

---

### Input Format

The scraper accepts a JSON configuration object with three main parameters:

```json
{
  "urls": [
    "https://www.autohebdo.net/autos/ot_occasion?page=2&atype=C&search_id=yxntbf9v1p&source=listpage_pagination"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

| Parameter | Type | Description |
|---|---|---|
| `urls` | Array | AutoHebdo.net (autotrader.ca) search result URLs or paginated listing pages. You can add multiple URLs to scrape across different searches, pages, or filters. |
| `ignore_url_failures` | Boolean | If `true`, the scraper continues processing remaining URLs even if some fail. Recommended for large batch runs. |
| `max_items_per_url` | Integer | Maximum number of vehicle listings to extract per URL (e.g., `200`). Useful for controlling data volume and API quotas. |

> **Tip:** Extract the full search URL including query parameters (`page`, `atype`, `search_id`) to capture filtered results accurately.

***

### Output Format

**Sample output**

```json
{
  "id": "67a10ff9-529f-47e8-bbb3-49fd94016761",
  "identifier": {
    "legacy_id": null,
    "cross_reference_id": "70592156"
  },
  "cross_reference_id": "70592156",
  "images": [
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_7fb1de76-c479-4b85-b33f-66fdccc0ddc4.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_402a3567-c889-48a8-ae8e-376c6a94f91c.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_60d7cb70-02cf-4b88-b2f5-5f82d8e6b109.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_c47c289e-33d8-4a40-af99-6565d5eab3df.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_eb76daaa-79e9-456b-9037-ee7efca86662.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_26f939c0-9fa5-4107-ae29-a95b63579c67.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_20ae14a2-e675-4979-995f-b5ed5e0bb87e.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_006b5489-1921-4f84-aa05-c11f9ff714c1.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_d317520c-96ba-4cd8-963d-7610b8d47fb7.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_009c131d-1429-4109-bf68-5eaad806dc44.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_b45f24a8-dda8-48a2-8374-0be192183508.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_651fe135-6eae-4e0b-ae3e-908904b002eb.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_33a0f8c0-2e38-41fc-9a86-c85d1970c049.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_a894ded3-b27e-4968-8f9d-40dc8e7037f8.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_ec750cee-1c78-4c25-9ae4-d59ba4623848.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_d691ad43-be16-4414-bcb8-2c9e3edab6ba.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_04e958f2-1d21-4408-870e-a833ddc24d96.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_752cf4f8-e6f0-4d27-9bbe-2589d06f762b.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_87890dec-c8e2-480a-9bb7-a40ad3cb0e5a.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_fbf3141a-c62d-4e3d-ae04-917ed3badce9.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_eb59c897-41c1-4f6f-9632-a76453419d37.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_f4d12496-2804-420b-bb45-f0407f9d1ebb.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_1ac1aa57-7bc9-4626-92cb-109ba21b09f9.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_67cc0a5d-f6be-41b1-abfb-eb3a92cc3f11.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_30da8971-e0c0-42a2-af04-1b54bcf19276.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_b1c35c39-d1d6-4f9f-ae5d-fc44c0f905c6.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_2a53e7e0-69c2-4731-aa20-2d809e569b2b.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_8988f2bb-ef0e-4ea0-b314-7f314fd784a6.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_7e7bc507-1ef8-456f-b039-b5750a4a9438.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_ddda5a56-769b-44e4-8da9-b1c46f0c0661.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_a31a324f-fb66-4665-8dc9-960380d69aa3.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_1ffcdf74-fc2b-411c-b6c2-c7f297ac0d05.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_cf966e7e-d378-48d6-96a8-64a652f74907.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_53a48fe9-80d3-411b-bb0d-2fabdc015f95.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_89b62c56-28cc-4909-8e96-0919fa5cb8fc.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_96b11bc5-46fe-4ab4-8782-b5a6b546260b.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_0f22a5a0-8299-4dc7-9716-68cefa4a29a6.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_8a024747-1768-49c3-92d7-e5b71e6c7c80.jpg/250x188.webp",
    "https://prod.pictures.autoscout24.net/listing-images/67a10ff9-529f-47e8-bbb3-49fd94016761_bf068e1e-5f80-4c63-a852-4610647ddfa6.jpg/250x188.webp"
  ],
  "description": "2022 Honda Accord Sport 2.0T Automatic<br />Enjoy the perfect blend of performance, comfort, and technology in this 2022 Honda Accord Sport 2.0T Automatic. Powered by a 252-horsepower 2.0L turbocharged engine paired with a 10-speed automatic transmission, it delivers a smooth yet exciting driving experience. Inside, you ll find a spacious, well-appointed cabin with Apple CarPlay®, Android Auto, heated front seats, and Honda Sensing® safety features, making every drive comfortable, connected, and confident.<br /><br />Whether you re commuting, taking a road trip, or simply enjoying the drive, this 2022 Honda Accord Sport 2.0T offers an exceptional combination of performance, comfort, technology, and reliability.<br />Key Features:<br /><ul><li>252-hp 2.0L turbocharged 4-cylinder engine<br />* 10-speed automatic transmission<br />* Front-wheel drive<br />* 19-inch alloy wheels<br />* Lane keep asst<br />* Blind spot monitoring<br />* Adaptive cruise control<br />* Sunroof<br />* Apple CarPlay® &amp; Android Auto<br />* Heated front seats<br />* Dual-zone automatic climate control<br />* Remote start<br />* Push-button start with Smart Entry<br />* Bluetooth® hands-free connectivity<br />* Honda Sensing® driver-assist technologies<br />* Multi-angle rearview camera<br />* LED headlights and taillights<br />Don t miss your opportunity to own one of t he most refined and fun-to-drive midsize sedans on the market. Contact us today to book your test drive!<br /><br />ELITE FINE CARS: THE GOLD STANDARD IN AUTOMOTIVE EXCELLENCE<br />At Elite Fine Cars, we don t just sell vehicles we curate a collection. Whether you are seeking the raw adrenaline of a rare exotic or the refined reliability of a premium daily driver, our mission remains the same: to provide an automotive acquisition experience defined by integrity, transparency, and absolute excellence.<br />As a family-owned boutique dealership, we understand that a vehicle is more than a purchase its an investment in your lifestyle. Our climate-controlled indoor showroom offers a sophisticated, pressure-free environment where you can explore our meticulously reconditioned inventory at your own pace.<br /><br />OUR BESPOKE SERVICES<br />We provide a comprehensive suite of services designed to make your transition into a new vehicle seamless:<br /><br />Tailored Financing &amp; Leasing: Our on-site credit specialists work with a premier network of lenders to secure competitive rates and flexible terms that align with your financial goals. (Note: A loan processing fee of $1399 may apply to select options).<br />Professional Evaluations: Looking to upgrade? We offer high-accuracy trade-in assessments and instant cash offers for quality pre-owned vehicles.<br />Precision Reconditioning: Every vehicle in our care undergoes a rigorous aesthetic and mechanical preparation process to ensure it meets our exacting standards before it reaches your driveway.<br /><br />CERTIFICATION &amp; SAFETY COMMITMENT<br />In compliance with OMVIC regulations, vehicles are initially offered in their current condition. For discerning clients who demand peak performance and peace of mind, we offer a Comprehensive Certification Package for $999. This service ensures your vehicle not only meets Ontario Safety Standards but exceeds our own internal benchmarks for mechanical integrity.<br /><br />CONNECT WITH US<br />Experience the difference that expertise and passion make. Your next extraordinary drive begins here.<br />Visit Us: 1310 Dundas St E, Unit #18, Mississauga, ON L4Y 2C1<br />Call:</li></ul>",
  "ocs_images_a": [],
  "is_offer_new": true,
  "external_customer_id": "20231227174356018",
  "price": {
    "price_formatted": "27 888 $",
    "suggested_retail_price": "38 470 $",
    "price_evaluation": 1,
    "is_vat_label_legally_required": false,
    "price_raw": 27888,
    "is_price_evaluation_enabled": true,
    "is_conditional_price": false
  },
  "available_now": true,
  "availability": {
    "from_date": null,
    "in_days": null
  },
  "super_deal": {
    "old_price_formatted": "",
    "is_eligible": false
  },
  "url": "https://www.autohebdo.net/annonces/honda-accord-sport-2-0-auto-essence-rouge-cat_ma31gr200625va2443mt7001tr7209-67a10ff9-529f-47e8-bbb3-49fd94016761",
  "vehicle": {
    "article_type": "Car",
    "type": "Car",
    "make": "Honda",
    "model": "Accord",
    "model_group": "Accord",
    "variant": "Accord Sedan",
    "model_id": 1773,
    "model_version_input": "Sport 2.0 Auto",
    "subtitle": null,
    "offer_type": "U",
    "model_year": 2022,
    "transmission": "Automatique",
    "fuel": "Essence",
    "mileage_in_km": "32 978 km",
    "engine_displacement_in_c_c_m": "2 000 cm³",
    "is_currently_damaged": false
  },
  "location": {
    "country_code": "CA",
    "province_code": "ON",
    "zip": "L4Y1M6",
    "city": "Mississauga",
    "street": "171819-131 DUNDAS ST EAST"
  },
  "seller": {
    "dealer": {
      "max_images": 50,
      "is_freespee_call_tracking_enabled": true,
      "culture": "en-CA"
    },
    "id": "47946011",
    "type": "Dealer",
    "company_name": "ELITE FINE CARS INC.",
    "links": {
      "info_page": "https://www.autoscout24.com/dealerinfo/elite-fine-cars-inc-mississauga?atype=C",
      "imprint": "https://www.autoscout24.com/dealerinfo/elite-fine-cars-inc-mississauga/imprint"
    },
    "phones": [
      {
        "phone_type": "Office",
        "formatted_number": "888-857-0498",
        "call_to": "+18888570498"
      }
    ]
  },
  "applied_ad_tier": "T10",
  "ad_tier": "T10",
  "is_ocs": false,
  "special_conditions": [],
  "statistics": {
    "leads_range": "Zero"
  },
  "search_result_type": "Organic",
  "search_result_section": "Main",
  "tracking": {
    "first_registration": "unknown",
    "fuel_type": "b",
    "image_content": "no-placeholder|0.215006123381542",
    "is_smyle_eligible": "unknown",
    "mileage": "32978",
    "price_label": "top-price",
    "price": "27888",
    "order_bucket": "unknown",
    "model_taxonomy": "[make_id:31, model_group_id:200625, variant_id:2443, generation_id:, motortype_id:7001, trim_id:7209];"
  },
  "cover_image_attractiveness": 0.215006123381542,
  "vehicle_details": [
    {
      "data": "32 978 km",
      "icon_name": "mileage_odometer",
      "aria_label": "Kilométrage"
    },
    {
      "data": "Automatique",
      "icon_name": "gearbox",
      "aria_label": "Boîte"
    },
    {
      "data": "- (Année)",
      "is_placeholder": true,
      "icon_name": "calendar",
      "aria_label": "1ère immatriculation"
    },
    {
      "data": "Essence",
      "icon_name": "gas_pump",
      "aria_label": "Carburant"
    },
    {
      "data": "190 kW (255 ch)",
      "icon_name": "speedometer",
      "aria_label": "Puissance kW (CH)"
    }
  ],
  "wltp_values": [
    "- (l/100 km)",
    "- (g/km)"
  ],
  "tracking_parameters": [
    {
      "key": "boost_level",
      "value": "b1"
    },
    {
      "key": "applied_boost_level",
      "value": "b1"
    },
    {
      "key": "relevance_adjustment",
      "value": "boost"
    },
    {
      "key": "boosting_product",
      "value": "total_boost"
    }
  ],
  "from_url": "https://www.autohebdo.net/autos/ot_occasion?page=2&atype=C&search_id=yxntbf9v1p&source=listpage_pagination"
}
```

Each scraped vehicle record contains 30+ fields organized by category:

#### Core Identification & Metadata

| Field | Meaning |
|---|---|
| `ID` | Unique identifier assigned by AutoHebdo to the listing |
| `Identifier` | Secondary unique reference for the vehicle record |
| `Cross Reference ID` | External ID linking to inventory management systems |
| `URL` | Direct link to the vehicle detail page on AutoHebdo |

#### Pricing & Availability

| Field | Meaning |
|---|---|
| `Price` | Listed selling price in euros |
| `Super Deal` | Flag indicating whether the listing is marked as a special/discounted offer |
| `Available Now` | Boolean indicating immediate availability |
| `Availability` | Detailed availability status (e.g., in stock, on order) |
| `Special Conditions` | Notes on restricted sale, trade-in requirements, or other terms |

#### Vehicle Images & Media

| Field | Meaning |
|---|---|
| `Images` | Array of image URLs for the vehicle |
| `OCS Images A` | High-quality images from the OCS (Official Content Service) |
| `Cover Image Attractiveness` | Quality score of the primary listing image |

#### Vehicle Information

| Field | Meaning |
|---|---|
| `Vehicle` | Core vehicle object containing make, model, year, body type |
| `Vehicle Details` | Detailed specifications (engine, transmission, fuel type, mileage) |
| `WLTP Values` | Emissions and fuel efficiency metrics (WLTP standard) |
| `Description` | Full HTML or text description of the vehicle condition and features |

#### Market & Seller Data

| Field | Meaning |
|---|---|
| `Seller` | Dealer or private seller information |
| `Location` | Geographic location of the vehicle |
| `Applied Ad Tier` | Current advertising boost level applied by the seller |
| `Ad Tier` | Available tier options for this listing |
| `Is OCS` | Whether listing includes official content (OCS) |

#### Performance & Tracking

| Field | Meaning |
|---|---|
| `Statistics` | View counts and engagement metrics |
| `Search Result Type` | Listing type in search results (e.g., featured, standard) |
| `Search Result Section` | Section placement within search results |
| `Tracking` | Event tracking parameters |
| `Tracking Parameters` | UTM-style parameters for campaign tracking |

#### Flags & Categories

| Field | Meaning |
|---|---|
| `Is Offer New` | Whether the listing is newly posted |
| `External Customer ID` | Third-party seller or inventory system ID |

***

### How to Use

1. **Find search URLs** — Navigate to AutoHebdo.net, apply filters (price range, location, vehicle type), and copy the full URL from the search results page or paginated results.
2. **Configure input** — Paste URLs into the `urls` array. Set `max_items_per_url` (e.g., 200 for full page scraping).
3. **Enable resilience** — Set `ignore_url_failures: true` to handle any transient failures gracefully.
4. **Run the scraper** — Start the actor and monitor progress in the logs.
5. **Download results** — Export data as JSON, CSV, or integrate directly into your database.

**Common tips:**

- Include pagination parameters in the URL (e.g., `?page=2`) to scrape specific result pages.
- Use filter parameters in the URL (`atype=C` for cars) to target specific vehicle types.
- For large datasets, split URLs across multiple runs to avoid timeouts.

***

### Use Cases & Business Value

- **Competitive intelligence:** Monitor dealer inventory, pricing trends, and promotional tactics in real-time
- **Market analysis:** Track used vehicle price movements, supply levels, and demand patterns across regions
- **Lead generation:** Identify newly listed vehicles or specific models for targeted marketing campaigns
- **Inventory management:** Synchronize external AutoHebdo listings with internal dealer systems
- **Price benchmarking:** Build historical pricing databases for valuation and negotiation insights

The AutoHebdo Automotive Scraper transforms marketplace data into actionable business intelligence, enabling faster decision-making and competitive advantage in the automotive trade.

***

### Conclusion

The **AutoHebdo Automotive Scraper** is your solution for extracting automotive market data at scale. With 30+ fields per listing and support for high-volume collection, it eliminates tedious manual work and delivers the structured data you need for research, pricing analysis, and inventory management.

# Actor input Schema

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

Add the URLs of the auctions 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.

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

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.autohebdo.net/autos/ot_occasion?page=2&atype=C&search_id=yxntbf9v1p&source=listpage_pagination"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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.autohebdo.net/autos/ot_occasion?page=2&atype=C&search_id=yxntbf9v1p&source=listpage_pagination"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/autohebdo-automotive-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.autohebdo.net/autos/ot_occasion?page=2&atype=C&search_id=yxntbf9v1p&source=listpage_pagination"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/autohebdo-automotive-search-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 '{
  "urls": [
    "https://www.autohebdo.net/autos/ot_occasion?page=2&atype=C&search_id=yxntbf9v1p&source=listpage_pagination"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/autohebdo-automotive-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=stealth_mode/autohebdo-automotive-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Autohebdo Automotive Search Scraper",
        "description": "Scrape detailed automotive listings from AutoHebdo.net with precision. Collect vehicle information, pricing, availability, seller details, and 30+ data fields per listing — perfect for dealers, market researchers, and automotive data platforms.",
        "version": "0.0",
        "x-build-id": "jz666Fz4QVpcGficL"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~autohebdo-automotive-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-autohebdo-automotive-search-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/stealth_mode~autohebdo-automotive-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-autohebdo-automotive-search-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/stealth_mode~autohebdo-automotive-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-autohebdo-automotive-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "urls": {
                        "title": "URLs of the auctions urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the auctions urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "ignore_url_failures": {
                        "title": "Continue running even if some URLs fail to be scraped",
                        "type": "boolean",
                        "description": "If true, the scraper will continue running even if some URLs fail to be scraped."
                    },
                    "max_items_per_url": {
                        "title": "Max items per URL",
                        "type": "integer",
                        "description": "The maximum number of items to scrape per URL."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
