Zap Imóveis scraper

This scraper extracts detailed real estate listings from Zap Imóveis, allowing you to set multiple filters to refine your search. Supported filters include listing type (rentals or sales), city, state, price range, usable area range, unit type, usage (residential or commercial), and number of bedrooms. The scraper returns a structured, machine-readable dataset.

Input Format

The input should be provided as a JSON object with the following structure:

1{
2  "type": "RENTAL",
3  "city": "São Paulo",
4  "state": "São Paulo",
5  "page": 1,
6  "priceMin": 1000,
7  "priceMax": 3000,
8  "usableAreaMin": 50,
9  "usableAreaMax": 200,
10  "unitType": "APARTMENT",
11  "unitUsage": "RESIDENTIAL",
12  "bedrooms": ["1", "2"]
13}

Input Fields

• type (string, required): Type of listing.

  • Options: "RENTAL" (for rental listings), "SALE" (for properties for sale)
  • Default: "RENTAL"

• city (string, required): The name of the city.

  • Example: "São Paulo"

• state (string, required): The name of the state.

  • Example: "São Paulo"

• page (integer, optional): The page number to start scraping from. The scraper will load data from this page onward.

  • Default: 1
  • Example: 2

• priceMin (integer, optional): Minimum price range.

  • Example: 1000 for minimum monthly rent of 1000.

• priceMax (integer, optional): Maximum price range.

  • Example: 3000 for maximum monthly rent of 3000.

• usableAreaMin (integer, optional): Minimum usable area in square meters.

  • Example: 50 for at least 50 sqm.

• usableAreaMax (integer, optional): Maximum usable area in square meters.

  • Example: 200 for up to 200 sqm.

• unitType (string, optional): Type of property unit.

  • Options: "ALLOTMENT_LAND", "APARTMENT", "BUILDING", "BUSINESS", "FARM", "HOME", "HOTEL", "OFFICE", "SHED_DEPOSIT_WAREHOUSE"
  • Example: "APARTMENT"

• unitUsage (string, optional): Intended usage of the unit.

  • Options: "RESIDENTIAL", "COMMERCIAL"
  • Default: "RESIDENTIAL"
  • Example: "COMMERCIAL"

• bedrooms (array of strings, optional): Number of bedrooms to filter by.

  • Options: "1", "2", "3", "4" (where "4" represents 4 or more)
  • Example: ["1", "2"] to filter properties with either 1 or 2 bedrooms.

Example

The following example retrieves property listings for sale in Curitiba, Paraná, starting from page 1, priced between 500,000 and 1,000,000, with a usable area between 80 and 150 sqm, filtering only for residential apartments with 2 or 3 bedrooms:

1{
2  "type": "SALE",
3  "city": "Curitiba",
4  "state": "Paraná",
5  "page": 1,
6  "priceMin": 500000,
7  "priceMax": 1000000,
8  "usableAreaMin": 80,
9  "usableAreaMax": 150,
10  "unitType": "APARTMENT",
11  "unitUsage": "RESIDENTIAL",
12  "bedrooms": ["2", "3"]
13}

This setup will return a dataset of properties that match the specified criteria, enabling more targeted and refined searches.

Output

Output will consist of an vector of JSON objects with the following keys:

• listing: probably where the information you are looking for is. Information related to the property (area, amenities, price, etc);
• account and accountLink: information related to the real estate agent (contact information and name);
• link: slug and metadata information;
• medias: vector of images for the listing.

More details on the output can be found in the example to follow.

Example Output

1[
2  {
3    "listing": {
4      "contractType": "REAL_ESTATE",
5      "sourceId": "69a675d7-73ee-37b6-be8c-99498907a04e",
6      "displayAddressType": "ALL",
7      "amenities": [
8        "GYM",
9        "BARBECUE_GRILL",
10        "GOURMET_SPACE",
11        "POOL",
12        "PLAYGROUND",
13        "PARTY_HALL",
14        "DISABLED_ACCESS",
15        "BICYCLES_PLACE",
16        "COWORKING",
17        "SPA",
18        "ELEVATOR",
19        "CONCIERGE_24H",
20        "GATED_COMMUNITY",
21        "ELECTRONIC_GATE",
22        "PETS_ALLOWED",
23        "AIR_CONDITIONING",
24        "FURNISHED"
25      ],
26      "usableAreas": [
27        107
28      ],
29      "constructionStatus": "ConstructionStatus_NONE",
30      "listingType": "USED",
31      "description": "O apartamento no bairro Centro tem 107 metros quadrados com 3 quartos sendo 2 suites e 2 banheiros Possui área de fitness, espaço gourmet, área verde de jardim, parquinho com diferentes brinquedos, salão para festas e eventos. Vai lhe possibilitar curtir os dias mais quentes na piscina, praticar diversos esportes na quadra poliesportiva, todo o conforto do ar condicionado nos dias mais quentes.Churrasqueira para você aproveitar nos momentos de descontração. Elevador que garante o transporte das suas malas e compras. Encontra-se em um condomínio protegido por muros. É mobiliado.",
32      "title": "Apartamento para alugar tem 107 metros quadrados com 3 quartos em Centro - Curitiba - PR",
33      "stamps": [],
34      "createdAt": "2024-10-11T21:29:34.969+00:00",
35      "floors": [],
36      "unitTypes": [
37        "APARTMENT"
38      ],
39      "nonActivationReason": "NonActivationReason_NONE",
40      "providerId": "",
41      "propertyType": "UNIT",
42      "unitSubTypes": [],
43      "unitsOnTheFloor": 0,
44      "legacyId": "",
45      "id": "2748770504",
46      "portal": "GRUPOZAP",
47      "unitFloor": 10,
48      "parkingSpaces": [
49        2
50      ],
51      "updatedAt": "2024-10-11T23:06:57.247+00:00",
52      "address": {
53        "city": "Curitiba",
54        "neighborhood": "Centro",
55        "street": "Rua Mariano Torres",
56        "streetNumber": "(redacted)",
57        "point": {
58          "lat": -25.431307,
59          "lon": -49.261889,
60          "source": "GOOGLE"
61        },
62        "stateAcronym": "PR"
63      },
64      "suites": [
65        2
66      ],
67      "publicationType": "PREMIUM",
68      "externalId": "1F4528C3",
69      "bathrooms": [
70        2
71      ],
72      "usageTypes": [
73        "RESIDENTIAL"
74      ],
75      "totalAreas": [],
76      "advertiserId": "d5193cc8-51ff-2b76-7b59-652159b5361b",
77      "advertiserContact": {
78        "chat": "",
79        "phones": [
80          "(redacted)"
81        ]
82      },
83      "whatsappNumber": "(redacted)",
84      "bedrooms": [
85        3
86      ],
87      "acceptExchange": false,
88      "pricingInfos": [
89        {
90          "businessType": "RENTAL",
91          "yearlyIptu": 0,
92          "price": 2700,
93          "monthlyCondoFee": 800,
94          "rentalInfo": {
95            "period": "MONTHLY",
96            "warranties": [
97              "SECURITY_DEPOSIT"
98            ],
99            "monthlyRentalTotalPrice": 3500
100          }
101        }
102      ],
103      "showPrice": true,
104      "resale": false,
105      "buildings": 0,
106      "capacityLimit": [],
107      "status": "ACTIVE"
108    },
109    "account": {
110      "id": "d5193cc8-51ff-2b76-7b59-652159b5361b",
111      "name": "(redacted)",
112      "licenseNumber": "",
113      "showAddress": false,
114      "legacyVivarealId": 845504,
115      "legacyZapId": 0,
116      "createdDate": "2024-10-11T21:17:43Z",
117      "tier": "platinum"
118    },
119    "medias": [
120      {
121        "id": "41502485957c3def43b5ed59695674de",
122        "url": "https://resizedimgs.zapimoveis.com.br/{action}/{width}x{height}/named.images.sp/41502485957c3def43b5ed59695674de/{description}.webp",
123        "type": "IMAGE"
124      },
125      [...] (redacted)
126    ],
127    "accountLink": {
128      "name": "(redacted)",
129      "href": "/imobiliaria/(number)/",
130      "rel": "",
131      "data": {}
132    },
133    "link": {
134      "name": "Apartamento com 3 Quartos para alugar, 107m²",
135      "href": "/imovel/aluguel-apartamento-3-quartos-mobiliado-centro-curitiba-107m2-id-(redacted)/",
136      "rel": "",
137      "data": {
138        "city": "Curitiba",
139        "neighborhood": "Centro",
140        "state": "",
141        "street": "Rua Mariano Torres",
142        "streetNumber": "(redacted)",
143        "zone": ""
144      }
145    }
146  }
147]