CustoJusto.pt Portugal Classifieds Scraper

Extract listings from custojusto.pt at scale, in a clean, consistent structure ready for price monitoring, market research, catalogue analysis and resale tooling. No API key required.

---

Why this scraper?

🎯 Built for custojusto.pt

A dedicated Portuguese scraper tuned for custojusto.pt — its categories, price formats and currency (EUR), not a generic tool pointed at it.

💶 Structured pricing

Current price as a clean number in EUR, plus discounts and previous prices where the source shows them. Items without a published price return null, never a guess.

📄 Full item content

Complete description and title for every record, with a direct link back to the source.

---

Input parameters

Parameter	Type	Default	Description
minPrice	integer	(empty)	Minimum listing price (local currency). Leave empty for no minimum.
maxPrice	integer	(empty)	Maximum listing price (local currency). Leave empty for no maximum.
daysOld	integer	(empty)	Only return listings published within the last N days. Leave empty for no recency filter.
fetchDetails	boolean	false	If true, opens each listing detail page to extract additional fields (description, floor plan, agent contact). Increases run time and cost.
maxItems	integer	5	Max listings. Set to 0 for unlimited.
startUrls	array	(empty)	Optional list of search-results page URLs. When provided, all filter fields above are ignored.
keywords	string	"developer"	Search term in Portuguese. Leave empty for 25 default categories.

---

Output schema

Every field below is present on every record. Fields the source does not publish for a given item are returned as null rather than omitted.

Field	Type	Description
listingId	string	CustoJusto internal listing ID
title	string	Listing title
description	string	Full item description in plain text.
descriptionMarkdown	string	Description in Markdown/plain text.
url	string	Direct link to the listing
price	number	Price in EUR (numeric)
priceFormatted	string	Price formatted.
currency	string	Always EUR
type	string	Type.
category	string	Listing category
categoryId	string	Category id.
imageUrl	string	Image url.
imageCount	number	Image count.
hasVideo	boolean	Has video.
hasVtour	boolean	Has vtour.
district	string	Portuguese district
county	string	County.
parish	string	Parish.
companyAd	boolean	Company ad.
listTime	string	Date and time posted
searchKeyword	string	Search keyword.
scrapedAt	string	Timestamp when this record was scraped.
sourceCountry	string	Source country.

Example record

{
  "listingId": "36299879",
  "title": "Current and future developments in psychopharmacology - J. A. Den Boer",
  "description": "Categoria: Saúde - Livros , Saúde - Livros , Psiquiatria\nCurrent and future developments in psychopharmacology   J. A. Den Boer Edição em inglês 30/35A23 \n\n[(*** Importação em 30 Dec 2025 14:00...",
  "descriptionMarkdown": "Categoria: Saúde - Livros , Saúde - Livros , Psiquiatria\nCurrent and future developments in psychopharmacology   J. A. Den Boer Edição em inglês 30/35A23 \n\n[(*** Importação em 30 Dec 2025 14:00...",
  "url": "https://www.custojusto.pt/setubal/desporto-lazer/livros/current-and-future-development-36299879",
  "price": 33,
  "priceFormatted": "33 €",
  "currency": "EUR",
  "type": "sell",
  "category": "Livros",
  "categoryId": "6140",
  "imageUrl": "https://prod-images.custojusto.pt/gallery/5288927162-current-and-future-developments-in-psychopharmacology-j-a-den-boer.jpg",
  "imageCount": 1,
  "hasVideo": false,
  "hasVtour": false,
  "district": "Setúbal",
  "county": "Almada",
  "parish": "Costa da Caparica",
  "companyAd": true,
  "listTime": "2026-07-02T07:00:06Z",
  "searchKeyword": "developer",
  "scrapedAt": "2026-07-02T15:37:10.902Z",
  "sourceCountry": "pt"
}

---

Examples

Search for bicicleta:

{
  "keywords": "bicicleta",
  "maxItems": 100
}

Cap the price:

{
  "keywords": "bicicleta",
  "maxItems": 100,
  "maxPrice": 24.5
}

Scrape a specific search URL:

{
  "startUrls": [
    {
      "url": "https://www.custojusto.pt/apartamentos"
    }
  ],
  "maxItems": 200
}

Daily monitoring (run on a schedule):

{
  "keywords": "bicicleta",
  "daysOld": 1,
  "maxItems": 500
}

Schedule this input to run once a day in the Apify Scheduler — each run returns only items listed in the last 24 hours.

---

💰 Pricing

$1.48 per 1,000 results — you only pay for successfully retrieved listings. Failed retries are never charged.

Results	Cost
100	~$0.15
1,000	~$1.48
10,000	~$14.8
100,000	~$148

Flat-rate alternatives typically charge $29–$49/month regardless of usage.

Subscription tiers lower the rate further, down to $1.44 per 1,000 at the highest tier. Use the Max results cap in the input to control your spend exactly.

---

Performance

Run size	Typical time
100 results	under 1 minute
1,000 results	2–4 minutes
10,000 results	20–35 minutes

---

Known limitations

• Some fields (brand, condition, shipping) are only returned when the seller or source publishes them — expect null on a share of records.
• Prices and stock change constantly; records reflect the moment of scraping.
• Very large result sets are bounded by the source's own paging limits.
• Items can sell or be withdrawn at any time, so a small share of URLs may expire shortly after scraping.

---

Technical details

• Source: custojusto.pt
• Coverage: everything the public search exposes, filterable via the input parameters above
• Retry: automatic retry on network errors with exponential backoff

---

Need a custom scraper?

Unfenced Group builds Apify actors for any website — for free.

If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio.

Get in touch: www.unfencedgroup.nl