🛒 OLX Portugal Scraper

Want to find deals on OLX.pt or analyze the Portuguese classifieds market? This scraper makes it super easy!

Just set your filters (category, subcategory, location, price, tipologia, condition, seller type) and the scraper will extract up to 1000 listings from any OLX Portugal category — imóveis, cars, tech, fashion, and more — neatly packing pricing, location, and seller details into a CSV or JSON file. No need to paste a search URL.

💡 Perfect for...

• Market Analysts: Track pricing trends, availability, and demand across Portugal.
• Resellers & Deal Hunters: Monitor new listings to find underpriced items before anyone else.
• Real Estate Pros: Filter imóveis by typology, location, price, and private vs business sellers.
• Auto & Electronics Buyers: Browse cars, phones, and tech with structured condition filters.
• 🤖 AI Agents: Power bots and OpenClaw workflows with real-time OLX.pt listings.
• 📚 RAG Systems: Feed listing specs and prices into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🎯 Structured Filters: Search by category, subcategory, location, query, price, tipologia, condition, and seller type — no URL crafting.
• 🏠 Imóveis Ready: Tipologia (T0–T6+) and location slugs work great for houses and apartments.
• 🔗 Optional URL Override: Prefer pasting a filtered OLX link? Use search_url (legacy input_url still works as an alias).
• ⚙️ Rich Listings: Price, location, seller signals, photos, and promotion flags from the GraphQL API.
• ⏱️ Sorting Options: Newest, recommended, cheapest, or most expensive — same labels as on olx.pt.
• 🇵🇹 Built for Portugal: Camoufox browser + cookie handling tuned for olx.pt.

📦 What's inside the data?

For every single listing, you will get:

• Core Details: id, title, url, created_time, last_refresh_time, description
• Media: img_url (first image) and photos (full list of high-res image links)
• Pricing: price, currency, negotiable
• Location: city, district, region
• Seller Details: business, contact_name, contact_phone, contact_chat, shop_subdomain
• Item Specifics: category, state (condition), and a clean params list
• Visibility: highlighted, top_ad, urgent, and other promotion flags

🛠️ Sort options

Use the sort_by parameter (Portuguese labels as on olx.pt):

• Mais recente – Newest listings first
• Anúncios recomendados – Recommended / featured ordering
• Mais barato – Cheapest first
• Mais caro – Most expensive first

🚀 Quick start

1. Open the Actor and pick a category (default: imoveis).
2. (Optional) Set subcategory, location (e.g. Lisboa), query, price range, tipologia, condition, or seller type.
3. (Optional) Or paste a full OLX results URL into search_url to override the filters.
4. Choose sort_by and max_items (up to 1000).
5. Click Start and let it run! 🛒 Export CSV, Excel, or JSON when done.

---

Tech details for developers 🧑‍💻

Input Example (structured filters):

{
  "category": "imoveis",
  "subcategory": "casas-moradias-para-arrendar-vender",
  "location": "Lisboa",
  "tipologia": "t2",
  "price_max": 350000,
  "seller_type": "private",
  "sort_by": "Mais recente",
  "max_items": 100
}

Input Example (URL override):

{
  "search_url": "https://www.olx.pt/imoveis/apartamento-casa-a-venda/lisboa/q-t2/?search%5Bfilter_float_price%3Ato%5D=350000&search%5Bprivate_business%5D=private",
  "sort_by": "Mais recente",
  "max_items": 200
}

Output Example:

{
  "id": 667517968,
  "title": "Nintendo Switch Desbloqueada",
  "url": "https://www.olx.pt/d/anuncio/nintendo-switch-desbloqueada-IDJaPUQ.html",
  "created_time": "2025-12-20T11:34:47+00:00",
  "last_refresh_time": "2026-04-22T18:08:00+01:00",
  "img_url": "https://ireland.apollo.olxcdn.com:443/v1/files/i1mpbl9lnr2r-PT/image;s={width}x{height}",
  "price": 225,
  "currency": "EUR",
  "description": "Consola Mario Edition Desbloqueada como nova…",
  "business": true,
  "status": "active",
  "city": "Alverca Do Ribatejo E Sobralinho",
  "district": null,
  "region": "Lisboa",
  "category": "electronics",
  "contact_name": "Nuno",
  "contact_phone": false,
  "contact_chat": true,
  "photos": [
    "https://ireland.apollo.olxcdn.com:443/v1/files/i1mpbl9lnr2r-PT/image;s={width}x{height}"
  ],
  "highlighted": true,
  "top_ad": true,
  "premium_ad_page": false,
  "urgent": false,
  "b2c_ad_page": false,
  "shop_subdomain": null,
  "negotiable": false,
  "state": "used",
  "params": [
    { "key": "state", "value_key": "used" },
    { "key": "type", "value_key": "switch" }
  ]
}

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
category	string enum	No	imoveis	Top-level path: imoveis, carros-motos-e-barcos, tecnologia-e-informatica, telemoveis-e-tablets, moda, moveis-casa-e-jardim, desporto-e-lazer, animais, bebes-criancas, emprego, servicos, lazer.
subcategory	string	No	—	Subcategory slug (e.g. apartamento-casa-a-venda, casas-moradias-para-arrendar-vender).
location	string	No	—	Location text; slugified with accents stripped (Lisboa → lisboa).
query	string	No	—	Free-text keywords → path segment /q-{slug}/.
price_min / price_max	integer	No	—	Price in euros (search[filter_float_price:from] / :to).
tipologia	string enum	No	"" (any)	t0…t6, t5-ou-mais, t6-ou-mais (search[filter_enum_tipologia][0]).
condition	string enum	No	"" (any)	new, used, used_good, used_medium, used_bad (search[filter_enum_state][0]).
seller_type	string enum	No	"" (any)	private or business (search[private_business]).
sort_by	string enum	No	Mais recente	See sort options above.
max_items	integer	No	500	How many listings to return (1–1000).
search_url	string	No	—	Optional advanced override. Paste a full olx.pt search URL; filters above are ignored.
input_url	string	No	—	Deprecated alias for search_url. If both are set, search_url wins.

Notes on filters

• With no filters and no URL, the Actor starts at https://www.olx.pt/imoveis/.
• Location and query are slugified (NFD, lowercase, hyphens) before building the path.
• Tipologia is mainly useful for Imóveis; other categories can still use price, condition, and seller type.
• Each run returns at most max_items listings (1–1000).
• Sort is applied in the browser after navigation (same UI labels as on the site).

🔧 Custom scrapers and agents

If you need a custom web scraper, or custom AI agents and workflows, contact me through tuik.ai. We help businesses cut costs and time by up to 10x.