OLX Portugal Property Scraper

Discover public OLX Portugal property listings from buyer-facing inputs: location, operation, property type, and result limit. The Actor searches OLX for you, then returns structured listing rows with prices, area, price per square meter, rooms, main image, image gallery, features, description, and listing URLs.

This is a discovery Actor. You do not need to provide search result URLs.

Why Use This Actor

Use this Actor when you need a clean real estate dataset from OLX Portugal without manually building search URLs or copying listings from the website.

It is useful for:

• real estate lead discovery by city, region, or country
• monitoring private-owner and agency supply on OLX
• sale and rental inventory checks in Portuguese cities
• price and area comparison across public OLX listings
• TroveVault pipelines that combine several property portals into one dataset

What It Extracts

Each dataset row can include:

• platform, listingId, title, and url
• operation and propertyType
• price, currency, priceText, and pricePerM2
• areaM2, bedrooms, and bathrooms
• address, city, and country when visible
• description
• features, such as balcony, terrace, garage, parking, elevator, pool, garden, furnished, renovated, or sea view
• sellerName when visible
• mainImage and images
• scrapedAt
• runId when supplied in the input

Fields are only populated when they are publicly visible or can be safely inferred from listing text.

Input

{
  "location": "Lisbon, Portugal",
  "operation": "sale",
  "propertyType": "apartment",
  "maxItems": 3,
  "datasetId": "",
  "runId": ""
}

Input Fields

• location - City, region, or country to search. City or city plus country is recommended for stable results, for example Lisbon, Portugal, Porto, or Faro.
• operation - Dropdown. Use sale for properties for sale or rent for rental listings.
• propertyType - Dropdown. Use any, apartment, house, land, or commercial.
• maxItems - Maximum number of listings to save. Use a small number for quick checks and a larger number for broader discovery.
• datasetId - Optional Apify dataset ID. When provided, each saved listing is also appended to that dataset, which is useful when combining several discovery Actors.
• runId - Optional workflow run ID. When provided, it is copied into each output row and the RUN_SUMMARY key-value record.

Output Example

{
  "platform": "OLX Portugal",
  "listingId": "Jw1Ga",
  "title": "Apartamento T2 para venda em Oeiras",
  "url": "https://www.olx.pt/d/anuncio/apartamento-t2-para-a-venda-em-oeiras-IDJw1Ga.html",
  "operation": "sale",
  "propertyType": "apartment",
  "price": 340000,
  "currency": "EUR",
  "priceText": "340.000 €",
  "pricePerM2": 4595,
  "areaM2": 74,
  "bedrooms": 2,
  "country": "Portugal",
  "description": "Public listing description when visible.",
  "features": ["balcony", "garage"],
  "mainImage": "https://ireland.apollo.olxcdn.com/...",
  "images": ["https://ireland.apollo.olxcdn.com/..."],
  "scrapedAt": "2026-07-19T14:30:00.000Z",
  "runId": "parent-workflow-run"
}

API Usage

curl -X POST "https://api.apify.com/v2/acts/trovevault~olx-portugal-property-scraper/runs" \
  -H "Authorization: Bearer <APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"location":"Lisbon, Portugal","operation":"sale","propertyType":"apartment","maxItems":3}'

To append the same rows to an existing dataset and tag them with a workflow run:

curl -X POST "https://api.apify.com/v2/acts/trovevault~olx-portugal-property-scraper/runs" \
  -H "Authorization: Bearer <APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"location":"Lisbon, Portugal","operation":"sale","propertyType":"apartment","maxItems":50,"datasetId":"YOUR_DATASET_ID","runId":"YOUR_PARENT_RUN_ID"}'

Notes And Limitations

• Use English values for operation and propertyType; the Actor maps them internally to OLX Portugal routes.
• City-level searches are more stable than whole-country searches.
• OLX listings can mix private sellers, agencies, promoted listings, and nearby results.
• Some listings do not expose full address, area, bathrooms, or seller name publicly.
• The Actor does not bypass logins, paywalls, or private contact flows.

Troubleshooting

• Empty dataset: try a broader property type such as any, or use a Portuguese city with active OLX inventory.
• Sparse features: OLX listings vary in how much detail sellers write in the public description.
• Fewer rows than maxItems: the Actor filters out listings that do not expose enough public property data.

Related Actors

• Imovirtual Property Discovery Scraper
• CASA SAPO Property Discovery Scraper
• Other TroveVault real estate discovery Actors as they are added

Changelog

0.1

• Initial OLX Portugal discovery Actor with dropdown operation/property type, optional pipeline IDs, GitHub-backed schema readiness, and low-cost default test input.