# Wallapop Scraper (`crawloop/wallapop-scraper`) Actor

Scrape Wallapop listings in Spain, Italy, Portugal, France, and the UK. Each row has the price, city, photo, and shipping flag from public search. Monitor mode saves only new listings and price changes.

- **URL**: https://apify.com/crawloop/wallapop-scraper.md
- **Developed by:** [Andrej Kiva](https://apify.com/crawloop) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.23 / 1,000 listings

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Wallapop Scraper

> **Disclaimer:** Unofficial tool — not affiliated with, sponsored by, or endorsed by Wallapop, S.L. or its affiliates. Data is read from publicly accessible search results only. No login. You are responsible for complying with applicable law (including GDPR where personal data appears) and the site’s terms. No warranty on accuracy or availability. Provided for informational and research use.

**Wallapop scraper** for second-hand listings in Spain, Italy, Portugal, France, and the UK. Each row is one search card: asking price, city, photo, shipping flag, and seller id. Search by keyword or paste a results URL. Use it as a **Wallapop API alternative** from **Python**, **Node.js**, **cURL**, or **Apify MCP**.

**Best for:** phone and furniture comps in one city, price-filtered leads, and a scheduled run that saves only new listings and price changes.

| Actor | Role |
| :--- | :--- |
| Wallapop Scraper ◄── you are here | Spain, Italy, Portugal, France, and UK classifieds |
| [Leboncoin Scraper](https://apify.com/crawloop/leboncoin-scraper) | France classifieds |
| [Kleinanzeigen Scraper](https://apify.com/crawloop/kleinanzeigen-scraper) | Germany classifieds |
| [Marktplaats Scraper](https://apify.com/crawloop/marktplaats-scraper) | Netherlands classifieds |
| [Gumtree Scraper](https://apify.com/crawloop/gumtree-scraper) | UK classifieds |
| [OfferUp Scraper](https://apify.com/crawloop/offerup-scraper) | US local classifieds |
| [Facebook Marketplace Scraper](https://apify.com/crawloop/facebook-marketplace-scraper) | Marketplace listings |
| [Carousell Scraper](https://apify.com/crawloop/carousell-scraper) | Singapore, Malaysia, Hong Kong, Philippines |
| [Vinted Monitor](https://apify.com/crawloop/vinted-monitor) | Fashion resale alerts |
| [Depop Monitor](https://apify.com/crawloop/depop-monitor) | Depop new listings |
| [eBay Sold Listings Scraper](https://apify.com/crawloop/ebay-sold-listings-scraper) | Sold comps for the same goods |

### When to use this Actor

- **A keyword in a country** — Set Keywords to iphone and Country to Spain. Leave Search URLs empty.
- **A city** — Set latitude and longitude. They override the country capital.
- **A price band** — Set a minimum or maximum in the market currency.
- **A results page you already opened** — Paste the search URL. Keywords and filters are ignored when Search URLs is set.
- **New ads and price cuts** — Turn on monitor mode and schedule the same search. The first run stores a baseline and saves nothing. Later runs save new listing ids and price changes.

### When not to use this Actor

- **A single listing page** — Item pages are not requested. The row is the search card.
- **Seller phone numbers** — The search card has a public seller id, not a phone number.
- **A full-country dump in one run** — Cap `maxItems` (200, five pages). Split by keyword or city.

### Key features

- **Search cards** — Title, price, currency, city, region, postal code, photo, shipping flag, category, and public seller id. Default **256 MB**. No browser.
- **Spain, Italy, Portugal, France, and the UK** — Country sets the capital and the listing host. Coordinates override that center.
- **Pasted search URL** — A results link. Listing URLs are skipped.
- **Monitor** — Named key-value store of listing id and last price for that search. The seed run saves nothing. Newest sort is the right default.

### Input

| Field | Required | Default | What it does |
| :--- | :--- | :--- | :--- |
| Search URLs | No | — | Wins over the filters below. |
| Keywords | No | iphone when the form is empty | One search per keyword when URLs are empty. |
| Country | No | Spain | Capital used when latitude and longitude are empty. |
| Latitude / longitude | No | — | Search center. Set both to override the capital. |
| Minimum / maximum price | No | — | Asking-price band in the market currency. |
| Category id | No | — | Optional category, such as cars. |
| Sort | No | Newest | Applied when the Actor builds the search. |
| Maximum listings | No | 40 | Cards to examine, up to 200. |
| Monitor mode | No | off | Baseline first, then new ids and price changes. |
| Monitor state store | No | wallapop-monitor | Named store for the baseline. Use a new name per watch. |
| Proxy | No | off | Turn on residential only if a run is blocked. |

```json
{
  "keywords": ["iphone"],
  "country": "ES",
  "orderBy": "newest",
  "maxItems": 40,
  "monitorMode": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

### Output

| Field | Meaning |
| :--- | :--- |
| `id` | Listing id |
| `url` | Public listing path |
| `title` | Listing title |
| `description` | Description on the search card |
| `price` | Asking price |
| `currency` | Currency code |
| `location` | City and region |
| `image` | Photo URL |
| `shippable` | True when the card marks the item as shippable |
| `reserved` | True when the card marks the item as reserved |
| `category` | Most specific category name |
| `sellerId` | Public seller id |
| `createdAt` | UTC time the listing was created |
| `changeType` | `new` or `price_change` on monitor runs |
| `previousPrice` | Prior asking price when `changeType` is `price_change` |
| `scrapedAt` | UTC timestamp |

```json
{
  "id": "exampleitem01",
  "url": "https://es.wallapop.com/item/iphone-example-1",
  "title": "iPhone 13 128GB",
  "description": "Unlocked, battery replaced.",
  "price": 400,
  "currency": "EUR",
  "city": "Madrid",
  "region": "Madrid",
  "postalCode": "28001",
  "countryCode": "ES",
  "location": "Madrid, Madrid",
  "image": "https://cdn.wallapop.com/images/example.jpg",
  "shippable": true,
  "reserved": false,
  "category": "Phones",
  "sellerId": "seller01",
  "createdAt": "2026-10-24T12:00:00Z",
  "scrapedAt": "2026-10-24T12:00:00Z"
}
```

### Use cases

- Compare asking prices for one phone model around Madrid and keep city, shipping, and photo.
- Pull sofas under a price cap in Rome and export the public seller id with each row.
- Schedule monitor mode each morning and export only listings whose price moved.
- For sold comps on the same goods, run [eBay Sold Listings Scraper](https://apify.com/crawloop/ebay-sold-listings-scraper). For France classifieds, run [Leboncoin Scraper](https://apify.com/crawloop/leboncoin-scraper).

### Integration examples

Replace `APIFY_TOKEN`. The slug below is the Store name.

#### Node.js

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor("crawloop/wallapop-scraper").call({
  keywords: ["iphone"],
  country: "ES",
  maxItems: 40,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Python

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("crawloop/wallapop-scraper").call(run_input={
    "keywords": ["sofa"],
    "country": "IT",
    "maxPrice": 200,
    "maxItems": 40,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(len(items))
```

#### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/crawloop~wallapop-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["iphone"],"country":"ES","maxItems":40}'
```

### MCP and AI assistants

Use this Actor from AI tools via [Apify MCP](https://docs.apify.com/platform/integrations/mcp).
Connect your Apify account, then call this Actor by its Store name `crawloop/wallapop-scraper`.

Example prompts:

- "Run Wallapop Scraper for iphone in Spain and return price, city, and shipping as JSON"
- "Scrape Wallapop sofas in Italy under 200 euros and list title, price, and city"
- "Run Wallapop Scraper in monitor mode for iphone in Spain, then use eBay Sold Listings Scraper for sold comps"

### Suite next step

This Actor covers Wallapop search cards. For sold prices on the same goods, run [eBay Sold Listings Scraper](https://apify.com/crawloop/ebay-sold-listings-scraper). For the next classifieds market, run [Leboncoin Scraper](https://apify.com/crawloop/leboncoin-scraper) in France, [Kleinanzeigen Scraper](https://apify.com/crawloop/kleinanzeigen-scraper) in Germany, or [Marktplaats Scraper](https://apify.com/crawloop/marktplaats-scraper) in the Netherlands.

### FAQ

**Does this open every listing page?**
No. Each row is the public search card. View counts and a seller profile page are not requested.

**Which countries are included?**
Spain, Italy, Portugal, France, and the United Kingdom. The country picks the capital and the listing host. Latitude and longitude override the capital.

**What if the run is blocked?**
Retry once with the proxy off. If the run still fails, turn on a residential proxy.

**What does monitor mode skip?**
Listing ids already stored for that same search, unless the asking price changed. A quiet tick writes zero rows. The first run only fills the baseline. Use a separate monitor state store name when you watch a second search.

**Are phone numbers included?**
No. The row has the public price, city, photo, and seller id from the search card.

# Actor input Schema

## `startUrls` (type: `array`):

Wallapop search URLs. When this list is set, keywords and filters below are ignored. Listing pages are not fetched.

## `keywords` (type: `array`):

Search text used when Search URLs is empty. One search per keyword. Example: iphone, sofa.

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

Market used when the search has no coordinates. Spain centers on Madrid, Italy on Rome, Portugal on Lisbon, France on Paris, and the UK on London.

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

Optional search center. Set together with longitude to override the country capital.

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

Optional search center. Set together with latitude.

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

Drop listings under this asking price, in the market currency. Leave empty for no minimum.

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

Drop listings over this asking price. Leave empty for no maximum.

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

Optional Wallapop category id, such as 100 for cars. Leave empty to search every category.

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

Sort used when the Actor builds the search. Pasted URLs keep their own sort. Newest is the right sort for monitor mode.

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

How many listings to examine, up to five pages. Monitor mode saves only new ids and price changes from this many cards.

## `monitorMode` (type: `boolean`):

The first run for a search stores a baseline and saves nothing. Later runs save new listings and price changes only.

## `monitorStateStore` (type: `string`):

Named key-value store that keeps the baseline between scheduled runs.

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

Off by default. Turn on a residential proxy only if a run is blocked.

## Actor input object example

```json
{
  "keywords": [
    "iphone"
  ],
  "country": "ES",
  "orderBy": "newest",
  "maxItems": 40,
  "monitorMode": false,
  "monitorStateStore": "wallapop-monitor",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

Default dataset items — one listing per row.

# 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 = {
    "keywords": [
        "iphone"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawloop/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 = { "keywords": ["iphone"] }

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

```

## MCP server setup

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