# Wallapop Scraper - Listings, Sellers, Reviews & Price Alerts (`topapi/wallapop-scraper`) Actor

Scrape Wallapop listings in Spain, Italy and Portugal: price, condition, brand, model, car specs, photos, location and views, plus seller profiles, business contacts and reviews. Search terms, URLs, categories or sellers, all filters, monitor mode with price drops. $0.22 per 1,000 detailed listings.

- **URL**: https://apify.com/topapi/wallapop-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.18 / 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.

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

### What does Wallapop Scraper do?

**Wallapop Scraper** turns Wallapop searches into a dataset: one row per second-hand listing in Spain, Italy and Portugal (France and the UK too, where Wallapop has listings), with the price, condition, brand, model, car specs, photos, location, views and favourites, and the seller. Add the seller's public profile and their reviews, or watch a search on a schedule and get only new listings and price drops.

- **Every way in:** search terms, Wallapop search URLs (all their filters kept), category pages, listing URLs, item ids, and whole seller shops.
- **Every Wallapop filter:** price, distance, posted within, condition, seller type, shippable only, and the car, motorbike and real-estate filters (brand, model, year, km, power, fuel, gearbox, body, rent or buy, property type).
- **Item details on by default:** condition, brand, model and every attribute, views, favourites and chats, all photos, the seller's name and type, and a professional seller's business details (legal name, email, phone, registration number).
- **Seller profiles and reviews:** rating, review count, sales, active listings, response rate, verifications, shop address, website and hours; review rows with rating, comment, item and reviewer.
- **Monitor mode:** only new listings and price drops on each scheduled run, with a price history, plus alerts to Telegram, Discord, Slack, WhatsApp or any webhook.
- **Deal analysis:** the median price of your search and how far each listing is under it.
- **No login, no cookies, no API key.** Export as JSON, CSV or Excel, or read it through the Apify API and MCP.

### What data can you get from Wallapop?

| | | |
|---|---|---|
| 🏷️ Title, description | 💶 Price, financed price | ⭐ Condition (`condition`, `condition_text`) |
| 🏭 Brand, model, version | 🚗 Year, km, fuel, gearbox, power | 🚪 Doors, seats, body type, eco label |
| 🏠 Rent or sale, property type, m², rooms | 👕 Size, colour, storage | 📚 Author, publisher, ISBN |
| 🗂️ Category path | 🖼️ Every photo (`images`) | 📍 City, postal code, province, region |
| 🧭 Coordinates, `distance_km` | 📅 Published, edited, age in hours | 👀 Views, favourites, chats |
| 🔒 Reserved, shippable, refurbished, warranty | 👤 Seller name, type, profile link | 🏢 Legal name, email, phone, registration |
| ⭐ Seller rating, reviews, sales | ⏱️ Response rate, verifications | 🏪 Shop address, website, hours |
| 💬 Reviews: rating, comment, item | 📉 Change type, previous price | 📈 Price history, first seen |

### How to scrape Wallapop with Wallapop Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) (you get $5 of free credit every month).
2. Open **Wallapop Scraper** and type a search term, e.g. `iphone 13`, or paste a Wallapop search URL.
3. Pick the country, a location and the filters you want.
4. Click **Start**.
5. Download the rows as JSON, CSV or Excel, or connect them to Google Sheets, Make, Zapier or your own code.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| `searchQueries` | list | Search terms, one per line. Each is one search. |
| `startUrls` | list | Wallapop URLs: a search page (its filters are kept), a category page, a listing (`/item/...`), a seller (`/user/...`). |
| `itemIds` | list | Item ids (`item_id` in the output) or listing URLs, read with full details. |
| `sellerIds` | list | Seller ids (`seller_id`) or profile URLs. |
| `sellerOutput` | list | For those sellers: `listings`, `profile`, `reviews`. Default `listings`. |
| `market` | select | ES (default), IT, PT, FR, UK. `countries` searches several at once. |
| `locations`, `latitude` / `longitude`, `postalCode` | | Search centre: city names ("Barcelona", "Milano"), coordinates, or a Spanish postal code. Default: the capital. |
| `distanceKm` | integer | Only listings within this many km. |
| `category`, `subcategoryIds` | | Search inside a category, or browse it with no search term. |
| `sortBy` | select | Most relevant (Wallapop's default), newest, closest, price low or high. |
| `postedWithin` | select | Any time, 24 hours, 7 days, 30 days. |
| `minPrice` / `maxPrice`, `conditions`, `sellerType`, `onlyShippable` | | Wallapop's own filters. |
| `carBrand`, `carModel`, `minYear`, `maxYear`, `minKm`, `maxKm`, `minHorsePower`, `maxHorsePower`, `minSeats`, `maxSeats`, `minDoors`, `maxDoors`, `carFuel`, `carGearbox`, `carBodyType`, `carColor`, `carHasWarranty` | | Cars filters. |
| `motorbikeStyle`, `realEstateOperation`, `realEstateType`, `extraSearchParams` | | Motorbike and real-estate filters; any other Wallapop search parameter. |
| `requireKeywordMatch`, `excludeKeywords`, `excludeAccessoriesAndBroken`, `skipReserved`, `publishedAfter`, `maxAgeDays` | | Checked by the actor on each listing before it is delivered. |
| `dealAnalysis`, `minBelowMarketPercent` | | The search's median price and % under it; keep only deals. |
| `includeDetails` | boolean | Item details. Default **on**. |
| `includeSellerProfile` | boolean | The seller's public profile on every listing. |
| `includeSellerReviews`, `maxReviewsPerSeller`, `reviewType` | | Reviews of the sellers found (default 100 per seller). |
| `monitorMode`, `monitorStoreName`, `monitorMaxPages`, `minPriceDropPercent`, `skipFirstRun`, `emitPriceIncreases`, `emitUnchanged`, `emitExpired`, `skipReposts`, `resetMonitor` | | Monitor mode. |
| `telegramBotToken` + `telegramChatId`, `discordWebhookUrl`, `slackWebhookUrl`, `whatsappAccessToken` + `whatsappPhoneNumberId` + `whatsappTo`, `webhookUrl` + `webhookHeaders`, `notificationLimit`, `notifyOnlyChanges` | | Alerts. |
| `maxResults` | integer | Most listings for the run (default 100; 0 = no limit). |
| `maxResultsPerSearch`, `maxPagesPerSearch`, `maxResultsPerSeller` | integer | Limits per search, per page count, per seller. |
| `compact`, `excludeEmptyFields`, `descriptionMaxLength`, `descriptionFormat`, `imageSize`, `maxImages`, `stripSellerPII`, `language` | | Row shape. |
| `proxyConfiguration`, `maxConcurrency`, `maxRequestRetries` | | Advanced. |

Field names from the popular Wallapop actors are accepted too (`start_urls`, `max_items`, `country: "Spain"`, `query`, `location`, `radiusKm`, `fetchDetails`, `orderBy`, `watchSellerIds`, `incrementalMode`, `stateKey`...), so their inputs run as they are.

#### Input JSON

```json
{
  "searchQueries": ["iphone 13", "ps5"],
  "market": "ES",
  "locations": ["Barcelona"],
  "distanceKm": 30,
  "sortBy": "newest",
  "maxPrice": 400,
  "excludeAccessoriesAndBroken": true,
  "maxResults": 200
}
```

#### Paste the search you already built on Wallapop

Set every filter on es.wallapop.com, copy the address and put it in `startUrls`. Price, distance, category, brand, condition and every other parameter in that address are used as they are. When the address has no coordinates, the search is centred on the market's capital.

#### Use Cars filters inside the Cars category

The car filters only work with `category: "cars"`. Wallapop applies seller type itself only in Cars; in other categories this actor checks each seller's profile and drops the other type.

### ⬆️ Output

A real row from a run (BMW Serie 3 search, details on, trimmed):

```json
{
  "record_type": "listing",
  "item_id": "3zlmwmepgpjx",
  "title": "BMW Serie 3 318d Auto.Touring",
  "price": 23199,
  "currency": "EUR",
  "brand": "BMW", "model": "Serie 3", "version": "318d Auto.Touring",
  "year": 2022, "km": 77097, "engine": "Híbrido", "gear_box": "Automático",
  "horse_power": 150, "body_type": "Familiar", "eco_label": "ECO",
  "listing_url": "https://es.wallapop.com/item/bmw-serie-3-318d-auto-touring-2022-1276018045",
  "image_count": 39,
  "city": "Soto de La Moraleja", "province": "Madrid", "country_code": "ES", "distance_km": 12.63,
  "created_at": "2026-06-26T12:29:25.711Z",
  "views": 257, "favorites": 9,
  "seller_id": "wzynl4e272j5", "seller_name": "ICMOTOR C.", "seller_type": "professional",
  "seller_business_type": "Shop", "seller_phone": "910922013",
  "detail_fetched": true
}
```

A review row:

```json
{
  "record_type": "review",
  "review_id": "ceb83790-b3a5-3e92-85ee-e91771457c2f",
  "seller_id": "3zlgm2qq34jx", "seller_name": "Rafael A.",
  "date": "2025-12-28T16:21:55.000Z", "rating": 5,
  "comment": "Todo bien, una persona muy amable y cordial.",
  "reviewed_as": "buyer", "reviewer_name": "Sergio H."
}
```

#### Fields

Fill measured on real runs (2026-11-06): 1,500 newest "iphone" listings, 3,000 of the 10,489 BMW Serie 3 car listings, 80 listings with seller profiles and 452 reviews. Wallapop only shows what the seller entered, so the fill differs by category.

| Field | Fill | Note |
|---|---|---|
| `item_id`, `title`, `description`, `price`, `currency`, `listing_url`, `images`, `city`, `postal_code`, `province`, `region`, `latitude`, `longitude`, `created_at`, `reserved`, `shipping_available`, `seller_id` | 100% | every listing |
| `condition`, `condition_text` | 99% | consumer goods; not Cars or Real estate |
| `brand` / `model` / `color` / `storage_capacity` | 98 / 66 / 71 / 66% | iPhone listings |
| `brand`, `model`, `year` / `km` / `engine`, `gear_box` / `horse_power` / `body_type` / `doors` / `seats` / `eco_label` | 100 / 89 / 98 / 97 / 96 / 97 / 98 / 69% | car listings |
| `financed_price` | 17% | dealers that show financing |
| `views`, `favorites`, `conversations`, `characteristics` | 100% | with details |
| `seller_name`, `seller_type`, `seller_url` | 100% | with details |
| `seller_legal_name`, `seller_email`, `seller_registration_number` | 14-16% | professional sellers only (23% of car sellers) |
| `seller_phone` | 15% (22% cars) | professional sellers that publish one |
| `seller_rating_average`, `seller_review_count`, `seller_sold_count`, `seller_active_listings`, `seller_score`, `seller_registered_at`, `seller_city` | 100% | with the seller profile |
| `seller_response_rate` / `seller_avatar_url` | 76 / 86% | with the seller profile |
| `shop_phone`, `shop_address`, `shop_website`, `shop_opening_hours` | shops only (2% of iPhone sellers) | with the seller profile |
| `search_median_price`, `below_market_percent` | 100% | with deal analysis |
| review `rating`, `date`, `reviewer_name` / `comment` / `item_title` | 100 / 66 / 58% | Wallapop leaves the item off some purchase reviews |

Hashtags and the refurbished "new price" are not delivered: Wallapop returned no hashtags and no new price on any of the 3,687 listings read.

### How can I use Wallapop data?

- 🚗 **Car dealers:** price your stock against every private and dealer listing of the same model, with km, year and fuel.
- 🔁 **Resellers:** a monitor on "ps5 under 300" every 15 minutes, with the deals sent to Telegram.
- 📊 **Market research:** median prices per city, category and condition across Spain, Italy and Portugal.
- 🏢 **Lead generation:** professional sellers' legal names, emails and phones from the cars, real-estate and tech categories.
- 🏠 **Real estate:** rental listings with m², rooms and price, ranked by how far under the search median they are.
- ⭐ **Trust checks:** a seller's rating, sales and reviews before you buy or partner.

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

| Event | Price | Per 1,000 |
|---|---|---|
| `listing` | $0.00018 | **$0.18** |
| `listing-details` (item details, on by default) | $0.00004 | **$0.04** |
| `seller-profile` (on a listing row or a seller row) | $0.00027 | **$0.27** |
| `review` | $0.0009 | **$0.90** |

| Run | Rows | Charge |
|---|---|---|
| The prefill: 50 newest "iphone" listings with details | 50 | $0.011 |
| 1,000 listings with details (the default) | 1,000 | $0.22 |
| 1,000 listings without details | 1,000 | $0.18 |
| 1,000 listings with details and seller profiles | 1,000 | $0.49 |
| 100 seller reviews | 100 | $0.09 |

No start fee and no monthly rent; Apify platform usage is included. You are charged only for rows written to the dataset, and an add-on only on the rows it filled: a listing whose details could not be read is charged as a plain listing. In monitor mode unchanged listings are not written, so they are not charged. Set a **maximum charge** on the run and it stops cleanly at it.

### Integrations, API, scheduling & MCP

Run Wallapop Scraper from the [Apify API](https://apify.com/topapi/wallapop-scraper/api/python) (Python, JavaScript or plain HTTP), send its rows to Google Sheets, Slack, Make, Zapier or n8n through Apify integrations and webhooks, or call it from an AI agent through the [Apify MCP server](https://apify.com/topapi/wallapop-scraper/api/mcp).

#### Run it on a schedule

1. Save your input as a task, with `monitorMode: true` and a `monitorStoreName` such as `ps5-madrid`.
2. In **Schedules**, run the task every 15 minutes, hourly or daily.
3. Each run delivers only listings that are new or cheaper since the last one (`change_type` NEW or PRICE_DROP, with `previous_price` and `price_history`). A listing delivered before without details comes back once as `DETAILS` when a later run turns on item details or seller profiles (charged like any listing with them). A run with nothing new delivers no rows and is not charged.

```json
{
  "searchQueries": ["ps5"],
  "locations": ["Madrid"],
  "distanceKm": 20,
  "maxPrice": 300,
  "monitorMode": true,
  "monitorStoreName": "ps5-madrid",
  "telegramBotToken": "<your bot token>",
  "telegramChatId": "<your chat id>"
}
```

### More marketplace scrapers

- [Vinted Scraper](https://apify.com/topapi/vinted-scraper): listings, prices, sellers and reviews on 26 Vinted sites.
- [Facebook Marketplace Scraper](https://apify.com/topapi/facebook-marketplace-scraper): listings, prices and price drops.
- [Kleinanzeigen Scraper](https://apify.com/topapi/kleinanzeigen-scraper): German listings, real estate, cars and sellers.
- [eBay Listings Scraper](https://apify.com/topapi/ebay-listings-scraper): prices, bids, sellers and item specifics.
- [Mercari Scraper](https://apify.com/topapi/mercari-scraper): Japan and US listings, sold prices and sellers.
- [AutoScout24 Listings Scraper](https://apify.com/topapi/autoscout24-listings-scraper): car prices, specs and dealers.
- [Idealista Scraper](https://apify.com/scrapersdelight/idealista-scraper): Spain, Italy and Portugal property listings.
- [Fotocasa Scraper](https://apify.com/scrapersdelight/fotocasa-scraper): Spanish property listings and agents.

### Limits & empty runs

- Wallapop shows 40 listings a page. A search goes deep: 150 pages (5,954 listings) were read for "iphone", and a full BMW Serie 3 search returned 10,489 listings in 14 minutes.
- Speed at the default 256 MB: about 16 detailed listings a second on a long run (1,500 in 91-96 s); small runs finish in 2-4 s. Runs are capped at 512 MB of memory.
- Coordinates are Wallapop's approximate point, not the address.
- Some narrow car searches return sparse pages (a page of 1 or 0 listings before a full one); the actor keeps paging until Wallapop says the search has ended.
- A search that matches nothing ends in about a second, charges nothing, and the status says what to change. Unknown place names fall back to the capital, and the status says so.

### FAQ

#### How much does Wallapop Scraper cost?

$0.22 per 1,000 listings with item details (the default), $0.18 without. Seller profiles add $0.27 per 1,000 rows, reviews are $0.90 per 1,000. No start fee.

#### How many listings can Wallapop Scraper get for one search?

As many as Wallapop has for it: the actor follows the pages to the end (10,489 listings for one car model). Use `maxResults` and `maxResultsPerSearch` to cap it.

#### Does Wallapop Scraper work for Italy and Portugal?

Yes. Set `market` to IT or PT, or name a city ("Milano", "Porto"), or search several countries at once with `countries`. France and the UK work too, with far fewer listings.

#### Can Wallapop Scraper get seller phone numbers and emails?

For professional sellers (shops, dealers) Wallapop publishes a business disclosure: legal name, email, registration number and often a phone. Private sellers publish none, so those fields are empty for them.

#### Can I monitor new Wallapop listings and price drops with Wallapop Scraper?

Yes. Turn on monitor mode and schedule the run: each run returns only new listings and price drops, can return price increases, unchanged or gone listings on request, and can alert Telegram, Discord, Slack, WhatsApp or a webhook.

#### Can Wallapop Scraper scrape a seller's whole shop?

Yes. Put the seller id or profile URL in `sellerIds` and choose listings, profile and/or reviews.

#### Do I need a Wallapop account, cookies or an API key for Wallapop Scraper?

No. It reads what Wallapop shows to any visitor.

#### Can I use Wallapop Scraper with the Apify API or an MCP server?

Yes, see the API and MCP tabs on this page. Turn on `compact` for short rows in AI agents.

#### Why did my Wallapop Scraper run return no results?

The search matched nothing (check the spelling and widen distance or price), the filters in "Refine results" removed everything, or in monitor mode nothing changed since the last run. The status message says which.

#### Is it legal to scrape Wallapop?

Wallapop Scraper collects publicly visible listing data with no login. You are responsible for how you use the output, including any personal data such as seller names.

#### Your feedback

Found a bug or need a field? Open an issue on the [Issues tab](https://apify.com/topapi/wallapop-scraper/issues/open) and we will look at it.

# Actor input Schema

## `searchQueries` (type: `array`):

What to search for, one per line, as you would type it on Wallapop, e.g. "iphone 13", "bicicleta electrica", "ps5". Each term is one search. Leave empty to browse a category.

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

Addresses copied from Wallapop: a search page (all its filters are kept), a category page, a listing (/item/...) or a seller profile (/user/...). e.g. https://es.wallapop.com/search?keywords=ps5\&min_sale_price=200

## `itemIds` (type: `array`):

Wallapop item ids (the 12-character item_id in this actor's output, e.g. wzyr3mvpqp65) or listing URLs. Each one is read with its full details.

## `sellerIds` (type: `array`):

Seller ids (seller_id in this actor's output) or profile URLs (https://es.wallapop.com/user/...). Returns what you pick in "For each seller": their listings, their profile, their reviews.

## `sellerOutput` (type: `array`):

What to return for the sellers above: their active listings (listing rows), their profile (one seller row, a seller-profile event) and/or their reviews (review rows).

## `market` (type: `string`):

Which Wallapop market to search. Sets the search centre (the capital) unless a location or coordinates are given, the language and the listing links. (The field name `country` with Spain, Italy... works too.)

## `countries` (type: `array`):

Search several markets in one run, e.g. ES, IT, PT. Each search term is searched in each. Overrides Country.

## `locations` (type: `array`):

Cities or areas to centre the search on, e.g. "Barcelona", "Valencia", "Milano", or coordinates "41.39,2.17". Several = one search each. Empty = the country's capital.

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

Search centre latitude, e.g. 40.4168. Use with Longitude; overrides Location.

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

Search centre longitude, e.g. -3.7038.

## `postalCode` (type: `string`):

A Spanish postal code, e.g. 28001, used as the search centre when no location is given.

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

Only listings within this many km of the search centre, e.g. 10. Empty = no limit. Every row carries distance_km.

## `category` (type: `string`):

Search inside one category, or browse it with no search term. Cars unlocks the car filters below.

## `subcategoryIds` (type: `array`):

Wallapop subcategory ids, e.g. 24201 (phones). They are in the address of a category page on Wallapop (subcategory_ids=...).

## `sortBy` (type: `string`):

Order of the results. Empty = Wallapop's own order (most relevant); monitor mode reads newest first.

## `postedWithin` (type: `string`):

Only listings published in this window (Wallapop's own date filter).

## `minPrice` (type: `number`):

Only listings at or above this price.

## `maxPrice` (type: `number`):

Only listings at or below this price.

## `conditions` (type: `array`):

Only listings in these conditions (not used by Cars or Real estate).

## `sellerType` (type: `string`):

Private sellers or professionals (shops and dealers) only. Outside Cars it is checked on each seller's profile before the row is delivered.

## `onlyShippable` (type: `boolean`):

Only listings that can be sent by Wallapop shipping.

## `carBrand` (type: `string`):

Cars category: brand as Wallapop spells it, e.g. BMW, Volkswagen, Mercedes-Benz.

## `carModel` (type: `string`):

Cars category: model, e.g. Serie 3, Golf, Clase C (use with Car brand).

## `minYear` (type: `integer`):

Cars and motorbikes: first registration year from.

## `maxYear` (type: `integer`):

Cars and motorbikes: first registration year up to.

## `minKm` (type: `integer`):

Cars and motorbikes: mileage from.

## `maxKm` (type: `integer`):

Cars and motorbikes: mileage up to, e.g. 120000.

## `minHorsePower` (type: `integer`):

Cars: power from (CV).

## `maxHorsePower` (type: `integer`):

Cars: power up to (CV).

## `minSeats` (type: `integer`):

Cars: seats from.

## `maxSeats` (type: `integer`):

Cars: seats up to.

## `minDoors` (type: `integer`):

Cars: doors from.

## `maxDoors` (type: `integer`):

Cars: doors up to.

## `carFuel` (type: `string`):

Cars: engine type.

## `carGearbox` (type: `string`):

Cars: gearbox type.

## `carBodyType` (type: `string`):

Cars: body type.

## `carColor` (type: `string`):

Cars: colour.

## `carHasWarranty` (type: `boolean`):

Cars: only cars sold with a warranty.

## `motorbikeStyle` (type: `array`):

Motorbikes category: styles.

## `realEstateOperation` (type: `string`):

Real estate category: for rent or for sale.

## `realEstateType` (type: `string`):

Real estate category: property type.

## `extraSearchParams` (type: `object`):

Any other parameter of Wallapop's search, passed as is, e.g. {"brand": "Apple"}.

## `requireKeywordMatch` (type: `boolean`):

Drop listings whose title lacks a word of the search term (Wallapop also returns related items).

## `excludeKeywords` (type: `array`):

Drop listings whose title or description contains any of these words, e.g. "funda", "roto", "reparar".

## `excludeAccessoriesAndBroken` (type: `boolean`):

Drop cases, chargers, boxes and parts (title) and broken, faulty or for-parts items (title or description), in Spanish, Italian, Portuguese, French and English.

## `skipReserved` (type: `boolean`):

Drop listings the seller has marked reserved.

## `publishedAfter` (type: `string`):

Only listings published on or after this date (YYYY-MM-DD). With Newest first the search stops at the first page older than it.

## `maxAgeDays` (type: `integer`):

Only listings published in the last N days. Pairs well with a daily schedule.

## `dealAnalysis` (type: `boolean`):

Add the median price of the search (search_median_price) and how far each listing is under it (below_market_percent). The search is read first, then delivered.

## `minBelowMarketPercent` (type: `integer`):

Keep only listings priced at least this % under the search's median, e.g. 20. Turns on Deal analysis.

## `includeDetails` (type: `boolean`):

Open each listing for condition, brand, model and attributes, views, favourites and chats, every photo, the seller's name and type, and a professional seller's business details (legal name, email, phone, registration). +$0.04 per 1,000 listings.

## `includeSellerProfile` (type: `boolean`):

Add the seller's public profile to every listing: rating, reviews, sales and purchases, active listings, response rate, verifications, member since, shop address, website, phone and hours. +$0.27 per 1,000 listings that carry it.

## `includeSellerReviews` (type: `boolean`):

Also deliver the reviews of the sellers of the listings found (review rows: rating, comment, date, item, reviewer). $0.90 per 1,000 reviews.

## `maxReviewsPerSeller` (type: `integer`):

Most recent reviews per seller (40 per page on Wallapop).

## `reviewType` (type: `string`):

Reviews the seller received as a seller, as a buyer, or both.

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

Return only listings that are new since the last run, or whose price dropped. Pairs with a schedule (every 15 minutes to daily). The first run returns everything (or saves a baseline, below).

## `monitorStoreName` (type: `string`):

Name of the store that remembers what earlier runs saw. Use one name per watch list, e.g. "ps5-madrid".

## `monitorMaxPages` (type: `integer`):

Pages of 40 listings read per search in monitor mode (newest first).

## `minPriceDropPercent` (type: `integer`):

A known listing is returned again when its price fell by at least this %.

## `skipFirstRun` (type: `boolean`):

The first monitor run only saves what it sees and returns nothing; later runs return what is new.

## `emitPriceIncreases` (type: `boolean`):

Return known listings whose price went up (change_type PRICE_UP).

## `emitUnchanged` (type: `boolean`):

Return every listing seen, with change_type UNCHANGED for the known ones (charged like any row).

## `emitExpired` (type: `boolean`):

When a search is read to its end, listings it returned last time and that Wallapop no longer has come back once as change_type EXPIRED.

## `skipReposts` (type: `boolean`):

Drop new listings with the same seller and title as one already seen (re-listed items).

## `resetMonitor` (type: `boolean`):

Forget what earlier runs saw and start again.

## `telegramBotToken` (type: `string`):

Send each run's new listings to Telegram: your bot's token (from @BotFather).

## `telegramChatId` (type: `string`):

The chat, group or channel id the bot posts to.

## `discordWebhookUrl` (type: `string`):

A Discord channel webhook.

## `slackWebhookUrl` (type: `string`):

A Slack incoming webhook.

## `whatsappAccessToken` (type: `string`):

Send alerts with the WhatsApp Cloud API: your access token.

## `whatsappPhoneNumberId` (type: `string`):

The sender's phone number id in the WhatsApp Cloud API.

## `whatsappTo` (type: `string`):

Recipient number with country code, e.g. 34600000000.

## `webhookUrl` (type: `string`):

POST the run's new listings as JSON to this address (Make, Zapier, n8n, your own).

## `webhookHeaders` (type: `object`):

Extra HTTP headers for the webhook, e.g. {"Authorization": "Bearer ..."}.

## `notificationLimit` (type: `integer`):

How many listings one alert message lists.

## `notifyOnlyChanges` (type: `boolean`):

Send alerts only for monitor runs that found something new or changed.

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

Most listings (and seller rows) for the whole run. 0 = no limit (Wallapop pages go deep: 150 pages of 40 were read for "iphone"). Reviews have their own limit.

## `maxResultsPerSearch` (type: `integer`):

Most listings per search (per term, location, country or URL). 0 = no limit.

## `maxPagesPerSearch` (type: `integer`):

Most result pages (40 listings each) per search. 0 = no limit.

## `maxResultsPerSeller` (type: `integer`):

Most listings per seller in seller mode. 0 = all of them.

## `compact` (type: `boolean`):

Core fields only (id, title, price, condition, place, date, link, seller, change) - trimmed for AI agents and MCP.

## `excludeEmptyFields` (type: `boolean`):

Drop fields that are null or empty from each row.

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters. 0 = full text.

## `descriptionFormat` (type: `string`):

Plain text, HTML (line breaks as <br>), Markdown, or all three (description_html, description_markdown).

## `imageSize` (type: `string`):

Width of the photo links: 320, 640, 800 or 1024 px.

## `maxImages` (type: `integer`):

Photo links kept per listing. 0 = all.

## `stripSellerPII` (type: `boolean`):

Blank seller and reviewer names, emails, phones, addresses and photos in every row.

## `language` (type: `string`):

Language of category names and attribute labels: es, it, pt, fr, en or ca. Empty = the country's language.

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

Default: the run's own connection, then an Apify datacenter proxy, then a residential one only if Wallapop refuses the others. Pick a group or your own proxies to use only those.

## `maxConcurrency` (type: `integer`):

Requests in flight at once.

## `maxRequestRetries` (type: `integer`):

Retries per request before it counts as failed.

## Actor input object example

```json
{
  "searchQueries": [
    "iphone"
  ],
  "sellerOutput": [
    "listings"
  ],
  "market": "ES",
  "sortBy": "newest",
  "includeDetails": true,
  "maxReviewsPerSeller": 100,
  "monitorStoreName": "wallapop-monitor",
  "monitorMaxPages": 5,
  "minPriceDropPercent": 5,
  "notificationLimit": 5,
  "maxResults": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "maxConcurrency": 20,
  "maxRequestRetries": 3
}
```

# Actor output Schema

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

One item per listing (with details and the seller's profile when asked), per seller profile and per review.

# 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 = {
    "searchQueries": [
        "iphone"
    ],
    "market": "ES",
    "sortBy": "newest",
    "maxResults": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/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 = {
    "searchQueries": ["iphone"],
    "market": "ES",
    "sortBy": "newest",
    "maxResults": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/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 '{
  "searchQueries": [
    "iphone"
  ],
  "market": "ES",
  "sortBy": "newest",
  "maxResults": 50
}' |
apify call topapi/wallapop-scraper --silent --output-dataset

```

## MCP server setup

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