Skip to main content
New

The YouTube API is live.

Try it

Brazilian property listings for
proptech, CRMs and agents.

Search sale, rent, short-stay, auction and new-development listings on imovelweb, open any listing, and get each agency's phone numbers and ratings from seven documented endpoints.

  • 7 documented endpoints
  • Typed Python and TypeScript clients
  • 1 or 2 credits a call, 0 when imovelweb fails
GETapi.tapline.sh/v1/imovelweb/listings
1
{
2
  "total": 1641252,
3
  "title": "1.641.252 Imóveis à venda em São Paulo, SP",
4
  "listings": [
5
    {
6
      "id": "3035755952",
7
      "code": "23073",
8
      "url": "https://www.imovelweb.com.br/propriedades/escritorio-itaim-bibi-sao-paulo-3035755952.html",
9
      "posting_type": "property",
10
      "status": "online",
11
      "title": "Escritório, Itaim Bibi - São Paulo",
12
      "generated_title": "Comercial · 204m² · 4 Vagas",
13
      "property_type": "commercial",
14
      "operations": [
15
        {
16
          "operation": "sale",
17
          "price": {
18
            "amount": 1836000,
19
            "currency": "BRL",
20
            "display": "1.836.000"
21
          },
22
          "price_drop_percent": null
23
        },
24
        {
25
          "operation": "rent",
26
          "price": {
27
            "amount": 7000,
28
            "currency": "BRL",
29
            "display": "7.000"
30
          },
31
          "price_drop_percent": null
32
        }
33
      ],
34
      "location": {
35
        "address": "Avenida Engenheiro Luís Carlos Berrini, 877",
36
        "address_visibility": "exact",
37
        "coordinates_visibility": null,
38
        "country": {
39
          "id": "V1-A-2",
40
          "name": "Brasil",
41
          "acronym": null
42
        },
43
        "state": {
44
          "id": "V1-B-265",
45
          "name": "São Paulo",
46
          "acronym": "SP"
47
        },
48
        "city": {
49
          "id": "V1-C-109668",
50
          "name": "São Paulo",
51
          "acronym": null
52
        },
53
        "district": {
54
          "id": "V1-D-525467",
55
          "name": "Itaim Bibi",
56
          "acronym": null
57
        },
58
        "sub_district": null,
59
        "neighbourhood": null,
60
        "latitude": -23.603927612304688,
61
        "longitude": -46.692054748535156,
62
        "static_map_url": "https://maps.google.com/maps/api/staticmap?center=-23.6039276123046875,-46.69205474853515625&zoom=16&key=AIza-redacted&size=780x456&sensor=true&scale=2&signature=NoOGbHproovd2Kop6BXRjaUKN_4=&channel=rplis-iw"
63
      },
64
      "ad_tier": "super_highlighted",
65
      "is_premier": true,
66
      "is_reserved": false,
67
      "quintoandar_network": null,
68
      "visit_booking_url": null,
69
      "description": "Amplo conjunto residencial na Av. Luis Carlos Berrini. 200 metros. Varias possibilidades de layout. Arejado e com bastante iluminação natural. Copa cozinha. 3 banheiros. Predio com toda a infra estrutura e proximidade de todo tipo de comercio. Condução facil. Edifício morumbi, Conjunto, 204 m², à venda ou aluguel, Cidade Monções - São Paulo/sp. locação E venda comercial - brooklin - 204, 00 M²Av. Eng. Luis Carlos Berrini, 801 - Brooklin - São Paulo - spimóvel à 7 minutos da Estação Berrini cptm e a Av Nações Unidas, cerca de 7 minutos da Av. Dos Bandeirantes. Excelente valor abaixo do valor de mercado! agende ja sua visita! forte prime imoveis. tel: 11 . Código do Anúncio: . A Forte Prime Imóveis e referencia no mercado imobiliário de alto padrão em São Paulo, atuando nos principais bairros da zona sul, como Campo Belo, Moema, Itaim Bibi, Brooklin e Vila Olimpia. Com uma equipe especializada, oferecemos soluções completas em compra, venda, locação e administração de imóveis, sempre com atendimento personalizado e estratégia focada nos objetivos de cada cliente. Nosso compromisso é com a confiança e a satisfação em cada negociação creci 18962-J.",
70
      "ai_description": null,
71
      "condo_fee": {
72
        "amount": 3900,
73
        "currency": "BRL",
74
        "display": "3.900"
75
      },
76
      "bedrooms": null,
77
      "bathrooms": 3,
78
      "suites": null,
79
      "parking_spaces": 4,
80
      "building_age_years": 26,
81
      "total_area_m2": 437,
82
      "usable_area_m2": 204,
83
      "highlighted_amenities": [],
84
      "photos": [
85
        {
86
          "kind": "photo",
87
          "caption": "Escritório, Itaim Bibi - São Paulo · Escritório, Itaim Bibi - São Paulo",
88
          "width": 1024,
89
          "height": 768,
90
          "url_1200x1200": null,
91
          "url_720x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/35/75/59/52/720x532/6830216480.jpg?isFirstImage=true",
92
          "url_360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/35/75/59/52/360x266/6830216480.jpg?isFirstImage=true",
93
          "url_215x159": null,
94
          "url_100x75": null,
95
          "url_130x70": null,
96
          "resized_url_1200x1200": null,
97
          "resized_url_720x532": null
98
        },
99
        {
100
          "kind": "photo",
101
          "caption": "ae46870637d050cffc513bc3e958305b",
102
          "width": 1024,
103
          "height": 768,
104
          "url_1200x1200": null,
105
          "url_720x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/35/75/59/52/720x532/6714880856.jpg",
106
          "url_360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/35/75/59/52/360x266/6714880856.jpg",
107
          "url_215x159": null,
108
          "url_100x75": null,
109
          "url_130x70": null,
110
          "resized_url_1200x1200": null,
111
          "resized_url_720x532": null
112
        }
113
      ],
114
      "photo_count": 13,
115
      "has_video": true,
116
      "has_tour": true,
117
      "has_floor_plans": false,
118
      "publisher": {
119
        "id": "15458662",
120
        "name": "Forte Prime Imóveis",
121
        "type": "agency",
122
        "url": "https://www.imovelweb.com.br/imobiliarias/forte-prime-imoveis_15458662-imoveis.html",
123
        "logo_url": "https://imgbr.imovelwebcdn.com/empresas/2/00/15/45/86/62/130x70/logo_forte-prime-imoveis_1768935745532.jpg",
124
        "creci": "18962J",
125
        "main_phone": null,
126
        "partial_phone": null,
127
        "chat_url": null,
128
        "is_premier": true,
129
        "slug": "forteprimeimoveis",
130
        "joined_at": "2014-09-21T04:00:00+00:00",
131
        "joined_year": null,
132
        "active_listing_count": null,
133
        "raw": {
134
          "approved": false,
135
          "id_portal": "101",
136
          "publisherTags": [],
137
          "parentPublisher": null,
138
          "publisherStatistics": null,
139
          "quantity_posting_by_operation_type": null,
140
          "slotFilterUrl": null
141
        }
142
      },
143
      "whatsapp": "+551150283144",
144
      "logo_url": null,
145
      "duplicate": null,
146
      "is_foreclosure_auction": false,
147
      "promotion_title": null,
148
      "published_days_ago": null,
149
      "modified_at": "2026-10-16T23:20:30-04:00",
150
      "development": null,
151
      "units": [],
152
      "raw": {
153
        "publicationAreaId": "3",
154
        "alphanumeric_key": "44rpc52",
155
        "avisoDuplicado": "aviso_sinduplicado_3035755952",
156
        "alt": false,
157
        "pixelPlus": false,
158
        "publisherSlot": "aviso_sinslot_3035755952",
159
        "slot": null,
160
        "slotColor": null,
161
        "sponsor": null,
162
        "house": null,
163
        "action": null,
164
        "features": null,
165
        "iptu": null,
166
        "ownerDomain": null,
167
        "viewPhoneAnonymousLead": false,
168
        "earlyDemandCronut": false,
169
        "leadWhatsappPostingRequestData": true,
170
        "leadWhatsappDevelopmentRequestData": true,
171
        "trigger_pills": [],
172
        "requestVisit5A": {
173
          "activeModal5A": false,
174
          "activeModalPostlead5A": false,
175
          "requestVisitUrl": {
176
            "urlControl": null,
177
            "urlVariant": null,
178
            "urlWhatsappConcierge": null,
179
            "urlEarlyDemand": null
180
          },
181
          "cronutSell": false,
182
          "cronutRent": false,
183
          "cronutEarlyDemand": false,
184
          "showWhatsapp": false
185
        },
186
        "mainFeatures": {},
187
        "developmentFeatures": {},
188
        "flagsFeatures": [],
189
        "highlightedFeatures": []
190
      }
191
    },
192
    {
193
      "id": "2954322662",
194
      "code": "41H9AM2",
195
      "url": "https://www.imovelweb.com.br/propriedades/apartamento-vila-mariana-essence-vila-mariana-2954322662.html",
196
      "posting_type": "development",
197
      "status": "online",
198
      "title": "Apartamento Vila Mariana - Essence Vila Mariana",
199
      "generated_title": "Imóvel novo vertical",
200
      "property_type": "new_development_vertical",
201
      "operations": [
202
        {
203
          "operation": "sale",
204
          "price": null,
205
          "price_drop_percent": null
206
        }
207
      ],
208
      "location": {
209
        "address": "Rua Paula Ney, 494",
210
        "address_visibility": "exact",
211
        "coordinates_visibility": null,
212
        "country": {
213
          "id": "V1-A-2",
214
          "name": "Brasil",
215
          "acronym": null
216
        },
217
        "state": {
218
          "id": "V1-B-265",
219
          "name": "São Paulo",
220
          "acronym": "SP"
221
        },
222
        "city": {
223
          "id": "V1-C-109668",
224
          "name": "São Paulo",
225
          "acronym": null
226
        },
227
        "district": {
228
          "id": "V1-D-526858",
229
          "name": "Vila Mariana",
230
          "acronym": null
231
        },
232
        "sub_district": null,
233
        "neighbourhood": null,
234
        "latitude": -23.5797142,
235
        "longitude": -46.634647,
236
        "static_map_url": "https://maps.google.com/maps/api/staticmap?center=-23.579714200000001511625669081695377826690673828125,-46.634647000000001071384758688509464263916015625&zoom=16&key=AIza-redacted&size=780x456&sensor=true&scale=2&signature=vF0D-jPnK7s1lEorChN5welSjBQ=&channel=rplis-iw"
237
      },
238
      "ad_tier": "exclusive",
239
      "is_premier": true,
240
      "is_reserved": false,
241
      "quintoandar_network": null,
242
      "visit_booking_url": null,
243
      "description": "Apartamento na Vila Mariana - Essence Vila Mariana. Lazer, conforto, espaço, tranquilidade e segurança são essenciais para a sua qualidade de vida? Se sim, esse é o empreendimento perfeito para você. Conheça o Essence Vila Mariana, e toda a praticidade que ele pode trazer para a sua vida. Com uma localização privilegiada, no coração de São Paulo, em um dos melhores bairros para se viver na capital, a Vila Mariana. Ele possui uma infraestrutura de lazer completa e pensada em cada detalhe, proporcionando tudo que é fundamental para você aproveitar o melhor da vida.",
244
      "ai_description": null,
245
      "condo_fee": null,
246
      "bedrooms": null,
247
      "bathrooms": null,
248
      "suites": null,
249
      "parking_spaces": null,
250
      "building_age_years": null,
251
      "total_area_m2": null,
252
      "usable_area_m2": null,
253
      "highlighted_amenities": [
254
        "barbecue",
255
        "gym",
256
        "pool"
257
      ],
258
      "photos": [
259
        {
260
          "kind": "photo",
261
          "caption": "Imóvel novo vertical , São Paulo · Apartamento Vila Mariana - Essence Vila Mariana",
262
          "width": 892,
263
          "height": 667,
264
          "url_1200x1200": null,
265
          "url_720x532": "https://imgbr.imovelwebcdn.com/avisos/2/29/54/32/26/62/720x532/6712211945.jpg?isFirstImage=true",
266
          "url_360x266": "https://imgbr.imovelwebcdn.com/avisos/2/29/54/32/26/62/360x266/6712211945.jpg?isFirstImage=true",
267
          "url_215x159": null,
268
          "url_100x75": null,
269
          "url_130x70": null,
270
          "resized_url_1200x1200": null,
271
          "resized_url_720x532": null
272
        },
273
        {
274
          "kind": "photo",
275
          "caption": "Imóvel novo vertical en   Vila Mariana",
276
          "width": 447,
277
          "height": 670,
278
          "url_1200x1200": null,
279
          "url_720x532": "https://imgbr.imovelwebcdn.com/avisos/2/29/54/32/26/62/720x532/6712211938.jpg",
280
          "url_360x266": "https://imgbr.imovelwebcdn.com/avisos/2/29/54/32/26/62/360x266/6712211938.jpg",
281
          "url_215x159": null,
282
          "url_100x75": null,
283
          "url_130x70": null,
284
          "resized_url_1200x1200": null,
285
          "resized_url_720x532": null
286
        }
287
      ],
288
      "photo_count": 21,
289
      "has_video": false,
290
      "has_tour": false,
291
      "has_floor_plans": true,
292
      "publisher": {
293
        "id": "15435035",
294
        "name": "Cáucaso Construtora",
295
        "type": "builder",
296
        "url": "https://www.imovelweb.com.br/imobiliarias/caucaso-construtora_15435035-imoveis.html",
297
        "logo_url": "https://imgbr.imovelwebcdn.com/empresas/2/00/15/43/50/35/130x70/logo_caucaso-construtora_1709238485157.jpg",
298
        "creci": "19.947J",
299
        "main_phone": null,
300
        "partial_phone": null,
301
        "chat_url": null,
302
        "is_premier": true,
303
        "slug": "caucasoconstrutora",
304
        "joined_at": "2014-09-21T04:00:00+00:00",
305
        "joined_year": null,
306
        "active_listing_count": null,
307
        "raw": {
308
          "approved": false,
309
          "id_portal": "101",
310
          "publisherTags": [],
311
          "parentPublisher": null,
312
          "publisherStatistics": null,
313
          "quantity_posting_by_operation_type": null,
314
          "slotFilterUrl": null
315
        }
316
      },
317
      "whatsapp": "+5511981798089",
318
      "logo_url": null,
319
      "duplicate": null,
320
      "is_foreclosure_auction": false,
321
      "promotion_title": null,
322
      "published_days_ago": null,
323
      "modified_at": "2026-10-03T04:57:55-04:00",
324
      "development": {
325
        "stage": "ready_to_move",
326
        "delivery": {
327
          "is_immediate": true,
328
          "year": null,
329
          "month": null
330
        },
331
        "unit_count": 4,
332
        "price": {
333
          "min": null,
334
          "max": 975000,
335
          "currency": "BRL"
336
        },
337
        "bedrooms": {
338
          "min": 2,
339
          "max": 2
340
        },
341
        "bathrooms": {
342
          "min": 1,
343
          "max": 1
344
        },
345
        "parking_spaces": {
346
          "min": 1,
347
          "max": 1
348
        },
349
        "usable_area_m2": {
350
          "min": 61,
351
          "max": 66
352
        },
353
        "total_area_m2": null,
354
        "steps": [
355
          {
356
            "stage": "launching_soon",
357
            "status": "done"
358
          },
359
          {
360
            "stage": "off_plan",
361
            "status": "done"
362
          }
363
        ],
364
        "prices_by_operation": [],
365
        "unit_groups": [
366
          {
367
            "title": "Apartamentos de 2 quartos",
368
            "operation": "sale",
369
            "property_type": "apartment",
370
            "bedrooms": 2,
371
            "unit_count": 3,
372
            "price": {
373
              "min": 975000,
374
              "max": 975000,
375
              "currency": "BRL"
376
            },
377
            "usable_area_m2": {
378
              "min": 61,
379
              "max": 66
380
            },
381
            "total_area_m2": null,
382
            "raw": {
383
              "picture": null
384
            }
385
          }
386
        ],
387
        "raw": {
388
          "ambientes": {
389
            "tuple0": null,
390
            "tuple1": null
391
          }
392
        }
393
      },
394
      "units": [],
395
      "raw": {
396
        "publicationAreaId": "200",
397
        "alphanumeric_key": "41h9am2",
398
        "avisoDuplicado": null,
399
        "alt": false,
400
        "pixelPlus": false,
401
        "publisherSlot": "aviso_sinslot_2954322662",
402
        "slot": null,
403
        "slotColor": null,
404
        "sponsor": null,
405
        "house": null,
406
        "action": null,
407
        "features": null,
408
        "iptu": null,
409
        "ownerDomain": null,
410
        "viewPhoneAnonymousLead": false,
411
        "earlyDemandCronut": false,
412
        "leadWhatsappPostingRequestData": true,
413
        "leadWhatsappDevelopmentRequestData": true,
414
        "trigger_pills": [],
415
        "requestVisit5A": {
416
          "activeModal5A": false,
417
          "activeModalPostlead5A": false,
418
          "requestVisitUrl": {
419
            "urlControl": null,
420
            "urlVariant": null,
421
            "urlWhatsappConcierge": null,
422
            "urlEarlyDemand": null
423
          },
424
          "cronutSell": false,
425
          "cronutRent": false,
426
          "cronutEarlyDemand": false,
427
          "showWhatsapp": false
428
        },
429
        "mainFeatures": {},
430
        "developmentFeatures": {},
431
        "flagsFeatures": [],
432
        "highlightedFeatures": []
433
      }
434
    }
435
  ],
436
  "applied_filters": [
437
    {
438
      "filter": "location_id",
439
      "values": [
440
        "V1-C-109668"
441
      ]
442
    },
443
    {
444
      "filter": "operation",
445
      "values": [
446
        "sale"
447
      ]
448
    }
449
  ],
450
  "pagination": {
451
    "next_cursor": "eyJ2IjoxLCJwYWdlIjoyfQ",
452
    "completion": null
453
  },
454
  "raw": {
455
    "total5A": 96696,
456
    "appliedFilters": [
457
      {
458
        "type": "location",
459
        "options": [
460
          {
461
            "label": "São Paulo",
462
            "type": "city",
463
            "min": "109668"
464
          }
465
        ],
466
        "renderType": 5
467
      },
468
      {
469
        "type": "operationType",
470
        "options": [
471
          {
472
            "label": "Comprar",
473
            "min": "1"
474
          }
475
        ],
476
        "renderType": 3
477
      }
478
    ],
479
    "developmentData": {}
480
  }
481
}
01endpoints

From a city search to the broker's phone.

Find a location id, search and map listings, open one, see which agencies advertise the same property, and get an agency's phone numbers and ratings.

GETSearch Listings2 credits
GETMap Markers1 credit
GETListing Details2 credits
GETSimilar Listings1 credit
GETDuplicate Publishers1 credit
GETBroker Profile2 credits
GETLocation IDs1 credit
02try it live

Try imovelweb live.
No account needed.

Search listings, map them, open one, or look up a location id, and see the result.

Search Listings

Live imovelweb data · 5 free runs per operation each day

Search Listings

Use Run to run this request against live imovelweb data. No API key needed.

Run a request to fetch a live response.
03pricing

Start free.
Scale when you need to.

Use one credit pool across every live Tapline API. Upgrade only when you need more requests or a higher rate limit.

 

Free

$0
No card required
100 API credits
All endpointsOnly successful requests use credits1 req/s
 

Pay As You Go

$9
one-time payment
From 5,000 credits
All endpointsCredits never expire5 req/s
Buy credits
 

Starter

$39
/ month
billed $468/yrSave $120/yr
100,000 credits/mo
All endpointsEmail support5 req/s
 

Enterprise

Custom
Priced to your workload
More than 4,000,000 credits/mo
Higher rate limitsCustom endpointsAnnual contracts
Talk to us
04questions

Questions before you wire it in.

Yes. The live demo above runs search, map markers, listing details and location lookups without an account or API key, up to five times per operation each day. Broker profiles, similar listings and duplicate publishers show a recorded response; call them with an API key.

Read publisher.id from a search listing and call /v1/imovelweb/publishers/{publisher_id}. phone_text keeps the text the agency publishes, and phone_numbers lists each number as +55, area code and number. Owners selling directly have no profile, so their id answers 404; the listing's whatsapp number is their contact.

Look the place up with /v1/imovelweb/locations and pass its id as location_id. Repeat location_id for up to 10 places; listings in any of them match. An id imovelweb does not know answers 400 and is not charged.

Each page holds 30 listings. Send pagination.next_cursor back as cursor. imovelweb stops at page 1,000, which is 30,000 listings, and pagination.completion then says depth_limit. Narrow the filters to reach the rest.

Yes. The tapline Python package, @tapline/client for TypeScript, and the tapline CLI include the imovelweb endpoints with typed responses. You can also call the REST API directly.

Search, listing details and broker profiles cost 2 credits. Map markers, similar listings, duplicate publishers and location lookups cost 1. A request imovelweb fails costs 0, an id it has no record of costs the usual price because imovelweb answered, and new accounts include 100 free credits.

No. Tapline is not affiliated with, endorsed by, or sponsored by imovelweb or QuintoAndar.

Get started

Try the data. Then ship the integration.

Use the keyless demo above. When you are ready, sign up for 100 free credits and call all 7 endpoints with one API key.