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

{
  "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

{
  "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.