# Carroya Cars Search Scraper (`stealth_mode/carroya-cars-search-scraper`) Actor

Scrape Carroya.com car listings with 100+ data fields per vehicle — price, mileage, seller info, specs, photos, and more. Perfect for automotive dealers, market analysts, and price comparison platforms targeting the Colombian used car market.

- **URL**: https://apify.com/stealth\_mode/carroya-cars-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, NaN 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.md):

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

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Carroya.com Cars Scraper: Extract Colombia Auto Listings at Scale

**Excerpt:** Scrape Carroya.com car listings with 100+ data fields per vehicle — price, mileage, seller info, specs, photos, and more. Perfect for automotive dealers, market analysts, and price comparison platforms targeting the Colombian used car market.

---

### What Is Carroya.com?

Carroya.com is one of Colombia's most popular online automotive marketplaces, connecting private sellers and dealerships with buyers searching for new and used vehicles. The platform hosts thousands of listings across cars, trucks, and SUVs, with rich metadata per vehicle. Manually collecting this data is impractical at scale — the **Carroya.com Cars Scraper** automates extraction from search result pages, delivering structured, analysis-ready records.

---

### Overview

The **Carroya Cars Scraper** processes paginated search listing URLs from Carroya.com and returns comprehensive vehicle records with 100+ fields covering specs, pricing, seller details, media, and listing metadata.

Ideal for:

- **Automotive dealers** monitoring competitor pricing and inventory
- **Price comparison platforms** aggregating Colombian car market data
- **Market researchers** analyzing demand trends by brand, city, or fuel type
- **Data engineers** building automotive datasets or training ML models

---

### Input Format

```json
{
  "urls": ["https://www.carroya.com/automoviles-y-camionetas?page=2"],
  "ignore_url_failures": true,
  "max_items_per_url": 50
}
````

| Field | Type | Description |
|---|---|---|
| `urls` | `array` | One or more Carroya search/listing page URLs to scrape. Supports pagination URLs (e.g., `?page=2`). Add URLs one by one or via bulk edit. |
| `max_items_per_url` | `integer` | Maximum number of vehicle records to collect per URL. Default: `20`. |
| `ignore_url_failures` | `boolean` | If `true`, the scraper continues running when a URL fails instead of stopping the entire run. Recommended for bulk jobs. |

> **Tip:** To scrape multiple pages, add each paginated URL separately (e.g., `?page=1`, `?page=2`). Filter by brand, city, or price on Carroya before copying the URL to target specific segments.

***

### Output Format

**Sample output**

```json
{
  "client_user_id": 438619,
  "photos_360": "N",
  "body_type": " Camperos y camionetas",
  "publication_status": "Publicado",
  "company_name": "Peralta Gomez Automoviles",
  "featured_seller_flag": "N",
  "plate_restriction_type": "impar",
  "comments": "SEGUNDO DUEÑO, PERFECTO ESTADO, AIRE ACONDICIONADO, VIDRIOS ELÉCTRICOS, EXCELENTE ESTADO Y MANTENIMIENTO. ",
  "fenomenoya_price_flag": "N",
  "accessory_photo_count": 0,
  "listing_type": "Usado",
  "event": "N",
  "compression_ratio": "N",
  "city_code": "11001",
  "brake_system": "Hidráulicos",
  "is_vertical": 1,
  "division": "Bogotá D.C.",
  "transport_type": "Vehículos",
  "tags": [
    "carroya"
  ],
  "offered_by": "Concesionario",
  "specification_id": 17819,
  "vehicle_type_category_id": 1,
  "featured": 1,
  "city_ids": [
    "1"
  ],
  "financed_vehicle_flag": "S",
  "ad_title": "Suzuki Jimny 1.3 Jlx A.A 2018",
  "updated_at": "2026-05-14T16:50:09.000Z",
  "transport_type_id": 4,
  "package_id": 12,
  "product_score": 374,
  "days_difference_2000": 9610,
  "trim": "1.3 JLX A.A",
  "image_name": "2290212_13",
  "video_count": 0,
  "door_count": "2",
  "seller_name": "PG Automoviles",
  "seller_city": "BOGOTA",
  "plate_restriction_number": "3",
  "video_status": "Sin Video",
  "collectible_flag": "N",
  "seller_email": "jucap60@yahoo.com",
  "model_year": 2018,
  "company_logo": "logodetalle.gif",
  "outlet_flag": "N",
  "low_km_flag": "N",
  "torque": "N",
  "division_id": 5,
  "accessories": "Aire acondicionado, Alarma, Bloqueo central, Exploradoras, Limpiabrisas trasero, Radio CD, Rines de lujo, Vidrios eléctricos, Espejos eléctricos",
  "brand_id": 97,
  "armored_flag": "N",
  "exterior_photo_count": 0,
  "taxonomy": "0",
  "featured_position": 1270,
  "max_speed": "N",
  "timestamp": "2026-05-15T00:00:19.084Z",
  "microsite_url": "ND",
  "vehicle_type_id": 3,
  "power_type": "N",
  "steering_type": "N",
  "photo_media_status": "Con Fotos",
  "microsite_id": 1060,
  "interior_photo_count": 0,
  "location_position_id": 3,
  "currency_type": "PESO",
  "accessories_array": [
    "Aire acondicionado",
    " Alarma",
    " Bloqueo central",
    " Exploradoras",
    " Limpiabrisas trasero",
    " Radio CD",
    " Rines de lujo",
    " Vidrios eléctricos",
    " Espejos eléctricos"
  ],
  "line_id": 8398,
  "price_range": "30000001 - 70000000",
  "single_owner_flag": "N",
  "plate_division": "Antioquia",
  "price_int": 60990000,
  "vehicle_type": "Camperos",
  "seller_address": "Carerra 64 N 100-56",
  "published_at": "2026-05-14T16:50:09.000Z",
  "negotiable_price_flag": "N",
  "mileage_range": "100001 +",
  "email_flag": "S",
  "company_id": 12764,
  "plate": "JKQ423",
  "photo_count": 13,
  "plate_city": "ENVIGADO",
  "vehicle_category_name": "Automóviles y Camionetas",
  "version": "1",
  "fuel_type": "Gasolina",
  "plate_city_id": "142",
  "seller_id": "438619",
  "certification_flag": "N",
  "plate_division_id": "2",
  "section_etc": "0",
  "location_position": "Super Destacado",
  "image_url": "https://static.carroya.com/vehiculospruebas/2290212/2290212_13_m.jpg",
  "client_brand_flag": "N",
  "features": "Exploradoras, Vidrios eléctricos, Rines de lujo, Radio CD, Aire acondicionado, Alarma, Bloqueo central, Limpiabrisas trasero, Tipo de caja Mecanica, Tipo de combustible Gasolina",
  "transmission_type": "Mecánica",
  "antique_vehicle_flag": "N",
  "recent_weight_days": 0,
  "audio_classified_flag": "N",
  "id": "2290212",
  "year": 2018,
  "title": "Suzuki Jimny 2018",
  "status": "usado",
  "sold": "N",
  "price": 60990000,
  "brand": "Suzuki",
  "model": "Jimny",
  "detail_url": "https://www.carroya.com/vehiculo/usado/suzuki/jimny/1.3-jlx-a.a/2018/bogota/2290212.do",
  "fenomenoya": false,
  "fenomenoya_desc": [],
  "engine_cc": 1350,
  "kilometers": 114000,
  "color": "Blanco",
  "city": "BOGOTA",
  "featured_level": 3,
  "images": [
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_13_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_1_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_11_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_10_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_9_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_8_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_12_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_7_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_14_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_6_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_3_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_2_l.jpg"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_5_l.jpg"
    }
  ],
  "images_4_seo": [
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_13"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_1"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_11"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_10"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_9"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_8"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_12"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_7"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_14"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_6"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_3"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_2"
    },
    {
      "image": "https://carroya-commons.avaldigitallabs.com/2290212/2290212_5"
    }
  ],
  "image_4_seo_sizes": [
    {
      "1x": "_s"
    },
    {
      "2x": "_m"
    },
    {
      "3x": "_l"
    }
  ]
}
```

Each vehicle record returns 100+ structured fields, grouped below by category:

#### Core Listing Identity

| Field | Meaning |
|---|---|
| `ID` | Unique Carroya listing identifier |
| `Title` | Full ad title as shown on the listing |
| `Ad Title` | Alternative or formatted ad title |
| `Detail URL` | Direct URL to the vehicle's detail page |
| `Microsite URL` | Dealer microsite URL, if applicable |
| `Status` | Listing status (e.g., active, paused) |
| `Publication Status` | Publication state in Carroya's system |
| `Listing Type` | Type of listing (e.g., standard, featured) |
| `Sold` | Whether the vehicle has been marked as sold |
| `Published At` | Date/time the listing was first published |
| `Updated At` | Last modification timestamp |
| `Timestamp` | Raw system timestamp |

#### Vehicle Specifications

| Field | Meaning |
|---|---|
| `Brand` / `Brand ID` | Vehicle make (e.g., Toyota) and its internal ID |
| `Model` | Vehicle model name |
| `Year` | Manufacturing year |
| `Model Year` | Model year (may differ from manufacturing year) |
| `Trim` | Trim level or variant |
| `Version` | Specific version label |
| `Body Type` | Body style (e.g., sedan, SUV, pickup) |
| `Vehicle Type` / `Vehicle Type ID` | Vehicle classification and ID |
| `Vehicle Type Category ID` | Higher-level category identifier |
| `Vehicle Category Name` | Human-readable category label |
| `Transport Type` / `Transport Type ID` | Transport classification |
| `Engine CC` | Engine displacement in cubic centimeters |
| `Compression Ratio` | Engine compression ratio |
| `Fuel Type` | Fuel type (e.g., gasoline, diesel, electric) |
| `Power Type` | Power source classification |
| `Transmission Type` | Gearbox type (e.g., manual, automatic) |
| `Steering Type` | Steering system type |
| `Brake System` | Braking system description |
| `Door Count` | Number of doors |
| `Max Speed` | Maximum speed specification |
| `Torque` | Engine torque value |
| `Kilometers` | Odometer reading |
| `Mileage Range` | Bucketed mileage range for filtering |
| `Color` | Exterior color |
| `Accessories` / `Accessories Array` | List of included accessories |
| `Features` | Additional vehicle features |
| `Taxonomy` | Internal taxonomy classification |

#### Pricing & Financial

| Field | Meaning |
|---|---|
| `Price` | Listed price |
| `Price Int` | Price as integer (for sorting/filtering) |
| `Price Range` | Bucketed price range |
| `Currency Type` | Currency (typically COP) |
| `Negotiable Price Flag` | Whether the price is negotiable |
| `Financed Vehicle Flag` | Whether financing is available |
| `Fenomenoya` / `Fenomenoya Price Flag` / `Fenomenoya Desc` | Carroya's "Fenomenoya" deal badge — flags unusually good value listings with a description |
| `Outlet Flag` | Whether listed as an outlet/clearance vehicle |

#### Location

| Field | Meaning |
|---|---|
| `City` | City where the vehicle is located |
| `City Code` / `City IDs` | City identifier codes |
| `Plate City` / `Plate City ID` | City associated with the vehicle's plate |
| `Plate Division` / `Plate Division ID` | Administrative division of the plate |
| `Plate` | License plate number (may be partial) |
| `Plate Restriction Type` / `Plate Restriction Number` | Pico y placa restriction type and number |
| `Division` / `Division ID` | Geographic division and ID |
| `Location Position` / `Location Position ID` | Geolocation or position metadata |
| `Section Etc` | Additional location/section info |
| `Seller Address` | Seller's address |
| `Seller City` | City of the seller |

#### Seller Information

| Field | Meaning |
|---|---|
| `Seller ID` | Unique seller identifier |
| `Seller Name` | Seller's display name |
| `Seller Email` | Contact email |
| `Email Flag` | Whether email contact is enabled |
| `Offered By` | Seller category (e.g., owner, dealer) |
| `Company Name` / `Company ID` | Dealership name and ID |
| `Company Logo` | URL to the dealer's logo image |
| `Client User ID` | Platform user ID of the seller |
| `Client Brand Flag` | Whether the seller is a brand-affiliated client |
| `Featured Seller Flag` | Whether the seller has featured status |
| `Microsite ID` | Associated dealer microsite identifier |

#### Listing Flags & Classification

| Field | Meaning |
|---|---|
| `Featured` / `Featured Level` / `Featured Position` | Boost status, tier, and position in results |
| `Collectible Flag` | Marked as a collectible vehicle |
| `Antique Vehicle Flag` | Marked as an antique |
| `Armored Flag` | Whether the vehicle is armored |
| `Single Owner Flag` | Single previous owner indicator |
| `Low KM Flag` | Low mileage highlight flag |
| `Certification Flag` | Whether the vehicle carries a certification |
| `Is Vertical` | Vertical market flag |
| `Audio Classified Flag` | Whether an audio ad is attached |
| `Comments` | Seller or system comments |
| `Tags` | Searchable tags attached to the listing |
| `Event` | Associated promotional event |
| `Package ID` | Listing package type |
| `Product Score` | Carroya's internal quality score |
| `Days Difference 2000` / `Recent Weight Days` | Age/recency scoring metrics |
| `Line ID` / `Specification ID` | Internal spec and line references |

#### Media

| Field | Meaning |
|---|---|
| `Images` | Array of all image URLs |
| `Image URL` / `Image Name` | Primary image URL and filename |
| `Images 4 SEO` / `Image 4 SEO Sizes` | SEO-optimized image variants and size metadata |
| `Photos 360` | 360° photo availability |
| `Photo Count` | Total number of photos |
| `Exterior Photo Count` | Count of exterior photos |
| `Interior Photo Count` | Count of interior photos |
| `Accessory Photo Count` | Count of accessory photos |
| `Photo Media Status` | Media processing/availability status |
| `Video Count` / `Video Status` | Number of videos and their status |

***

### How to Use

1. **Build your search URL** — Apply filters on Carroya.com (brand, city, price range, etc.) and copy the results page URL.
2. **Add pagination** — For large datasets, add multiple paginated URLs (e.g., `?page=1` through `?page=10`).
3. **Configure the input** — Set `max_items_per_url` based on how many records you need per page.
4. **Enable `ignore_url_failures`** — Recommended for bulk runs to avoid interruptions from occasional failed pages.
5. **Run and export** — Download results as JSON or CSV for use in Excel, databases, or BI tools.

**Best practices:**

- Narrow your search filters on Carroya before scraping to get targeted, relevant data.
- Use paginated URLs systematically to cover a full category without duplication.
- Cross-reference `Detail URL` for any records needing additional detail-page fields.

***

### Use Cases & Business Value

- **Dealer competitive intelligence:** Monitor pricing and inventory across brands and cities in real time
- **Price index construction:** Build Colombian used-car price benchmarks segmented by year, brand, or mileage
- **Lead generation:** Identify motivated sellers via `Negotiable Price Flag` or `Outlet Flag`
- **ML training data:** Generate labeled automotive datasets using specs, images, and pricing signals
- **Market analysis:** Study regional demand patterns using city and division metadata

***

### Conclusion

The **Carroya.com Cars Scraper** delivers one of the most comprehensive automotive datasets available from any Latin American marketplace. With 100+ fields per listing — spanning technical specs, pricing signals, seller profiles, media, and behavioral flags — it gives analysts, developers, and dealers the raw material to build serious automotive intelligence. Configure a run in minutes and start turning Colombia's largest car marketplace into structured data.

# Actor input Schema

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

Add the URLs of the Cars list 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.carroya.com/automoviles-y-camionetas?page=2"
  ],
  "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.carroya.com/automoviles-y-camionetas?page=2"
    ],
    "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/carroya-cars-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.carroya.com/automoviles-y-camionetas?page=2"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/carroya-cars-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.carroya.com/automoviles-y-camionetas?page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/carroya-cars-search-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Carroya Cars Search Scraper",
        "description": "Scrape Carroya.com car listings with 100+ data fields per vehicle — price, mileage, seller info, specs, photos, and more. Perfect for automotive dealers, market analysts, and price comparison platforms targeting the Colombian used car market.",
        "version": "0.0",
        "x-build-id": "KOHqxhHlBXakdmf98"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~carroya-cars-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-carroya-cars-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~carroya-cars-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-carroya-cars-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~carroya-cars-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-carroya-cars-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 Cars list urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the Cars list 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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
