OLX Portugal Scraper

Scrape OLX Portugal (olx.pt), Portugal's largest classifieds site, in every category (phones and electronics, cars, property, jobs, services, animals and more): prices or salary bands, attributes, photos, location and business seller contacts.

What is OLX Portugal Scraper?

OLX Portugal Scraper is a data extraction tool that automatically collects listings (anúncios OLX, classificados) from OLX Portugal, Portugal's biggest marketplace for new and used goods, cars, homes, jobs and services. Simply provide starting URLs and get structured data including title, description, price or salary band, category attributes, photos, city, district, map location, seller type and listing dates.

This scraper handles pagination, searches larger than OLX Portugal's 1,000-result limit and data normalization automatically, delivering clean, structured datasets ready for analysis or integration into your systems.

What can this Actor do?

• Extract comprehensive listing data — title, description, price, currency, negotiable flag, old price and price drop, job salary bands, category attributes (model, year, mileage, area, typology, condition...), photos, city, district, map location, promotion flags, OLX delivery and listing dates
• Handle multiple entry points — search, category, district, island and city pages with any filter and sort, single ads, seller pages and seller shops
• Automatic pagination — crawls through every page of results, and splits searches with more than 1,000 results by district or island and price band, so you are not stuck at OLX Portugal's 1,000-result cap
• Business seller contacts (add-on) — the company profile a business seller published on OLX: trading name, address, office phones, website, logo and shop page
• Premium proxies included — high-quality Portuguese residential proxies built in at no additional cost
• Structured output — JSON, CSV, Excel formats available
• API integration — real-time data access through Apify API
• Scheduled runs — automated daily/weekly data collection

What data can OLX Portugal Scraper extract?

Field	Description	Example
id	OLX Portugal ad identifier	658874051
url	Ad URL	https://www.olx.pt/d/anuncio/...-IDIAzeP.html
title	Ad title (typed phone numbers and emails hidden)	iPhone 16 Pro Max 512GB | Garantia
description	Ad description as plain text (typed phone numbers and emails hidden)	* PRESTAÇÕES * ...
category_id / category_type	OLX Portugal category id and family	5407 / electronics
price / currency	Asking price (null on jobs, services priced on request and exchanges)	999 / EUR
price_label / price_type	Price as shown, and its kind (price, arranged, free, exchange, budget)	999 € / price
is_negotiable	Price marked negotiable ("Negociável")	false
old_price / price_drop_pct	Previous price and the drop in %	1099 / 9.1
salary_from / salary_to	Job ads: the salary band (1000€ - 1500€; mais de 2000€ has no upper end)	1000 / 1500
salary_period / salary_is_gross	Not published on olx.pt	null / null
photos	Full-size photo URLs	["https://ireland.apollo.olxcdn.com/..."]
city / region / neighborhood	City, district or island; olx.pt has no districts below the city	Benfica / Lisboa / null
latitude / longitude / location_radius_km	Map location as OLX Portugal publishes it, and the radius it is blurred to	38.749 / -9.198 / 0
seller_type	business or private	business
seller_id	OLX Portugal seller account id	13066569
seller_name / seller_url	Business trading name and OLX shop page	iSwitch - Sales, Repair & Care
is_promoted / is_highlighted / badges	Paid promotion flags, "urgent" badge	false / true / []
attributes	Category attributes by key	{"model": "iPhone 16 Pro Max"}
has_phone / has_delivery	Phone reveal offered, OLX delivery offered	true / false
partner / external_url	Source and link of a cross-posted ad (Standvirtual, Imovirtual, parts feeds)	standvirtual
listed_at / first_listed_at / bumped_at / expires_at	Listing dates, ISO 8601 UTC	2026-10-14T15:15:09Z
seller	Business seller's company profile (add-on)	see the add-on example

How to scrape OLX Portugal

Step-by-step tutorial:

1. Add starting URLs — Enter olx.pt search, ad, seller or shop URLs (see compatible formats below)
2. Configure options (optional) — set the maximum number of listings and turn on the business seller data add-on
3. Run the scraper — Click "Start" and monitor progress in real-time
4. Download results — Export data in JSON, CSV, or Excel format

Proxies are included automatically — no setup required.

Compatible URL examples:

• Search with filters and sort: https://www.olx.pt/telemoveis-e-tablets/telemoveis/lisboa/q-iphone/?search[filter_float_price:to]=500
• Keyword search in every category: https://www.olx.pt/ads/q-bicicleta/
• Category: https://www.olx.pt/carros-motos-e-barcos/carros/
• Category in a district: https://www.olx.pt/imoveis/apartamento-casa-a-venda/apartamentos-venda/lisboa/
• District, island or city: https://www.olx.pt/porto/, https://www.olx.pt/madeira-madeira/, https://www.olx.pt/cascais/q-sofa/
• Jobs: https://www.olx.pt/emprego/lisboa/
• Single ad: https://www.olx.pt/d/anuncio/iphone-11-256gb-IDJDZfC.html
• Seller page: https://www.olx.pt/ads/user/cljyx/
• Seller shop: https://universparts.olx.pt/home/

The /d/... links, paged links (?page=3) and the olx.pt and m.olx.pt hosts work too.

Important: Only URLs matching these patterns will work. Standvirtual (standvirtual.com) and Imovirtual (imovirtual.com) URLs belong to our Standvirtual and Imovirtual actors. Cars and homes those sites cross-post to olx.pt come back like any other olx.pt ad, with partner and external_url set.

How much does it cost to scrape OLX Portugal?

OLX Portugal Scraper uses pay-per-event pricing — you only pay for listings it returns.

Is scraping OLX Portugal free?

The scraper follows Apify's pay-per-event model with the following structure:

• Base extraction: one charge per listing returned ($2.99 per 1,000 on the free plan, $1.99 per 1,000 on GOLD and above), plus a tiny charge per Actor start
• Business seller data add-on: one additional charge per listing returned with the seller's company profile ($1.99 per 1,000 on the free plan, $0.99 per 1,000 on GOLD and above), only when the profile has a trading name, phone, address or website; private sellers are never charged for it

Pricing is optimized for efficiency, using minimal compute units while maintaining high success rates. Contact support for volume discounts on large-scale projects.

Input configuration

The scraper accepts the following inputs:

Start URLs

olx.pt URLs copied from your browser: search, category, district, island and city pages with any filter and sort, single ads, seller pages and seller shops (see the compatible formats above). Searches with more than 1,000 results are split automatically by district or island and price band.

Maximum items

The maximum number of listings to scrape across all URLs (each listing is a charged event). Leave it empty to scrape everything the URLs list.

Fetch business seller data (add-on)

Adds the company profile of business sellers in the seller field: trading name, business type, address, postal code, city, office phones, website, logo, profile and shop page, member-since date and the company description, as the company published them on OLX Portugal. Private sellers never return personal data. Charged only when the profile has a name, phone, address or website.

Output example

{
  "type": "listing",
  "id": 658874051,
  "url": "https://www.olx.pt/d/anuncio/iphone-16-pro-max-512gb-garantia-retoma-pague-em-3x-sem-juros-IDIAzeP.html",
  "title": "iPhone 16 Pro Max 512GB | Garantia | Retoma | Pague em 3x sem juros",
  "category_id": 5407,
  "category_type": "electronics",
  "seller_type": "business",
  "description": "* PRESTAÇÕES *\n\n- KLARNA - 100% ON-LINE\n\n> Opção de pagamento até 3x : processo 100% on-line;\n\n> Receba em apenas 24horas o seu equipamento;",
  "price": 999,
  "currency": "EUR",
  "price_label": "999 €",
  "price_type": "price",
  "is_negotiable": false,
  "old_price": null,
  "price_drop_pct": null,
  "salary_from": null,
  "salary_to": null,
  "salary_period": null,
  "salary_is_gross": null,
  "photos": [
    "https://ireland.apollo.olxcdn.com:443/v1/files/2dniobuoqfvq2-PT/image;s=1290x2293",
    "https://ireland.apollo.olxcdn.com:443/v1/files/lawd1mlfd5z7-PT/image;s=3024x4032"
  ],
  "city": "Benfica",
  "region": "Lisboa",
  "neighborhood": null,
  "latitude": 38.74981,
  "longitude": -9.1988,
  "location_radius_km": 0,
  "seller_id": "13066569",
  "seller_name": "iSwitch - Sales, Repair & Care",
  "seller_url": "https://iswitch.olx.pt/home/",
  "is_promoted": false,
  "is_highlighted": true,
  "badges": [],
  "attributes": {
    "state": "Novo",
    "model": "iPhone 16 Pro Max",
    "operador": "Desbloqueado",
    "capacity": "512GB"
  },
  "has_phone": true,
  "has_delivery": false,
  "partner": null,
  "external_url": null,
  "listed_at": "2026-10-14T15:15:09Z",
  "first_listed_at": "2024-11-07T14:56:02Z",
  "bumped_at": "2026-10-14T15:15:09Z",
  "expires_at": "2026-10-18T11:50:42Z",
  "seller": null
}

With the business seller data add-on, seller holds the company profile (phone faked here):

{
  "id": "136200876",
  "business_name": "Mobile View",
  "business_type": "premium",
  "address": "Estrada Principal 1033",
  "postal_code": "2400-014",
  "city": "Leiria",
  "phones": ["910 000 000"],
  "website": "http://www.mobileview.pt",
  "logo": "https://img-resizer.prd.01.eu-west-1.eu.olx.org/img-eu-olxpt-production/1039381542_1_94x72_rev007.jpg",
  "profile_url": "https://www.olx.pt/ads/user/9du4k/",
  "shop_url": "https://mobileview.olx.pt/home/",
  "member_since": "2020-07-15",
  "about": "Loja online com descontos exclusivos: telemóveis, tablets, informática..."
}

You can download the dataset extracted by OLX Portugal Scraper in various formats such as JSON, HTML, CSV, or Excel. The data is automatically cleaned and normalized for immediate use in analysis tools, databases, or business applications.

Use cases and applications

• Price monitoring — track asking prices, price drops and free or exchange offers for any product or category
• Market research — measure supply by category, city and district across Portugal, the Azores and Madeira included
• Lead generation — find business sellers and shops with their published company contacts
• Job market analysis — collect salary bands by role, city and contract type from OLX Portugal Emprego

Integrations and API access

OLX Portugal Scraper seamlessly integrates with popular platforms:

• Zapier — Automate data workflows and notifications (via Apify Zapier integration)
• Make (Integromat) — Create complex automation scenarios (via Apify Make integration)
• Google Sheets — Direct data export for analysis
• REST API — Programmatic access to extracted data (instructions here)
• Python/Node.js SDKs — Easy integration into applications (instructions here)

FAQ and Support

Do I need to configure a proxy?

No. The Actor includes high-quality Portuguese residential proxies automatically at no additional cost. There's nothing to configure.

Why are there no names or phone numbers for private sellers?

To respect the privacy of private individuals under the EU's GDPR (RGPD in Portugal), private sellers come back with their seller type and account id only: no name, no phone, no shop. When a private seller pins the exact address of a property on the map, its coordinates are left empty; locations OLX Portugal blurs to a circle are returned as published. Business sellers return their trading name, never the account holder's personal name. Phone numbers are never revealed: the business seller add-on returns only the office phones a company published in its OLX profile. Plates, VINs, tax numbers (NIF), animal microchip, breeder and pedigree numbers and holiday-let licence numbers are never returned. Descriptions are returned as OLX Portugal publishes them, except phone numbers and email addresses that sellers type into the title or description, or type to get past OLX Portugal's own masking (9 1 2 3 4 5 6 7 8, 912 e 345 e 678, a number spelled out in words, joana(arroba)gmail.com): they are replaced with [phone hidden] and [email hidden], for every seller type. Numbers OLX Portugal already masks (+35********78) come back as OLX Portugal shows them.

Can I scrape more than 1,000 results from one search?

Yes. OLX Portugal shows at most 1,000 results per search. When a search has more, the scraper splits it by district or island and then by price band, walks each slice, and drops the duplicates, so you get the whole search.

How often is the data updated?

OLX Portugal updates listings in real-time. For fresh data, schedule regular scraper runs or use our API for on-demand extraction.

What if some URLs don't work?

The scraper only supports specific URL patterns from olx.pt. Ensure your URLs match the compatible formats listed above. A URL OLX Portugal doesn't know, or a filter it rejects, is skipped, the run goes on with the other URLs, and the run's status message says what was skipped and why.

Do you offer custom solutions?

Absolutely! We can customize the scraper for specific requirements, additional data points, or integration with your existing systems. Contact us through the Issues tab for enterprise solutions.

Need help or have feedback?

• Report issues: Use the Issues tab for bug reports and feature requests
• Custom development: Contact us for tailored solutions and enterprise integrations