🇲🇽 Vivanuncios Scraper

Want Vivanuncios results in a spreadsheet? This scraper makes it easy.

Use the same filters you see on the website — better for AI agents — or paste a listing URL. When a URL is set, it overrides the filters.

Vivanuncios lists hundreds of thousands of properties in Mexico. This actor returns up to 2000 rows per run.

💡 Perfect for...

• Agents: Export matching listings without paging the site.
• Dashboards: Track prices, locations, and inventory.
• Market research: Slice the same filters the website offers.
• Data analysts: Export listing rows with public links.
• 🤖 AI Agents: Power Claude, Cursor, Codex, the Hermes Agent, and OpenClaw workflows with live results.
• 📚 RAG Systems: Feed titles and locations into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 URL or filters: Paste a search URL, or use the dropdowns. The URL always wins when set.
• 🎯 Same filters as the site: Buy or rent, property type, location, bedrooms, bathrooms, price, advertiser, and sort.
• 🌐 Ready to export: Titles, prices, locations, and listing links.

📦 What's inside the data?

Every row can include:

• Listing: id, url, title, purpose, property type, featured, posted date
• Price: price and currency
• Location: area name and street address
• Advertiser: publisher name
• Extras: amenity highlights, video flag, photo

🚀 Quick start

Option A — Input URL

1. Open Vivanuncios, apply filters, copy the URL.
2. Paste it into input_url.
3. Set max_results and click Start.

Option B — Structured filters (better for AI agents)

1. Leave input_url empty.
2. Pick sale or rent, a property type, and a location.
3. Set max_results (up to 2000) and click Start.

---

Tech details for developers 🧑‍💻

Input Example (filters):

{
  "purpose": "sale",
  "location": "cdmx",
  "property_type": "apartment",
  "bedrooms": "2",
  "price_max": 3000000,
  "max_results": 100
}

Input Example (URL override):

{
  "input_url": "https://www.vivanuncios.com.mx/s-venta-inmuebles/v1c1097p1",
  "max_results": 50
}

Output Example:

{
  "id": "1123456789",
  "url": "https://www.vivanuncios.com.mx/a-venta-departamentos/roma-norte/1123456789",
  "title": "Departamento en venta en Roma Norte",
  "purpose": "sale",
  "property_type": "Departamento",
  "price": 2850000,
  "currency": "MXN",
  "location": "Roma Norte, Ciudad de México",
  "address": "Calle Orizaba",
  "publisher": "Inmuebles Capital",
  "features": ["2 recámaras", "2 baños", "estacionamiento"],
  "has_video": false,
  "featured": true,
  "posted_at": "2026-09-01T00:00:00.000Z",
  "image_url": "https://img.vivanuncios.com.mx/..."
}

Output fields:

Field	Description
id	Vivanuncios listing id.
url	Public listing page.
title	Listing title.
purpose	Sale or rent.
property_type	Type label from the card, such as house or apartment.
price	Asking price when shown.
currency	Currency on the listing, usually MXN.
location	Area or neighbourhood.
address	Street address when shown.
publisher	Agency or seller name.
features	Amenity highlights from the card.
has_video	Whether the listing includes a video.
featured	Whether Vivanuncios marked the ad as premier.
posted_at	Last updated time.
image_url	First photo.

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
input_url	string	No	—	Paste a Vivanuncios search URL; overrides every filter when set.
purpose	string enum	No	sale	For sale or for rent.
property_type	string enum	No	all	House, apartment, condo, land, office, shop or warehouse, building.
location	string enum	No	all Mexico	Mexico City, Estado de México, Jalisco, Nuevo León, Puebla, Querétaro, Yucatán, Quintana Roo, Guanajuato, Baja California.
bedrooms	string enum	No	any	Minimum bedrooms, 1+ through 5+.
bathrooms	string enum	No	any	Minimum bathrooms, 1+ through 5+.
price_min	integer	No	—	Lowest price in Mexican pesos.
price_max	integer	No	—	Highest price in Mexican pesos.
advertiser	string enum	No	any	Agency or private.
sort	string enum	No	newest	Most relevant, newest, lowest price, or highest price.
max_results	integer	No	50	Maximum rows (1–2000).

Notes on filters

• Prefer the Apify input dropdowns — they use the same labels as Vivanuncios.
• input_url always wins over the other filters when provided.