# Wallapop.es/pt/it Scraper (`nogards95/wallapop-scraper`) Actor

Scrape Wallapop listings in Spain, Italy & Portugal. Filter by keyword, price, city, or region — and get clean data in seconds.

- **URL**: https://apify.com/nogards95/wallapop-scraper.md
- **Developed by:** [Nogards](https://apify.com/nogards95) (community)
- **Categories:** E-commerce, Automation, Agents
- **Stats:** 8 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.80 / 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

### What does Wallapop Scraper do?

**Wallapop Scraper** extracts product listings from [Wallapop](https://wallapop.com), the largest secondhand marketplace in Spain, Italy, and Portugal. It queries Wallapop's internal JSON API directly — no browser, no Chromium — and returns structured listing data including prices, seller info, images, and location.

***

### Why scrape Wallapop?

Wallapop is the go-to platform for secondhand goods across Southern Europe, with millions of active listings. Scraping it at scale lets you:

- Track price trends for any product over time
- Spot underpriced items before other buyers
- Monitor competitor listings or category volumes
- Build price alert systems or deal-finding tools

**Why this Actor over alternatives?**

| Feature | This Actor | Browser-based alternatives |
|---|---|---|
| Memory usage | **256 MB** | ~2048 MB |
| Speed | Fast (direct API) | Slow (renders pages) |
| Cost | Up to **8× cheaper** | Expensive |
| Reliability | High — no UI to break | Breaks on UI changes |
| Countries | Spain, Italy, Portugal | Usually Spain only |

Because this Actor bypasses browser rendering entirely, it's significantly faster and more cost-efficient than generic scrapers.

***

### What data can Wallapop Scraper extract?

Each listing includes:

| Field | Type | Description |
|---|---|---|
| `id` | string | Wallapop listing ID |
| `title` | string | Listing title |
| `description` | string | Full description text |
| `price` | number | Asking price in EUR |
| `currency` | string | Currency code (always `EUR`) |
| `shippingAvailable` | boolean | Whether the item can be shipped |
| `isReserved` | boolean | `true` if already reserved for a buyer |
| `isRefurbished` | boolean | `true` if listed as refurbished |
| `hasWarranty` | boolean | `true` if warranty is included |
| `category` | string | Full category path (e.g. `Tecnología > Smartphones`) |
| `location` | string | City where the seller is located |
| `region` | string | Province or region within the country |
| `countryCode` | string | Country of the listing (`ES`, `IT`, `PT`) |
| `publishedAt` | string | ISO 8601 timestamp when the listing was published |
| `sellerUserId` | string | Seller's Wallapop user ID |
| `images` | array | CDN image URLs (medium resolution) |
| `link` | string | Direct URL to the listing on Wallapop |
| `scrapedAt` | string | ISO 8601 timestamp of when this data was collected |

***

### How to scrape Wallapop

1. **Open the Actor** from Apify Store and click **Try for free**
2. **Enter a search keyword** — e.g. `iphone 14`, `ps5`, `bicicleta`
3. **Set optional filters** — price range, condition, country, geo-radius
4. **Choose a sort order** — newest, price low to high, price high to low, or most relevant
5. **Set max items** — up to 2,000 results per run
6. **Click Run** — results appear in the dataset within seconds
7. **Export** in JSON, CSV, Excel, or XML from the dataset view

For scheduled monitoring (e.g., daily price tracking), use Apify's built-in **Schedule** feature to automate runs without writing code.

***

### How much does it cost to scrape Wallapop?

This Actor runs on **256 MB** of memory with no browser, making it one of the cheapest scraping options available on Apify.

- **Free plan**: includes a generous monthly compute unit quota — enough for several hundred runs
- **Paid plans**: scale to thousands of runs per month; cost grows linearly with volume

At 256 MB, a typical run of 100–500 items completes in under 30 seconds. This is 8× cheaper per run than browser-based scrapers at 2048 MB.

***

### Input

See the **Input** tab for the full configuration form. Key fields:

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `keyword` | string | ✅ | — | Search term |
| `country` | enum | ❌ | `ES` | `ES` (Spain) / `IT` (Italy) / `PT` (Portugal) |
| `maxItems` | integer | ❌ | `100` | Max listings to return (up to 2,000) |
| `orderBy` | enum | ❌ | `newest` | Sort order |
| `minPrice` | integer | ❌ | — | Minimum price filter (EUR) |
| `maxPrice` | integer | ❌ | — | Maximum price filter (EUR) |
| `condition` | enum | ❌ | — | `new` / `as_good_as_new` / `good` / `fair` / `has_given_it_all` |
| `shippingAvailable` | boolean | ❌ | `false` | Only shippable items |
| `latitude` | number | ❌ | — | Geo search latitude (e.g. `40.4168` for Madrid) |
| `longitude` | number | ❌ | — | Geo search longitude (e.g. `-3.7038` for Madrid) |
| `distanceKm` | integer | ❌ | — | Radius in km from coordinates |
| `categoryId` | integer | ❌ | — | Wallapop category ID (find IDs from the `category` field in output) |

**Example input:**

```json
{
  "keyword": "iphone 14",
  "maxItems": 200,
  "minPrice": 100,
  "maxPrice": 600,
  "orderBy": "price_low_to_high",
  "condition": "good",
  "shippingAvailable": true,
  "country": "ES"
}
```

> Note: `condition` is used as a search filter but is **not returned in the output** — Wallapop's API does not include it in search results.

***

### Output

You can download the dataset in various formats such as **JSON, CSV, Excel, or XML** directly from Apify Console.

Example output item:

```json
{
  "id": "vjre8pkeewzk",
  "title": "iPhone 14 Blanco",
  "description": "Smartphone Apple iPhone 14 color blanco...",
  "price": 380,
  "currency": "EUR",
  "shippingAvailable": true,
  "isReserved": false,
  "isRefurbished": false,
  "hasWarranty": false,
  "category": "Tecnología y electrónica > Telefonía: móviles y smartwatches > Smartphones",
  "location": "Molfetta",
  "region": "Puglia",
  "countryCode": "IT",
  "publishedAt": "2026-06-02T08:17:39.995Z",
  "sellerUserId": "xzo8orqdw269",
  "images": ["https://cdn.wallapop.com/..."],
  "link": "https://it.wallapop.com/item/iphone-14-bianco-1269392419",
  "scrapedAt": "2026-06-05T21:12:58.363Z"
}
```

***

### Tips and advanced options

#### Schedule daily price monitoring

The most powerful use case: run on a **daily schedule** to track price trends over time.

1. Open the Actor and click **Schedule**
2. Set a daily run at your preferred time
3. Results accumulate in your dataset automatically — use them to build price history charts or trigger alerts when prices drop

No code required.

#### Geo-restricted search

Use `latitude`, `longitude`, and `distanceKm` together to restrict results to a specific area. This is useful for picking up items close to your location:

```json
{
  "keyword": "mesa madera",
  "latitude": 41.3851,
  "longitude": 2.1734,
  "distanceKm": 20
}
```

#### Works from anywhere in the world

Wallapop's API requires EU infrastructure. Apify handles this automatically using residential proxies — you don't need to configure anything. Run from the US, Asia, or anywhere else and get full results.

***

### FAQ, Disclaimers, and Support

#### Is this legal to use?

This Actor only extracts publicly visible listing data that any user can see by visiting Wallapop. It does not bypass authentication, access private data, or violate rate limits aggressively.

> Our Actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our Actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

#### The Actor returned fewer results than expected

Wallapop's API may return fewer items than `maxItems` if there are fewer matching listings. This is normal — the Actor stops when there are no more pages to fetch.

#### I'm getting errors or empty results

Wallapop's internal API may change over time. If you see unexpected results or empty datasets, open an issue in the **Issues** tab and I'll investigate quickly.

#### Can I access results programmatically?

Yes — use the **API** tab to get the dataset URL or trigger runs via the Apify REST API. Results can also be pushed to external services via Apify integrations (Zapier, Make, webhooks).

***

Found a bug or need a feature? Open an issue in the **Issues** tab and I'll get back to you quickly.

# Actor input Schema

## `keyword` (type: `string`):

Keyword to search for on Wallapop.

## `country` (type: `string`):

Wallapop marketplace to search. Also determines the correct item links (es/it/pt.wallapop.com).

## `maxItems` (type: `integer`):

Maximum number of listings to return (default 100, max 2000).

## `orderBy` (type: `string`):

Sort order for results.

## `minPrice` (type: `integer`):

Minimum sale price in EUR.

## `maxPrice` (type: `integer`):

Maximum sale price in EUR.

## `condition` (type: `string`):

Filter listings by item condition. Note: condition is used as a search filter but is not returned in the output — Wallapop does not include it in search results.

## `shippingAvailable` (type: `boolean`):

Only return listings that can be shipped.

## `latitude` (type: `number`):

Latitude for geographic search. Use together with longitude and distanceKm. Example: 40.4168 (Madrid), 41.3851 (Barcelona).

## `longitude` (type: `number`):

Longitude for geographic search. Example: -3.7038 (Madrid), 2.1734 (Barcelona).

## `distanceKm` (type: `integer`):

Search radius in km from the given coordinates.

## `categoryId` (type: `integer`):

Wallapop category ID to restrict results to a specific category. The category path is returned in the output field 'category' so you can identify IDs from results.

## Actor input object example

```json
{
  "keyword": "iphone 14",
  "country": "ES",
  "maxItems": 100,
  "orderBy": "newest",
  "shippingAvailable": false
}
```

# Actor output Schema

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

Scraped listings with title, price, shipping, reservation status, category, location, seller ID, images and direct link.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("nogards95/wallapop-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("nogards95/wallapop-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 '{}' |
apify call nogards95/wallapop-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nogards95/wallapop-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/swUgbJTFGSu30oZj7/builds/hOEacIpx80qYc3oib/openapi.json