ZAP Imoveis Scraper

Scrape property listings from zapimoveis.com.br, the largest property portal in Brazil. Extract 80+ structured fields per listing including price, condo fees, IPTU, GPS, full address, agency contact (phone, WhatsApp, CRECI license), agency tier, AI-tagged amenities, listing quality score, neighborhood POIs, H3 spatial-hash, and full media. Sale, rental, and new development modes. Search by city plus filters, or paste listing URLs and walk pagination.

Why This Scraper?

• 80+ fields per listing, the richest output for ZAP on Apify Store. Includes price, condo fee, IPTU (monthly + yearly), full address, GPS, all media, agency contact, tier, license, plus 40 ZAP-only fields the other scrapers drop.
• Rich location data that nobody else exposes: H3 spatial-hash array (3 resolutions, lets you do spatial joins out of the box), curated POI list (bus stops, train stations, pharmacies, supermarkets), gentrification "valuableZones" tags.
• AI-tagged amenities plus the listing quality score (LQS, 0-100) the platform uses to rank cards. Useful signal for downstream ranking.
• Verbatim raw passthrough (raw.listing, raw.account, raw.medias) so any future field the platform exposes appears in your dataset automatically, without a code change here.
• Two modes: search by city with structured filters, or paste any ZAP search URL and we'll walk pagination forward.
• Fast: pulls JSON directly, no DOM parsing, no detail-page round-trips. ~24 listings per API call.
• Cheap: typical run uses one Apify Residential session and minimal bandwidth. Free-tier-aware error message when no proxy is configured.

Data You Get

Sample shape, values are illustrative placeholders, not from a live listing.

Field	Example
identity.id	"0000000001"
identity.external_id	"REF-0001"
identity.legacy_id	null
source_context.url	"https://www.zapimoveis.com.br/imovel/.../id-0000000001/"
source_context.page_index	1
timestamps.created_at	"2026-01-01T00:00:00.000Z"
timestamps.updated_at	"2026-01-01T00:00:00.000Z"
content.title	"Sample Listing Title"
content.description	"Full property description here."
pricing.amount	450000
pricing.currency	"BRL"
pricing.offers[0].business_type	"SALE"
pricing.offers[0].monthly_condo_fee	850
pricing.offers[0].iptu	220
availability.status	"ACTIVE"
location.full_address	"Sample Street, Centro, Sao Paulo, SP"
location.neighborhood	"Centro"
location.city	"Sao Paulo"
location.state_code	"SP"
location.zip_code	"01000000"
location.coordinates.latitude	-23.5500
location.coordinates.longitude	-46.6333
location.h3	[{"index":"...","resolution":7},{"index":"...","resolution":8}]
location.pois_list	["BS:Sample Bus Stop","CS:Sample Market"]
location.valuable_zones	[{"name":"Sample Zone","category":"DISTRICT"}]
media.images[0].url	"https://resizedimgs.zapimoveis.com.br/img/.../000-fit-in-800x600.webp"
media.videos[0].url	"https://www.youtube.com/watch?v=00000000"
attributes.business	"SALE"
attributes.property_type	"UNIT"
attributes.unit_types	["APARTMENT"]
attributes.rooms.bedrooms	2
attributes.rooms.bathrooms	2
attributes.rooms.parking_spaces	1
attributes.area.usable_area	80
attributes.lqs	90
attributes.ai_amenities	["GARAGE","ELEVATOR"]
entities.seller.name	"Sample Agency"
entities.seller.tier	"GOLD"
entities.seller.license_number	"00000-F-SP"
entities.seller.legacy_zap_id	0
contact.phones	["+550000000000"]
contact.whatsapp	"+5500000000000"

How to Use

Search a city for rentals

{
  "mode": "search",
  "locations": ["Sao Paulo, SP"],
  "businessType": "RENTAL",
  "maxPages": 5,
  "maxListings": 100,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "BR"
  }
}

Search multiple cities, sale apartments only, with price filter

{
  "mode": "search",
  "locations": ["Sao Paulo, SP", "Rio de Janeiro, RJ", "Curitiba, PR"],
  "businessType": "SALE",
  "propertyType": "APARTMENT",
  "minPrice": 300000,
  "maxPrice": 800000,
  "minBedrooms": 2,
  "maxPages": 5,
  "maxListings": 200
}

New development launches (lancamentos)

{
  "mode": "search",
  "locations": ["Sao Paulo, SP"],
  "businessType": "SALE",
  "listingType": "DEVELOPMENT",
  "maxPages": 5,
  "maxListings": 100
}

Paste any ZAP URL and walk pagination

{
  "mode": "url",
  "urls": [
    "https://www.zapimoveis.com.br/aluguel/imoveis/sp+sao-paulo/",
    "https://www.zapimoveis.com.br/venda/apartamentos/rj+rio-de-janeiro/?precoMaximo=500000&quartos=2"
  ],
  "maxPages": 10,
  "maxListings": 250
}

Input Parameters

Parameter	Type	Default	Description
mode	string	search	search for filter-based, url for URL pass-through
locations	array[string]	["Sao Paulo, SP"]	Cities to search (search mode). Free-form, diacritics optional
businessType	string	SALE	SALE or RENTAL
listingType	string	USED	USED (resale) or DEVELOPMENT (lancamento)
propertyType	string	ANY	ANY, APARTMENT, HOME, PENTHOUSE, STUDIO, ALLOTMENT_LAND, FARM, OFFICE, COMMERCIAL_BUILDING, SHED_DEPOSIT_WAREHOUSE, BUSINESS
minPrice	integer	(none)	Minimum price in BRL
maxPrice	integer	(none)	Maximum price in BRL
minBedrooms	integer	(none)	Minimum bedrooms
minBathrooms	integer	(none)	Minimum bathrooms
minParkingSpaces	integer	(none)	Minimum parking spots
minUsableArea	integer	(none)	Minimum usable area in m²
maxUsableArea	integer	(none)	Maximum usable area in m²
sortBy	string	relevance	One of relevance, price-asc, price-desc, newest, area-desc. Note: ZAP injects sponsored / featured listings at fixed positions on price-asc, so the result is mostly-but-not-strictly ascending
urls	array[string]	(none)	URLs to walk (URL mode); pagination starts where the URL points
maxPages	integer	2000	Pages to walk per search/URL (~24 listings each). Defaults very high so maxListings is the effective stopping rule
maxListings	integer	20	Hard cap on output, 0 for unlimited
proxy	object	Apify Residential BR	Proxy config; residential strongly recommended

Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step after the scrape — the Apify dataset is never changed.

What gets written to the connector: a condensed, human-readable summary of each record — not the full JSON. Each item becomes one entry with a title and its key fields flattened to plain text. The complete record always stays in the Apify dataset.

1. Authorize a connector once under Apify → Settings → Integrations (Notion, Linear, Airtable, or Apify).
2. Select it in the "Pipe results into your apps" input field. (If the picker is empty, you haven't authorized a connector yet.)
3. For Notion, also set notionParentPageUrl to the page where items should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

Output Example

Sample shape, values are illustrative placeholders.

{
  "identity": {
    "id": "0000000001",
    "external_id": "REF-0001",
    "source_id": "00000000-0000-0000-0000-000000000000",
    "provider_id": null,
    "fingerprint": null,
    "image_source_id": null,
    "legacy_id": null
  },
  "source_context": {
    "url": "https://www.zapimoveis.com.br/imovel/.../id-0000000001/",
    "source_url": "https://www.zapimoveis.com.br/aluguel/imoveis/sp+sao-paulo/",
    "page_index": 1,
    "seed": { "id": "BR>Sao Paulo>NULL>Sao Paulo", "type": "location", "value": "Sao Paulo, SP" }
  },
  "timestamps": {
    "published_at": "2026-01-01T00:00:00.000Z",
    "created_at": "2026-01-01T00:00:00.000Z",
    "updated_at": "2026-01-01T00:00:00.000Z",
    "delivered_at": null
  },
  "content": {
    "title": "Sample Listing Title",
    "description": "Sample description text.",
    "ai_searchable_amenities": "Garage, Elevator"
  },
  "pricing": {
    "amount": 450000,
    "currency": "BRL",
    "offers": [
      {
        "business_type": "SALE",
        "amount": 450000,
        "currency": "BRL",
        "monthly_condo_fee": 850,
        "iptu": 220,
        "iptu_period": "MONTHLY",
        "yearly_iptu": 2640,
        "rental_period": null,
        "rental_warranties": [],
        "monthly_rental_total_price": null
      }
    ]
  },
  "availability": {
    "status": "ACTIVE",
    "show_price": true,
    "accept_exchange": null,
    "resale": false,
    "transacted": false,
    "non_activation_reason": null
  },
  "location": {
    "label": "Sample Street",
    "street": "Sample Street",
    "street_number": "0",
    "neighborhood": "Centro",
    "city": "Sao Paulo",
    "state_code": "SP",
    "state": "Sao Paulo",
    "zone": "Sample Zone",
    "zip_code": "01000000",
    "country": "BR",
    "full_address": "Sample Street Centro Sao Paulo SP",
    "ibge_city_id": "0000000",
    "coordinates": {
      "latitude": -23.5500,
      "longitude": -46.6333,
      "source": "GOOGLE"
    },
    "geocoding": {
      "address_type": "STREET",
      "precision": "ROOFTOP",
      "confidence": "VALID_STREET",
      "source": "CORREIOS"
    },
    "h3": [
      { "index": "0000000000000000", "resolution": 7 },
      { "index": "0000000000000000", "resolution": 8 },
      { "index": "0000000000000000", "resolution": 9 }
    ],
    "pois_list": ["BS:Sample Bus Stop", "CS:Sample Market", "PH:Sample Pharmacy"],
    "valuable_zones": [
      { "name": "Sample Zone", "category": "DISTRICT", "city": "Sao Paulo", "state": "Sao Paulo" }
    ],
    "near_by": {}
  },
  "media": {
    "images": [
      {
        "id": "00000000000000000000000000000000",
        "url": "https://resizedimgs.zapimoveis.com.br/img/vr-listing/00000000000000000000000000000000/vivareal-fit-in-800x600.webp",
        "url_template": "https://resizedimgs.zapimoveis.com.br/img/vr-listing/00000000000000000000000000000000/{description}.webp?action={action}&dimension={width}x{height}"
      }
    ],
    "videos": [],
    "other": [],
    "video_tour_link": null
  },
  "attributes": {
    "business": "SALE",
    "listing_type": "USED",
    "property_type": "UNIT",
    "publication_type": "STANDARD",
    "construction_status": "ConstructionStatus_NONE",
    "display_address_type": "ALL",
    "portal": "GRUPOZAP",
    "portals": ["OLX", "VIVAREAL", "ZAP"],
    "unit_types": ["APARTMENT"],
    "unit_sub_types": [],
    "usage_types": ["RESIDENTIAL"],
    "modality": [],
    "amenities": [],
    "merged_amenities": ["GARAGE", "ELEVATOR"],
    "ai_amenities": ["GARAGE", "ELEVATOR"],
    "stamps": [],
    "flags": [],
    "lqs": 90,
    "quality_scores": { "lqsBeta": 90, "deprecated": 80.0 },
    "buildings": 1,
    "units_on_the_floor": 4,
    "unit_floor": 5,
    "floors": [5],
    "ceiling_height": [],
    "condominium_name": "Sample Condominium",
    "unique_unit": false,
    "rooms": {
      "bedrooms": 2,
      "bedroom_options": [2],
      "bathrooms": 2,
      "bathroom_options": [2],
      "suites": 1,
      "suite_options": [1],
      "parking_spaces": 1,
      "parking_space_options": [1]
    },
    "area": {
      "usable_area": 80,
      "usable_area_options": [80],
      "total_area": null,
      "total_area_options": []
    }
  },
  "entities": {
    "seller": {
      "account_id": "00000000-0000-0000-0000-000000000000",
      "advertiser_id": "00000000-0000-0000-0000-000000000000",
      "name": "Sample Agency",
      "profile_url": "https://www.zapimoveis.com.br/imobiliaria/0000/",
      "license_number": "00000-F-SP",
      "tier": "GOLD",
      "logo_url": "https://resizedimgs.zapimoveis.com.br/img/vr-listing/00000000000000000000000000000000/vivareal-fit-in-800x600.webp",
      "logo_url_template": "https://resizedimgs.zapimoveis.com.br/img/vr-listing/00000000000000000000000000000000/{description}.webp?action={action}&dimension={width}x{height}",
      "verified": true,
      "is_chat_enabled": true,
      "show_address": true,
      "created_at": "2020-01-01T00:00:00Z",
      "legacy_vivareal_id": 0,
      "legacy_zap_id": 0,
      "website_url": null,
      "billing_address": {
        "street": "Sample Street",
        "streetNumber": "0",
        "neighborhood": "Centro",
        "city": "Sao Paulo",
        "state": "SP"
      },
      "config": { "isChatEnabled": true, "verified": true }
    }
  },
  "contact": {
    "phones": ["1100000000", "11900000000"],
    "whatsapp": "11900000000",
    "chat": null
  }
}

Plan Requirement

ZAP rejects datacenter IP ranges. Use Apify Residential, country = BR for working extraction. The actor sets that as the default in the input form.

• Free plan: does not include residential. Runs return zero items, the actor surfaces a clear error record explaining the upgrade path. Move to Starter or higher at https://apify.com/pricing.
• Starter / Scale / Business: include residential by default. Country = BR is recommended. Country = US is also accepted.