Vivanuncios Mexico Real Estate Listings & Agent Contact Scraper

Here is one real result, with every field the actor returns (imageUrls trimmed to 3 of 20 entries; all other values are exactly as returned):

{
  "listingId": "145641919",
  "listingUrl": "https://www.vivanuncios.com.mx/a-venta-departamento/supermanzana-11/ph-en-renta-venta-en-palmar-residencial-cancun-sm-12/145641919?n_src=Listado&n_pills=Escuelas+cercanas&n_pg=1&n_pos=4",
  "title": "Departamento de 3 habitaciones, Cancún · PH en Renta/venta en Palmar Residencial Cancún Sm 12",
  "priceAmount": 8500000,
  "priceCurrency": "MXN",
  "operation": "venta",
  "propertyType": "Departamento",
  "isDevelopment": false,
  "bedrooms": 3,
  "bathrooms": 3,
  "parkingSpaces": 2,
  "totalAreaM2": 310,
  "pricePerM2": 27419,
  "location": "Supermanzana 11, Cancún",
  "colonia": "Supermanzana 11",
  "city": "Cancún",
  "state": null,
  "imageUrl": "https://img10.naventcdn.com/avisos/18/01/45/64/18/65/360x266/1509220653.jpg?rapc=bXZhX2ltYWdl?isFirstImage=true",
  "description": "Amplio penthouse construido en dos plantas 310 m2 entre ambas plantas Amueblado 3 recámaras 3.5 baños Sala Comedor Cocina integral Cuarto de lavado Terraza Roof privado con jacuzzi, sala y área para eventos 2 cajones de estacionamiento Seguridad 24/7 Alberca Gym Permite renta vacacional En renta: mantenimiento incluido",
  "propertyTypeDetail": "Departamento",
  "builtAreaM2": 155,
  "propertyAge": 5,
  "publishedAt": "2025-02-06T00:08:14Z",
  "amenities": ["Amueblado", "Elevador", "Caseta de guardia", "Alberca", "Terraza", "Escuelas Cercanas", "Mascotas", "Cocina integral", "Acceso discapacitados", "Estado de conservación", "Piso en el que se encuentra", "Ubicación", "Closet", "Area de lavandería", "Gimnasio", "Internet/Wifi", "Línea blanca", "Aire acondicionado", "Seguridad privada", "Servicios básicos (agua/luz)", "Espacio de co-working", "Patio", "Area de eventos", "Asador", "Balcón(es)", "Estacionamientos", "Jardín Privado"],
  "amenitiesCount": 27,
  "imageUrls": [
    "https://img10.naventcdn.com/avisos/resize/18/01/45/64/18/65/1200x1200/1509220653.jpg?rapc=bXZhX2ltYWdl?isFirstImage=true",
    "https://img10.naventcdn.com/avisos/resize/18/01/45/64/18/65/1200x1200/1509220641.jpg?rapc=bXZhX2ltYWdl",
    "https://img10.naventcdn.com/avisos/resize/18/01/45/64/18/65/1200x1200/1509220652.jpg?rapc=bXZhX2ltYWdl"
  ],
  "imageCount": 20,
  "agencyName": "QHA REAL ESTATE & LAW",
  "advertiserName": "QHA REAL ESTATE & LAW",
  "agencyUrl": "https://www.vivanuncios.com.mx/u-anuncios-del-vendedor/qha-real-estate-law/v1u102361641p1",
  "agencyLogo": "https://img10.naventcdn.com/empresas/18/00/51/32/30/45/130x70/logo_qha-real-estate-law_1761936879592.jpg",
  "publisherId": "102361641",
  "phone": "+529981264604",
  "whatsapp": "+529981264604",
  "partialPhone": "99889",
  "latitude": 21.1407513,
  "longitude": -86.8284925,
  "searchUrl": "https://www.vivanuncios.com.mx/s-departamentos-en-venta/v1c1294p1",
  "source": "vivanuncios-mexico",
  "observedAt": "2026-08-10T00:59:22.990Z",
  "error": null
}

The most complete Vivanuncios Mexico real estate scraper available. It returns every field the listing card and detail page expose, plus derived fields like pricePerM2, and gives you five inputs (search URLs, max listings, detail-page enrichment, and a price band) to target exactly the listings 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 takes one or more Vivanuncios Mexico search URLs, paginates through the results, and writes one normalized record per property listing to the run's dataset. Prices are parsed into a numeric priceAmount plus a priceCurrency (MXN or USD), area and price are combined into pricePerM2 for valuation, and location is split into colonia, city, and state. Turn on withDetails to fetch each listing's detail page and add the advertiser/agency name, agent phone and WhatsApp, GPS coordinates, description, full image gallery, and amenities, which is what makes it usable for lead generation.

Data covers Vivanuncios Mexico property classifieds only (sale and rent). You control coverage by pasting the exact search URLs you want, so any filter available on vivanuncios.com.mx (operation, property type, location, price) carries through.

Quickstart

Open the actor, paste this into the input, and press Run. It returns the 10 most recent apartments for sale, enriched with agent contacts and coordinates.

{
  "searchUrls": [
    "https://www.vivanuncios.com.mx/s-departamentos-en-venta/v1c1294p1"
  ],
  "maxListings": 10,
  "withDetails": true
}

Every input except searchUrls is optional. Leave withDetails off for a faster, card-only pull, or add minPrice/maxPrice to keep only listings inside a price band.

Input reference

Field	Type	Required	Default	Description
searchUrls	string[]	yes	(sample URL)	One or more Vivanuncios Mexico search results URLs. Apply any filters on vivanuncios.com.mx, then paste each resulting URL, for example https://www.vivanuncios.com.mx/s-departamentos-en-venta/v1c1294p1. Each runs as its own search.
maxListings	integer	no	10	Maximum number of listings to collect across all search URLs.
withDetails	boolean	no	false	When enabled, each listing's detail page is fetched to add advertiser/agency name, agent phone and WhatsApp, GPS coordinates, description, full image gallery, and amenities. Slower but far richer for lead generation and valuation.
minPrice	integer	no	(none)	Only keep listings priced at or above this amount (in the listing's own currency, MXN or USD). Listings with no published price are always kept.
maxPrice	integer	no	(none)	Only keep listings priced at or below this amount (in the listing's own currency, MXN or USD). Listings with no published price are always kept.

Output reference

One dataset item per listing. Types: string, number, boolean, string[], or null when the source value is absent. Fields marked (detail) are only populated when withDetails is enabled.

Field	Type	Description
listingId	string	Vivanuncios listing ID (deduplication key).
listingUrl	string	Full URL of the listing detail page.
title	string	Listing title.
priceAmount	number	Numeric asking price.
priceCurrency	string	Currency of the price: MXN or USD.
operation	string	Operation type: venta (sale) or renta (rent).
propertyType	string	Property type (Departamento, Casa, Terreno, Oficina, Local comercial, Desarrollo).
isDevelopment	boolean	true when the card is a new-development project rather than a single unit.
bedrooms	number	Number of bedrooms.
bathrooms	number	Number of bathrooms.
parkingSpaces	number	Number of parking spaces.
totalAreaM2	number	Total area in square metres.
builtAreaM2	number	Covered/built area in square metres (detail).
pricePerM2	number	Price divided by area, the core comparable metric for valuation.
location	string	Full location string as shown on the card.
colonia	string	Neighbourhood / colonia.
city	string	City / municipality.
state	string	Mexican state, or null when not published.
latitude	number	GPS latitude (detail).
longitude	number	GPS longitude (detail).
advertiserName	string	Advertiser / agency name (detail).
agencyName	string	Real estate agency name (detail).
agencyUrl	string	Agency profile URL (detail).
agencyLogo	string	Agency logo image URL (detail).
publisherId	string	Vivanuncios publisher/advertiser ID (detail).
phone	string	Agent phone in +digits form when public (detail).
whatsapp	string	Agent WhatsApp number when public (detail).
partialPhone	string	Masked/partial phone shown on the site (detail).
description	string	Listing description text (detail).
propertyTypeDetail	string	Property type as stated on the detail page (detail).
publishedAt	string	Publication date (detail).
expenses	number	Monthly maintenance / condominium fee amount (detail).
expensesCurrency	string	Currency of the maintenance fee (detail).
propertyAge	number	Property age in years (detail).
amenities	string[]	List of amenity labels (detail).
amenitiesCount	number	Number of amenities.
imageUrl	string	Primary listing image URL.
imageUrls	string[]	Full image gallery URLs (detail).
imageCount	number	Number of gallery images.
searchUrl	string	The search URL that produced this record.
source	string	Data source tag (vivanuncios-mexico).
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 {"searchUrls":["https://www.vivanuncios.com.mx/s-departamentos-en-venta/v1c1294p1"],"maxListings":10}), card-only:

{
  "listingId": "91493324",
  "listingUrl": "https://www.vivanuncios.com.mx/a-venta-departamento/polanco/plaza-carso-3-recamaras-torre-monet/91493324",
  "title": "Departamento de 3 habitaciones, Miguel Hidalgo · Plaza Carso 3 Recamaras Torre Monet",
  "priceAmount": 12000000,
  "priceCurrency": "MXN",
  "operation": "venta",
  "propertyType": "Departamento",
  "isDevelopment": false,
  "bedrooms": 3,
  "bathrooms": 2,
  "parkingSpaces": 2,
  "totalAreaM2": 122,
  "pricePerM2": 98361,
  "location": "Polanco, Miguel Hidalgo",
  "colonia": "Polanco",
  "city": "Miguel Hidalgo",
  "state": null,
  "imageUrl": "https://img10.naventcdn.com/avisos/18/00/52/03/46/55/360x266/54743593.jpg?rapc=bXZhX2ltYWdl?isFirstImage=true",
  "searchUrl": "https://www.vivanuncios.com.mx/s-departamentos-en-venta/v1c1294p1",
  "source": "vivanuncios-mexico",
  "observedAt": "2026-08-10T14:35:25.769Z",
  "error": null
}

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~vivanuncios-mexico-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchUrls":["https://www.vivanuncios.com.mx/s-departamentos-en-venta/v1c1294p1"],"maxListings":25,"withDetails":true}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~vivanuncios-mexico-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchUrls":["https://www.vivanuncios.com.mx/s-venta-inmuebles/coahuila/v1c1097l1006p1"],"maxListings":100}'

Apify CLI:

apify call scrapers_lat/vivanuncios-mexico-scraper \
  --input '{"searchUrls":["https://www.vivanuncios.com.mx/s-departamentos-en-venta/v1c1294p1"],"withDetails":true}'

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 record returned (result event). See the pricing tab for the current per-result price.
• 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 maxListings.
• Detail pages cost more time. withDetails fetches an extra page per listing, so large runs take longer; run card-only first if you only need price and location.

FAQ and troubleshooting

A run returned 0 records. Why? The search URL matched nothing, or the filters (minPrice/maxPrice) removed everything. Open the URL in a browser to confirm it shows results, and widen the price band. Zero-result runs are not charged.

How do I get agent phone numbers and coordinates? Set withDetails to true. Card-only runs do not include contact or GPS fields because those live on the detail page.

Why is phone or state null? The advertiser did not publish a public phone, or the source did not expose the state for that card. Missing values are returned as null, never invented.

How do I control which listings are scraped? Apply filters on vivanuncios.com.mx (operation, property type, location, price), then paste each resulting search URL into searchUrls. Each URL runs as its own search.

What is pricePerM2? The asking price divided by the total area, in the listing's own currency. It is the standard comparable metric for valuing property against similar listings.

Is this an official Vivanuncios tool? No. This actor is independent and has no affiliation with Vivanuncios or Naranja Media. It reads only data that is publicly available on the website.

Related scrapers

• Inmuebles24 Mexico Real Estate Scraper: Mexico property listings and agent contacts.
• Wasi Real Estate Scraper: Latin American real estate listings from Wasi-powered sites.
• VivaReal Brazil Real Estate Scraper: Brazil property listings.
• Fincaraiz Colombia Real Estate Scraper: Colombia property listings.
• AdondeVivir Peru Real Estate Scraper: Peru property listings.

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 Vivanuncios. Accesses only publicly available listing data.