CarroYa Colombia Car Listings & Seller Contacts Scraper

Here is one real result, with every field the actor returns (the images array is trimmed with an ellipsis, every value real):

{
  "listingId": "4650ff47-77eb-4ece-be29-86ab69f5cb9f",
  "title": "Mazda 3 2011",
  "make": "Mazda",
  "model": "3",
  "trim": null,
  "year": 2011,
  "priceAmount": 37000000,
  "currency": "COP",
  "kilometers": 68000,
  "mileageRange": "50001 - 100000",
  "transmission": "Mecánica",
  "fuelType": "Gasolina",
  "bodyType": "Automóviles",
  "vehicleCategory": "Automóviles y Camionetas",
  "vehicleType": "Vehículos",
  "condition": "usado",
  "color": "Gris",
  "cylinderCapacity": 1600,
  "plate": "NVV752",
  "plateCity": "NEIVA",
  "armored": false,
  "collectible": false,
  "city": "BOGOTA",
  "department": "BOGOTA",
  "sellerName": "JOHN JAIRO RODRIGUEZ SANCHEZ",
  "sellerType": "Particular",
  "sellerCompany": null,
  "sellerPhone": "+573133846520",
  "sellerWhatsapp": "+573133846520",
  "sellerEmail": "jojarosa31@gmail.com",
  "sellerMicrositeUrl": null,
  "accessories": "Air bag delanteros, Alarma, Bloqueo Central",
  "description": "PERFECTO ESTADO, RINES DE LUJO, RADIO TOUCH Y EL ORIGINAL TAMBIÉN SE ENTREGA, LUCES HD, VIDRIOS ELÉCTRICOS, MANDOS EN EL VOLANTE",
  "photoCount": 11,
  "videoCount": 0,
  "featured": true,
  "sold": false,
  "publishedAt": "2023-09-19T19:05:24.000Z",
  "updatedAt": "2023-09-19T19:08:34.000Z",
  "imageUrl": "https://carroya-commons.avaldigitallabs.com/4650ff47-77eb-4ece-be29-86ab69f5cb9f/..._1685731504251_l.jpg",
  "images": ["https://carroya-commons.avaldigitallabs.com/4650ff47-77eb-4ece-be29-86ab69f5cb9f/..._1685731504251_l.jpg", "..."],
  "listingUrl": "https://www.carroya.com/vehiculo/usado/mazda/3/2011/bogota/4650ff47-77eb-4ece-be29-86ab69f5cb9f",
  "searchTerm": "Mazda",
  "aiListingSummary": null,
  "aiSpecs": null,
  "aiTitleEn": null,
  "aiDescriptionEn": null,
  "source": "CarroYa",
  "observedAt": "2026-08-14T07:09:39.952Z",
  "error": null
}

The most complete CarroYa Colombia car scraper available. It returns every field a CarroYa listing exposes for each vehicle, including price in COP, mileage, specs, plate, city and department, and the seller name, phone, WhatsApp and email where published, plus optional AI add-ons, and gives you free-text searches to target exactly the vehicles you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches CarroYa Colombia for each of your search terms and writes one normalized record per vehicle listing to the run's dataset. Each record carries the make, model, trim, year, price in COP, kilometers and mileage range, transmission, fuel type, body type, condition, color, cylinder capacity, plate and plate city, city and department, the full image gallery, and the seller name, type, company, phone, WhatsApp and email where published. Missing source values are returned as null.

Optional AI add-ons (withAiListingSummary, withAiSpecExtract, withAiTranslate) add an English summary, structured specs, and an English translation of the Spanish title and description per listing. They are paid add-ons, charged only when they return usable output.

Quickstart

Open the actor, paste this into the input, and press Run. It returns three Mazda listings.

{
  "searches": ["Mazda"],
  "maxCars": 3
}

Each search term is run separately. Add makes, make-and-model pairs, body types or free text to widen the run.

Input reference

Field	Type	Required	Default	Description
searches	string[]	no	["Chevrolet","Toyota","Mazda","Renault"]	Search terms. Each can be a make (Chevrolet), make and model (Toyota Corolla), body type (Camioneta) or any free text. Each term is searched separately.
maxCars	integer	no	10	Maximum vehicles to collect across all searches (1 to 1000000).
withAiListingSummary	boolean	no	false	AI English summary of each listing. Paid add-on, billed only when a summary is produced.
withAiSpecExtract	boolean	no	false	AI structured specs (engine, features, condition, warranty) from the listing text. Paid add-on, billed only when specs are produced.
withAiTranslate	boolean	no	false	AI translation of the Spanish title and description to English. Paid add-on, billed only when a translation is produced.

Output reference

One dataset item per vehicle. Types: string, integer, number, boolean, string[], object, or null when the source value is absent.

Field	Type	Description
listingId	string	CarroYa listing ID.
title	string	Listing title.
make	string	Vehicle make.
model	string	Vehicle model.
trim	string	Trim / version, or null.
year	integer	Model year.
priceAmount	integer	Price amount.
currency	string	Price currency. COP.
kilometers	integer	Odometer reading in km.
mileageRange	string	Mileage bucket, for example 50001 - 100000.
transmission	string	Transmission, for example Mecánica, Automática.
fuelType	string	Fuel type, for example Gasolina, Diesel.
bodyType	string	Body type.
vehicleCategory	string	Vehicle category.
vehicleType	string	Vehicle type.
condition	string	Condition, for example usado, nuevo.
color	string	Vehicle color.
cylinderCapacity	integer	Engine cylinder capacity in cc.
plate	string	License plate.
plateCity	string	City the plate is registered in.
armored	boolean	Whether the vehicle is armored.
collectible	boolean	Whether it is a collectible.
city	string	Listing city.
department	string	Listing department.
sellerName	string	Seller name.
sellerType	string	Seller type, for example Particular, Concesionario.
sellerCompany	string	Seller company name, or null.
sellerPhone	string	Seller phone, or null.
sellerWhatsapp	string	Seller WhatsApp number, or null.
sellerEmail	string	Seller email, or null.
sellerMicrositeUrl	string	Seller microsite URL, or null.
accessories	string	Listed accessories.
description	string	Listing description text.
photoCount	integer	Number of photos.
videoCount	integer	Number of videos.
featured	boolean	Whether the listing is featured.
sold	boolean	Whether the vehicle is sold.
publishedAt	string	Publication timestamp (ISO).
updatedAt	string	Last update timestamp (ISO).
imageUrl	string	Primary image URL.
images	string[]	All image URLs.
listingUrl	string	CarroYa listing URL.
searchTerm	string	The search term that produced this record.
aiListingSummary	string	AI English summary, or null unless withAiListingSummary is on.
aiSpecs	object	AI structured specs, or null unless withAiSpecExtract is on.
aiTitleEn	string	AI English title, or null unless withAiTranslate is on.
aiDescriptionEn	string	AI English description, or null.
source	string	Data source. CarroYa.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"searches":["Mazda"],"maxCars":3,"withAiListingSummary":true,"withAiSpecExtract":true,"withAiTranslate":true}). The AI fields are populated because this run enabled them:

{
  "listingId": "4650ff47-77eb-4ece-be29-86ab69f5cb9f",
  "title": "Mazda 3 2011",
  "make": "Mazda",
  "model": "3",
  "year": 2011,
  "priceAmount": 37000000,
  "currency": "COP",
  "kilometers": 68000,
  "transmission": "Mecánica",
  "fuelType": "Gasolina",
  "condition": "usado",
  "color": "Gris",
  "plate": "NVV752",
  "plateCity": "NEIVA",
  "city": "BOGOTA",
  "department": "BOGOTA",
  "sellerName": "JOHN JAIRO RODRIGUEZ SANCHEZ",
  "sellerType": "Particular",
  "sellerPhone": "+573133846520",
  "sellerWhatsapp": "+573133846520",
  "sellerEmail": "jojarosa31@gmail.com",
  "listingUrl": "https://www.carroya.com/vehiculo/usado/mazda/3/2011/bogota/4650ff47-77eb-4ece-be29-86ab69f5cb9f",
  "searchTerm": "Mazda",
  "aiListingSummary": "This 2011 Mazda 3 in gray is in perfect condition with only 68,000 kilometers. Priced at 37,000,000 COP, it features luxury rims, a touch radio, HD lights and power windows.",
  "aiSpecs": {
    "engine": "",
    "features": ["Air bag delanteros", "Alarma", "Bloqueo Central", "RADIO TOUCH"],
    "conditionNotes": "PERFECTO ESTADO",
    "warranty": ""
  },
  "aiTitleEn": "2011 Mazda 3",
  "aiDescriptionEn": "IN PERFECT CONDITION, LUXURY RIMS, TOUCH RADIO AND ORIGINAL ONE ALSO INCLUDED, HD LIGHTS, POWER WINDOWS, STEERING WHEEL CONTROLS",
  "source": "CarroYa",
  "observedAt": "2026-08-14T07:09:39.952Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~carroya-colombia-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searches":["Toyota Corolla"],"maxCars":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~carroya-colombia-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searches":["Chevrolet","Renault","Camioneta"],"maxCars":200}'

Apify CLI:

apify call scrapers_lat/carroya-colombia-scraper \
  --input '{"searches":["Mazda"],"maxCars":50}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per vehicle record returned (result event). See the pricing tab for the current per-result price.
• AI add-ons are billed separately. withAiListingSummary, withAiSpecExtract and withAiTranslate each charge only when they return usable output, and are available to paying users.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxCars.

FAQ and troubleshooting

Does it include seller contact details? Yes. Each record includes the seller name, type and, where CarroYa publishes them, the phone, WhatsApp number and email.

Can I search by make and model? Yes. Put the full phrase in searches, for example Toyota Corolla. You can also search by body type or any free text.

A run returned 0 records. Why? The term may not match any live listing. Try a broader make or a different keyword. Zero-result runs are not charged.

Why are the AI fields null? They only populate when you enable withAiListingSummary, withAiSpecExtract or withAiTranslate. Otherwise they stay null.

Is the price in Colombian pesos? Yes. priceAmount is the numeric amount and currency is COP.

Is this an official CarroYa tool? No. This actor is independent and has no affiliation with CarroYa. It reads only data that is publicly available on CarroYa listings. Use the results in accordance with the source's terms and applicable data-protection law.

Related scrapers

• Adondevivir Peru Real Estate Scraper: Peru property listings with contacts.
• Aircraft For Sale Scraper: Aircraft listings with seller details.
• Cannabis Dispensary Scraper: Weedmaps retailers with contacts.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with CarroYa. Accesses only publicly available listing data. Use in accordance with the source's terms.