# CustoJusto.pt Scraper — Portugal Classified Ads & Prices (`logiover/custojusto-pt-marketplace-scraper`) Actor

Scrape CustoJusto.pt, Portugal's largest classifieds site, in bulk: title, description, price in EUR, district, county and parish, seller name, business-seller flag, photo count and post date as sortable columns. Category browse or keyword search. Keyless. JSON, CSV or Excel.

- **URL**: https://apify.com/logiover/custojusto-pt-marketplace-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## CustoJusto.pt Scraper — Portugal Classified Ads & Prices

Scrape **CustoJusto.pt**, Portugal's largest online marketplace, in bulk — **no login, no API key, no browser**. Point the Actor at any category or result page and it walks the pages, parses every card into flat, sortable columns, and saves rows as it goes.

> **22 columns per row** · thousands of rows per run · numeric prices, not strings · JSON, CSV, Excel or API · pay only for the rows you keep.

***

### Why this CustoJusto.pt scraper

CustoJusto.pt publishes everything a buyer needs on the result page — but as prose, inside a card, behind pagination. Reading it at any useful scale by hand is not realistic, and copy-paste gives you text where you need numbers.

This Actor turns those pages into a table. **`price` is a number**, not `"1.149,90 €"`. Location, seller and category are their own columns instead of one blob. That is the difference between data you can pivot on and data you have to clean first.

It is built on the same engine as the rest of this fleet, which means three things you only notice when they are missing:

- **It respects the clock.** Every run carries a time budget and saves rows continuously, so a slow page never costs you the whole run.
- **One bad page does not end the crawl.** An unreachable page is retried, then skipped and logged — not treated as the end of the listing.
- **It says what it did.** Row counts, skipped pages and stop reasons all appear in the log, so a short run is always explainable.

***

### What you get

#### Local lead generation in Portugal

`isBusinessSeller`, `sellerId` and `sellerName` let you separate professional advertisers from private sellers and group every ad by the same seller — the two things a raw ad dump never gives you.

#### Regional price and supply analysis

District, county and parish arrive as three separate columns, so you can compare Lisboa against Porto, or drill to a single freguesia, with a pivot table and no geocoding.

#### Marketplace and inventory research

`publishedAt` is a real ISO timestamp, so you can measure how fast a category turns over and when sellers post.

#### Dealer and competitor monitoring

Filter on `isBusinessSeller` to watch just the professional advertisers in your category, and track their price moves over time.

***

### Input

| Field | Type | What it does |
|---|---|---|
| `startUrl` | string | Any CustoJusto.pt category or result URL. The Actor paginates from here. |
| `searchQuery` | string | Optional keyword. When set, the site is searched for it and the category URL is ignored. |
| `maxResults` | integer | Stop after this many rows (default 200). |
| `proxyConfiguration` | object | Apify Proxy settings. The default is fine. |

#### Example input

```json
{
  "startUrl": "https://www.custojusto.pt/portugal/informatica",
  "searchQuery": "",
  "maxResults": 200,
  "proxyConfiguration": { "useApifyProxy": true }
}
```

***

### Output

One row per listing, 22 columns:

| Column | Type | Description |
|---|---|---|
| `listingId` | string | CustoJusto listing id. |
| `title` | string | Listing headline. |
| `listingUrl` | string | Canonical link to the ad. |
| `price` | number | Asking price. Null when the ad carries no figure — that is "price on request", not zero. |
| `currency` | string | Always EUR. |
| `listingType` | string | sell, buy, rent, and so on. |
| `description` | string | Ad body text as shown on the results page. |
| `category` | string | Category name. |
| `categoryId` | string | Numeric CustoJusto category id. |
| `district` | string | Portuguese district (distrito). |
| `county` | string | Municipality (concelho). |
| `parish` | string | Civil parish (freguesia). |
| `sellerName` | string | Display name of the advertiser. |
| `sellerId` | string | Stable advertiser id — lets you group every ad by one seller. |
| `isBusinessSeller` | boolean | True for professional advertisers. |
| `imageCount` | number | How many photos the ad carries. |
| `imageUrl` | string | First photo. |
| `hasVideo` | boolean | True when the ad includes a video. |
| `publishedAt` | string | ISO timestamp the ad went live. |
| `country` | string | Always Portugal. |
| `source` | string | Always custojusto\_pt. |
| `scrapedAt` | string | ISO timestamp of collection. |

#### Example row

```json
{
  "listingId": "…",
  "title": "…",
  "listingUrl": "…",
  "price": 0,
  "currency": "…",
  "listingType": "…",
  "description": "…",
  "category": "…",
  "categoryId": "…",
  "district": "…",
  "county": "…",
  "parish": "…",
  "sellerName": "…",
  "sellerId": "…",
  "isBusinessSeller": false,
  "imageCount": 0,
  "imageUrl": "…",
  "hasVideo": false,
  "publishedAt": "…",
  "country": "…",
  "source": "…",
  "scrapedAt": "…"
}
```

Export from the Apify Console as **JSON, CSV, Excel, XML or RSS**, or pull it straight from the [Dataset API](https://docs.apify.com/api/v2#/reference/datasets/item-collection/get-items).

***

### How to use it

1. Open the Actor and paste a CustoJusto.pt category URL into **Category or listing URL**.
2. Set **Maximum results** to how many rows you want.
3. Click **Start**. Rows appear in the dataset while the run is still going.
4. Export, or schedule the run daily and diff the results to track price moves.

You can also run it from the [Apify API](https://docs.apify.com/api/v2), the [JavaScript client](https://docs.apify.com/api/client/js/) or the [Python client](https://docs.apify.com/api/client/python/), and wire the output into Google Sheets, Zapier, Make or your own warehouse.

***

### Frequently asked questions

**Do I need an account or API key?**

No login and no key — only an Apify account.

**What does a null `price` mean?**

The advertiser did not publish a figure. That is "price on request", not zero, so the column is left empty rather than being flattened to 0.

**Can I get only professional sellers?**

Yes. Filter the output on `isBusinessSeller` = true.

**How precise is the location?**

Three levels: `district` (distrito), `county` (concelho) and `parish` (freguesia), each as its own column.

**Can I scrape a keyword search?**

Yes. Fill in **Search keyword**; the category URL is then ignored.

**How much does it cost?**

You pay per row kept, plus Apify platform usage. A 1,000-row run is inexpensive; run it on a schedule and you have a continuous price feed for the cost of a coffee.

**Is scraping CustoJusto.pt legal?**

This Actor reads only publicly available pages — the same ones anyone can open in a browser — and collects no personal data beyond the seller display name that CustoJusto.pt itself publishes next to each listing. You are responsible for how you use the output, including compliance with CustoJusto.pt's terms and with data-protection law such as the GDPR. If in doubt, take legal advice.

***

### Related Actors

Browse the rest of the fleet for country marketplace, classifieds, property and company-registry scrapers covering more than eighty countries.

***

### Support

Found a broken column or a site change? Open an issue on the Actor's **Issues** tab and it will be looked at. This Actor is actively maintained — see the Changelog for its history.

***

*CustoJusto.pt is a trademark of its respective owner. This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by CustoJusto.pt.*

# Actor input Schema

## `startUrl` (type: `string`):

Any CustoJusto.pt category or result URL. The Actor walks its pages from here. Example: https://www.custojusto.pt/portugal/informatica

## `searchQuery` (type: `string`):

Optional. When set, CustoJusto.pt is searched for this keyword and the category URL above is ignored.

## `maxResults` (type: `integer`):

Stop after this many rows. The Actor walks pages until the target is met, the listing runs out, or the run's time budget is spent.

## `proxyConfiguration` (type: `object`):

CustoJusto.pt serves plain HTML; the default Apify Proxy is enough.

## Actor input object example

```json
{
  "startUrl": "https://www.custojusto.pt/portugal/informatica",
  "searchQuery": "",
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with one row per CustoJusto.pt listing.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrl": "https://www.custojusto.pt/portugal/informatica",
    "searchQuery": "",
    "maxResults": 200,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("logiover/custojusto-pt-marketplace-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrl": "https://www.custojusto.pt/portugal/informatica",
    "searchQuery": "",
    "maxResults": 200,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("logiover/custojusto-pt-marketplace-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrl": "https://www.custojusto.pt/portugal/informatica",
  "searchQuery": "",
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call logiover/custojusto-pt-marketplace-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,logiover/custojusto-pt-marketplace-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/9C9racSnJ3OLk6BwW/builds/iteHftrbENPpxaG9p/openapi.json