🛒 OLX Portugal Scraper

Are you building a market analysis tool, tracking second-hand prices, or sourcing specific items? OLX Portugal is the country's leading classifieds platform, connecting buyers and sellers across dozens of categories—from electronics and cars to real estate and furniture.

This OLX Portugal Scraper allows you to extract rich, structured data directly from the OLX search API. You can instantly scrape and export up to 2000 listings as clean, structured data. It is built for general classifieds (electronics, cars, furniture, etc.) and works just as well for real estate (imóveis)—houses, apartments, and land—when you use an olx.pt property search or category URL.

💡 Perfect for...

• Market Analysts: Track pricing trends, availability, and demand for specific product categories across Portugal.
• Resellers & Deal Hunters: Monitor new listings in real-time to find underpriced items or rare collectibles before anyone else.
• Real Estate & Auto Professionals: Monitor imóveis listings (sale and rent) alongside vehicles—prices, locations, map coordinates, and seller signals export the same way as other categories.
• E-commerce Competitor Analysis: Keep an eye on business sellers, pricing strategies, and promoted listings.

✨ Features

• 🔓 Full Search Power: Scrape any OLX.pt search or category URL—including Imóveis—keeping all the filters (price range, typology, location, etc.) you applied in your browser.
• 🔍 Smart Sorting: Mirror the on-page sort options (same labels as on olx.pt): Mais recente (newest first), Anúncios recomendados (recommended / featured ordering), Mais barato (cheapest first), Mais caro (most expensive first).
• ⚡ Fast & Structured: Get up to 2000 rich listing profiles per run, including prices, locations, seller types, and high-resolution images.

📦 What's inside the data?

For every listing scraped, you get:

• Core Info: 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 (boolean), contact_name, contact_phone, contact_chat, shop_subdomain
• Item Specifics: category, state (condition), and a clean params list with all custom attributes (e.g., brand, model, size)
• Visibility: highlighted, top_ad, urgent, and other promotion flags

🚀 How to use

1. Get your Search URL: Go to OLX Portugal, search for an item or browse a category, apply any filters (condition, price, location), and copy the URL from your browser.
2. Enter the URL: Paste it into the input_url field.
3. Choose Sorting (Optional): Pick one of the Portuguese options above—for example Mais recente if you want the newest listings first.
4. Set Limit: Choose how many listings to collect (you can scrape up to 2000).
5. Click Start and let the scraper pull the data.
6. Export your structured list as a CSV, Excel spreadsheet, or JSON file.

---

Tech details for developers 🧑‍💻

Input Example:

{
  "input_url": "https://www.olx.pt/tecnologia-e-informatica/",
  "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, sem riscos com todos os acessorios, com  cartao sd de 128gb.<br />\n<br />\nExcelente oportunidade para colecionadores ou quem aprecie uma consola diferente do habitual.<br />\n<br />\nDual boot, entre o original e desbloqueado.",
  "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}",
    "https://ireland.apollo.olxcdn.com:443/v1/files/lgvas6arqszv1-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"
    }
  ]
}

Parameters:

Parameter	Type	Required	Description
input_url	string	Yes	The URL of the OLX.pt search page to scrape (including any applied filters).
sort_by	string	No	Sort order; value must match the site exactly. Mais recente = newest first; Anúncios recomendados = recommended; Mais barato = cheapest first; Mais caro = most expensive first.
max_items	integer	No	Maximum number of listings to return (Max 2000).