OLX Portugal Scraper — Any Keyword

Unofficial. This Actor is not affiliated with, authorised by, endorsed by, or in any way officially connected to OLX. "OLX" is a trademark of its respective owner and is used here only to describe what this tool reads. It reads the same public pages a browser does.

OLX Portugal Scraper searches any category on OLX.pt - phones, electronics, vehicles, home, fashion - and returns priced listings in EUR with the full ad description, location, condition, structured attributes and promoted-placement status.

What data can you extract from OLX Portugal (olx.pt)?

Every search result OLX.pt itself returns for your keyword: title, description, price and whether it is negotiable, town and district, posting and refresh time, condition, the ad's structured attributes (model, capacity, carrier and so on, as OLX.pt keys them), first photo, whether the seller is a business, the seller's public name, id and member-since date, whether the seller published a phone number, and the approximate map position OLX.pt shows. The Actor reads the data OLX.pt embeds in its own search pages, so it needs no browser.

Why scrape OLX Portugal (olx.pt)?

• Every category, one Actor. Search any keyword across the whole site.
• No proxy needed. 25 of 25 sequential pages came back with no proxy at all, so runs carry no proxy cost.
• Condition filter is exact. new returned 47 of 47 Novo rows and used 43 of 43 Usado rows on the pages sampled.
• OLX.pt's fuzzy search is filtered. On the first page for "iphone 13", 9 of 52 results were other models or accessories without the term. requireKeywordMatch (on by default) drops those.
• Promoted placements are labelled, not hidden. isFeatured marks paid placements, and excludeFeatured drops them if you want organic results only.
• Zero-result searches return nothing. OLX.pt shows unrelated "similar" ads when nothing matches; the Actor reads the page's own result count and does not return them.

How to scrape OLX Portugal (olx.pt)

1. Put one or more search terms in searchQueries.
2. Optionally narrow with condition, a price range in EUR, or sortBy.
3. Run it. Results land in the dataset.

Input

Field	Type	Meaning
searchQueries	array	One search per term. Required.
condition	string	any | new | used.
minPrice / maxPrice	integer	Optional, in EUR. Left out of the request when empty, never sent as 0.
sortBy	string	relevance | priceAsc | priceDesc | newest. Paid promoted listings ignore the sort, so treat it as best-effort ordering.
excludeFeatured	boolean	Drops paid promoted placements. Off by default.
requireKeywordMatch	boolean	Drops items whose title is missing any word of the query. Default on.
maxItems	integer	Cap on rows across all terms. Default 1000.
maxPages	integer	Pages per term, clamped to OLX.pt's ceiling of 25.
proxyConfiguration	object	Off by default. Turn on only if you see request failures.

{
    "searchQueries": ["iphone 13"],
    "condition": "used",
    "maxPrice": 400,
    "maxItems": 200
}

Output

One row, from a real search on 2026-10-20 (description shortened):

{
    "id": "674535801",
    "title": "iPhone 13 Pro Max 256GB Azul Sierra – Aceito retomas",
    "description": "Descrição:\n\nVendo iPhone 13 Pro Max com 256GB, cor Azul Sierra, em óti ...",
    "url": "https://www.olx.pt/d/anuncio/iphone-13-pro-max-256gb-azul-sierra-aceito-retomas-IDJEhzH.html",
    "imageUrl": "https://ireland.apollo.olxcdn.com:443/v1/files/idc8xrp1kuw-PT/image;s=563x1000",
    "price": 370.0,
    "priceNegotiable": true,
    "currency": "EUR",
    "location": "Parque das Nações",
    "region": "Lisboa",
    "postedAt": "2026-10-16T12:59:55+01:00",
    "refreshedAt": "2026-10-19T13:03:09+01:00",
    "condition": "Usado",
    "attributes": {
        "state": "Usado",
        "model": "iPhone 13 Pro Max",
        "capacity": "256GB"
    },
    "isFeatured": true,
    "isBusiness": true,
    "sellerName": "Junior",
    "sellerId": "182082168",
    "sellerCompanyName": null,
    "sellerMemberSince": "2021-08-25T09:31:15+01:00",
    "sellerPhoneAvailable": false,
    "latitude": 38.77772,
    "longitude": -9.09526,
    "locationRadiusKm": 1,
    "matchedKeyword": "iphone 13"
}

Notes and limits

• 25 pages per search, up to about 1,000 ads. That is OLX.pt's own ceiling: page 26 redirects back to page 1. Narrow with condition or a price range to see more.
• Seller name, id and member-since date are returned; the phone number is not. OLX.pt shows phone numbers only to logged-in accounts, so the row carries sellerPhoneAvailable (whether the seller published one) and the ad url to reveal it.
• latitude/longitude are approximate: the centre of the area OLX.pt shows on the ad map, within locationRadiusKm, never an exact address.
• price and condition are null, never 0 or empty, when the ad states neither.
• A run that returns zero rows fails instead of succeeding with an empty dataset, so a misconfigured search cannot look like an empty market.
• Reads the same public pages a browser does. See the disclaimer at the top.

How much does it cost to scrape OLX Portugal (olx.pt)?

Pay-per-event: you pay per result written to the dataset, with no subscription. The current price is on the Actor's Pricing tab.

FAQ

Is a proxy required? No. 25 of 25 sequential pages came back with no proxy, so proxyConfiguration defaults to off.

How many listings can one search return? Up to 25 pages, about 1,000 ads, which is OLX.pt's own limit.

Does it cover other OLX countries? This Actor is OLX.pt only. OLX Romania has its own Actor, below.

More second-hand marketplace scrapers

Actor	What it scrapes
OLX Romania Scraper	OLX Romania (olx.ro) — any category, no proxy required
OLX Brazil Scraper	OLX Brazil (olx.com.br) — any category, structured attributes from the site's own detail chips
Wallapop Scraper	Wallapop, Spain — any keyword, phone mode with battery-health parsing
Vinted Spain Scraper	Vinted Spain (vinted.es) — any keyword or category, no proxy required
eBay Spain Scraper	eBay Spain (ebay.es) — active listings with seller type