🏠 Angocasa Scraper

Want to pull property listings from Angocasa, Angola's leading real estate portal for buying, selling, renting, and short stays? This scraper makes it super easy!

Paste a search URL from your browser (after you apply filters on the site), set how many properties you want, and get structured records with price, typology, location, seller contacts, and more.

Listing values stay in Portuguese as Angocasa publishes them (e.g. Usado, Arrendar, Apartamento). Field names are in English for easier integration.

💡 Perfect for…

• Buyers & renters: Browse Angolan inventory by area, typology, and budget.
• Agencies & investors: Track competitor listings and build lead lists with phone / WhatsApp.
• Market research: Analyze supply across Luanda and other regions.
• 🤖 AI Agents: Power bots and workflows with live Angocasa inventory.
• 📚 RAG Systems: Feed descriptions and specs into retrieval pipelines.

✨ Why you'll love this scraper

• 🔗 Paste any search URL: Filter and sort on Angocasa in your browser, copy the address-bar URL into input_url, and the scraper follows pagination until your cap.
• 📊 Rich detail pages: Price, typology, business type, areas, features, seller block, and contacts.
• 📞 Phone & WhatsApp: Extracts contact numbers when shown on the listing.
• 🇵🇹 Portuguese values preserved: Labels and enums match what you see on the site.

📦 What's inside the data?

Field	Description
angocasa_id	Property ID (without leading #)
title	Property title
published_at	Publication date (ISO)
image_url	Main preview image
price / currency	Numeric price and currency (e.g. AKZ)
description	Full visible description
url	Detail page URL
property_state	e.g. Usado
typology	e.g. T1, T2, T3
business_type	e.g. Comprar, Arrendar, Estadia Curta
furnished	Boolean from Sim / Não
property_type	e.g. Apartamento, Vivenda, Terreno
minimum_nights	Short-stay nights when present
bathrooms / build_year	Specs when present
usable_area / land_area	Areas when present
exterior / interior / other_extras	Feature lists when present
country / region / locality	Location
seller_name / seller_registered / seller_location	Seller block
contact_phone / contact_whatsapp	Contact numbers

🚀 Quick start

1. Open Angocasa and apply filters until the results match what you want.
2. Copy the full URL from the address bar and paste it into input_url.
3. Set max_properties and click Start.

Export JSON, CSV, or Excel when done.

---

Tech details for developers 🧑‍💻

Input Example

{
  "input_url": "https://www.angocasa.com/anuncios/apartamento-t1/angola-luanda/listar-todos/mostrar-20/ordenar-mais-baratos/",
  "max_properties": 50
}

Output Example

{
  "angocasa_id": "0174004",
  "title": "APARTAMENTO T3 EM KILAMBA",
  "published_at": "2026-01-15T00:00:00",
  "image_url": "https://cdn.angocasa.com/images/content/a/p/apartamento-t3-big-o2hais76qe.jpg",
  "price": 25000.0,
  "currency": "AKZ",
  "description": "Apartamento de tipologia T2 para arrendamento de curta duração...",
  "url": "https://www.angocasa.com/apartamento/t3/luanda/kilamba/arrendar-apartamento-t2-no-kk5000-centralidade-do-kilamba/0174004/",
  "property_state": "Usado",
  "typology": "T3",
  "business_type": "Estadia Curta",
  "furnished": true,
  "property_type": "Apartamento",
  "minimum_nights": 7,
  "bathrooms": 2,
  "country": "Angola",
  "region": "Luanda",
  "locality": "Kilamba",
  "seller_name": "Agência Premium",
  "contact_phone": "946525295",
  "contact_whatsapp": "+244946525295"
}

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
input_url	string	Yes	Sample Luanda apartment search	Full Angocasa search/listing URL with filters already applied.
max_properties	integer	No	100	How many property detail pages to scrape (10–200).

Notes

• There is no separate filter form in the Actor — define the search on the website, then paste the URL.
• Short-stay fields such as minimum_nights are only filled when Angocasa shows them.
• Missing fields are returned as null so exports keep a stable shape.