🛒 OLX Portugal Scraper

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

Paste an input_url from your browser once you've already filtered on OLX.pt, or use structured filters (category, subcategory, location, price, tipologia, condition, seller type) — structured filters work better for AI agents. When input_url is set it overrides the filters. Either way, you get up to 1000 listings from any OLX Portugal category — imóveis, cars, tech, fashion, and more — with pricing, location, and seller details as CSV or JSON.

💡 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

• 🔗 Input URL or Filters: Paste an OLX.pt search URL (input_url) if you already filtered in the browser, or use structured filters (better for AI agents). input_url always wins when set.
• 🎯 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 filters work great for houses and apartments.
• ⚙️ Rich Listings: Price, location, seller signals, photos, and promotion flags.
• ⏱️ Sorting Options: Newest, recommended, cheapest, or most expensive — same labels as on olx.pt.
• 🇵🇹 Built for Portugal: Covers all major OLX.pt categories nationwide.

📦 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

Option A — Input URL

1. Open OLX.pt, apply filters in the browser, copy the results URL.
2. Paste it into input_url.
3. Set max_items and click Start.

Option B — Structured filters (better for AI agents)

1. Leave input_url empty.
2. Pick a category (default: imoveis), optional subcategory, location, query, price, tipologia, condition, or seller type.
3. Choose sort_by and max_items (up to 1000).
4. Click Start and 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):

{
  "input_url": "https://www.olx.pt/imoveis/apartamento-casa-a-venda/lisboa/",
  "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
input_url	string	No	—	Paste a full olx.pt search or category URL; overrides all filters below when set. Leave empty to use filters (better for AI agents).
category	string enum	No	imoveis	Top-level category: 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 (e.g. Lisboa, Porto).
query	string	No	—	Free-text keywords.
price_min / price_max	integer	No	—	Price range in euros.
tipologia	string enum	No	"" (any)	Property typology: t0…t6, t5-ou-mais, t6-ou-mais.
condition	string enum	No	"" (any)	Item condition: new, used, used_good, used_medium, used_bad.
seller_type	string enum	No	"" (any)	private or business.
sort_by	string enum	No	Mais recente	See sort options above.
max_items	integer	No	500	How many listings to return (1–1000).

Notes on filters

• input_url always wins over filters when provided.
• With no filters and no URL, the Actor starts in Imóveis.
• 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).