{ "openapi": "3.0.1", "info": { "title": "Vivanuncios Scraper — Mexico Property Listings", "description": "Scrape Vivanuncios (vivanuncios.com.mx) property listings for sale or rent by type and state, or from any listing page: price in MXN or USD, beds, baths, parking, areas, zone, coordinates, description and advertiser. Up to 150 listings per search.", "version": "0.1", "x-build-id": "5IMLexIRMNftiXuJB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reventadata~vivanuncios-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reventadata-vivanuncios-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/reventadata~vivanuncios-scraper/runs": { "post": { "operationId": "runs-sync-reventadata-vivanuncios-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/reventadata~vivanuncios-scraper/run-sync": { "post": { "operationId": "run-sync-reventadata-vivanuncios-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": { "operation": { "title": "Operation", "enum": [ "sale", "rent" ], "type": "string", "description": "Buy or rent. Together with Property types and States it builds the Vivanuncios searches; ignored when Start URLs are given.", "default": "sale" }, "propertyTypes": { "title": "Property types", "type": "array", "description": "One search per type: houses, apartments, land (sale only), commercial premises, offices, vacation houses (rent only) or all property types. Ignored when Start URLs are given.", "items": { "type": "string", "enum": [ "houses", "apartments", "land", "commercial", "offices", "vacation", "all" ], "enumTitles": [ "Houses", "Apartments", "Land (sale only)", "Commercial premises", "Offices", "Vacation houses (rent only)", "All property types" ] }, "default": [ "houses" ] }, "states": { "title": "States", "type": "array", "description": "Limit each search to these Mexican states, one search per state and type. Leave empty for the whole country. For one city or neighbourhood, paste its Vivanuncios listing page into Start URLs.", "items": { "type": "string", "enum": [ "aguascalientes", "baja-california", "baja-california-sur", "campeche", "chiapas", "chihuahua", "coahuila", "colima", "distrito-federal", "durango", "guanajuato", "guerrero", "hidalgo", "jalisco", "estado-de-mexico", "michoacan", "morelos", "nayarit", "nuevo-leon", "oaxaca", "puebla", "queretaro", "quintana-roo", "san-luis-potosi", "sinaloa", "sonora", "tabasco", "tamaulipas", "tlaxcala", "veracruz", "yucatan", "zacatecas" ], "enumTitles": [ "Aguascalientes", "Baja California", "Baja California Sur", "Campeche", "Chiapas", "Chihuahua", "Coahuila", "Colima", "Mexico City (CDMX)", "Durango", "Guanajuato", "Guerrero", "Hidalgo", "Jalisco", "State of Mexico", "Michoacan", "Morelos", "Nayarit", "Nuevo Leon", "Oaxaca", "Puebla", "Queretaro", "Quintana Roo", "San Luis Potosi", "Sinaloa", "Sonora", "Tabasco", "Tamaulipas", "Tlaxcala", "Veracruz", "Yucatan", "Zacatecas" ] }, "default": [] }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Vivanuncios listing pages to read instead of the selectors above, for example https://www.vivanuncios.com.mx/s-casas-en-venta/guadalajara/v1c1293l14822p1. Addresses with a query string (?pr=, ?q=, ?sort= ...) are refused: the site's robots.txt disallows them, so filters run after the fetch. A page number in the address is ignored; the Actor walks pages itself.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum items", "minimum": 1, "type": "integer", "description": "Total number of listings to save across all searches. Each result page holds 30.", "default": 100 }, "maxPages": { "title": "Maximum pages per search", "minimum": 1, "maximum": 5, "type": "integer", "description": "Result pages to read per search, 30 listings each. The site's robots.txt allows pages 1 to 5 only, so 5 is the ceiling: one search yields at most 150 listings. For more, add states or paste narrower Start URLs (one city or neighbourhood each).", "default": 5 }, "priceCurrency": { "title": "Price currency", "enum": [ "MXN", "USD" ], "type": "string", "description": "Currency the minimum and maximum price are read in. Listings priced in the other currency are dropped when a price limit is set.", "default": "MXN" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Drop listings priced below this amount, in the Price currency. Applied after the fetch." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Drop listings priced above this amount, in the Price currency. Applied after the fetch." }, "minBedrooms": { "title": "Minimum bedrooms", "minimum": 0, "type": "integer", "description": "Drop listings with fewer bedrooms, and listings that state none (land, commercial, developments). Applied after the fetch." }, "minBathrooms": { "title": "Minimum bathrooms", "minimum": 0, "type": "integer", "description": "Drop listings with fewer full bathrooms than this, and listings that state none. Half bathrooms are not counted. Applied after the fetch." }, "minParkingSpaces": { "title": "Minimum parking spaces", "minimum": 0, "type": "integer", "description": "Drop listings with fewer parking spaces, and listings that state none. Applied after the fetch." }, "minBuiltAreaM2": { "title": "Minimum built area (m2)", "minimum": 0, "type": "integer", "description": "Drop listings with less built area, and listings that state none. Pages the site occasionally serves without its data block (2 of 24 probe pages, none of 40 in the test run) carry the lot size only, so those listings are dropped by this filter." }, "minLandAreaM2": { "title": "Minimum land area (m2)", "minimum": 0, "type": "integer", "description": "Drop listings with a smaller lot, and listings that state none. Applied after the fetch." }, "includeKeywords": { "title": "Include keywords", "type": "array", "description": "Keep a listing only when its title, description or location contains at least one of these words. Accents and capitals are ignored (alberca matches Alberca).", "default": [], "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop a listing when its title, description or location contains any of these words. Accents and capitals are ignored.", "default": [], "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Vivanuncios sits behind Cloudflare, which refused plain and datacenter connections, and 24 of 25 residential ones, when this Actor was built. The default is Apify Unblocker; change it only if you know another group passes.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }