Wallapop Product Scraper

Last updated: 30 March 2026 | Apify Platform | Documentation

---

What is Wallapop Product Scraper?

Wallapop Product Scraper is an Apify Actor that extracts product listings from Wallapop, a popular Spanish marketplace for second-hand items. It uses the official Wallapop API to retrieve product titles, prices, images, locations, and shipping availability information.

This tool is designed for e-commerce researchers, price comparison analysts, developers, and businesses that need to collect Wallapop product data programmatically. It efficiently collects up to 40 products per API request with pagination support.

---

Quick Start

1. Open on Apify Console
2. Enter your search keyword
3. Click Run
4. Download results from the Dataset tab

{
  "keyword": "iphone",
  "orderBy": "newest",
  "maxResults": 200
}

---

Input Parameters

Parameter	Type	Required	Default	Description
keyword	string	Yes	-	Search keyword for Wallapop products
location	string	No	-	Province coordinates (latitude,longitude) for local results, e.g., "41.3851,2.1734" for Barcelona
category	string	No	-	Category ID (e.g., 12800 for móviles, 24200 for tecnología)
subcategory	string	No	-	Subcategory ID (requires category to be selected)
orderBy	string	No	most_relevance	Sort order: newest, price_low_to_high, price_high_to_low, most_relevance, closest
condition	string	No	-	Filter by condition: un_opened, new, as_good_as_new, good, fair, has_given_it_all
publishedSince	string	No	-	Filter by publish date: today, lastWeek, lastMonth
shipOnly	boolean	No	false	Show only items with shipping available (Envío disponible)
minPrice	integer	No	-	Minimum price in euros
maxPrice	integer	No	-	Maximum price in euros
maxResults	integer	No	120	Maximum products to retrieve (minimum 40, maximum 10000)

---

Output Example

{
  "id": "pj94qq340v6e",
  "userId": "vjrdxnwko46k",
  "title": "iPhone 11 128GB Negro",
  "description": "Teléfono móvil iPhone 11 en color negro...",
  "categoryId": 24200,
  "price": 125,
  "currency": "EUR",
  "imageUrl": "https://cdn.wallapop.com/images/10420/km/3x/__/c10420p1246458561/i6395530780.jpg?pictureSize=W800",
  "images": [
    {
      "id": "qzm9pny8x9y6",
      "averageColor": "13C1AC",
      "urls": {
        "small": "https://cdn.wallapop.com/...",
        "medium": "https://cdn.wallapop.com/...",
        "big": "https://cdn.wallapop.com/..."
      }
    },
    { "id": "xzol70rqm87z", "urls": {...} },
    { "id": "ejkx5rkq7xy6", "urls": {...} },
    { "id": "wmpn5slq8yz5", "urls": {...} },
    { "id": "klnm4rjs9zxa", "urls": {...} },
    { "id": "lomp3oika0wy", "urls": {...} }
  ],
  "productUrl": "https://es.wallapop.com/item/iphone-11-128gb-negro-pj94qq340v6e",
  "location": {
    "latitude": 40.416775,
    "longitude": -3.70379,
    "postalCode": "28013",
    "city": "Madrid",
    "region": "Comunidad de Madrid",
    "region2": "Madrid",
    "countryCode": "ES"
  },
  "shipping": {
    "itemIsShippable": true,
    "userAllowsShipping": false
  },
  "reserved": { "flag": false },
  "favorited": { "flag": false },
  "bump": { "type": "city" },
  "webSlug": "iphone-11-128gb-negro-pj94qq340v6e",
  "createdAt": 1774793921401,
  "modifiedAt": 1774800470626,
  "taxonomy": [
    { "id": 24200, "name": "Tecnología y electrónica", "icon": "robot" },
    { "id": 24201, "name": "Telefonía: móviles y smartwatches", "icon": null },
    { "id": 9447, "name": "Smartphones", "icon": null }
  ],
  "isFavoriteable": { "flag": true },
  "isRefurbished": { "flag": false },
  "isTopProfile": { "flag": false },
  "hasWarranty": { "flag": false }
}

Output Fields

Field	Type	Description
id	string	Unique product identifier
userId	string	Seller identifier
title	string	Product title
description	string?	Product description
categoryId	number	Category identifier
price	number	Product price in EUR
currency	string	Currency code (EUR)
imageUrl	string	Primary product image URL (big size)
images	array?	All product images (6 images typically)
images[].id	string	Image identifier
images[].averageColor	string?	Average color of the image
images[].urls	object	Image URLs for different sizes
images[].urls.small	string?	Small size (320px)
images[].urls.medium	string?	Medium size (640px)
images[].urls.big	string?	Big size (800px)
productUrl	string	Full URL to Wallapop product page
location	object?	Seller's location details
location.latitude	number	Location latitude
location.longitude	number	Location longitude
location.postalCode	string?	Postal code
location.city	string?	City name
location.region	string?	Region name
location.region2	string?	Secondary region name
location.countryCode	string?	Country code
shipping	object?	Shipping options
shipping.itemIsShippable	boolean?	Item can be shipped
shipping.userAllowsShipping	boolean?	Seller allows shipping
reserved	object?	Reserved status: { flag: boolean }
favorited	object?	Favorited status: { flag: boolean }
bump	object?	Bump info: { type: string }
webSlug	string?	URL-friendly slug
createdAt	number?	Unix timestamp when listing created
modifiedAt	number?	Unix timestamp when listing modified
taxonomy	array?	Category hierarchy (3 levels)
taxonomy[].id	number	Category ID
taxonomy[].name	string	Category name
taxonomy[].icon	string?	Category icon
isFavoriteable	object?	Can be favorited: { flag: boolean }
isRefurbished	object?	Is refurbished: { flag: boolean }
isTopProfile	object?	Seller is top profile: { flag: boolean }
hasWarranty	object?	Has warranty: { flag: boolean }

---

Features

Feature	Description
Product Extraction	Full product data: title, description, price, images, location, seller
API-Based	Uses official Wallapop API for reliable data extraction
Shipping Detection	Identifies products with "Envío disponible"
Multiple Images	Extracts all product images with different sizes
Location Details	Full location data: city, region, postal code, coordinates
Pagination	Automatically fetches multiple pages (40 products per page)
Multiple Sort Orders	newest, price_low_to_high, price_high_to_low, most_relevance, closest
Location Filter	Search by province with coordinates for localized results
Condition Filter	Filter by: un_opened, new, as_good_as_new, good, fair, has_given_it_all
Price Filter	Filter by minimum and maximum price in euros
Shipping Filter	Filter by shipping availability (Envío disponible)
Data Validation	Zod schemas ensure structured output
Product Status	Tracks reserved, bumped, favorited status
Seller Info	Seller ID and top profile indicator
Category Taxonomy	Full category hierarchy from API

---

Use Cases

Market Research

{
  "keyword": "iphone",
  "orderBy": "newest",
  "maxResults": 500
}

Analyze pricing trends, product availability, and market demand for specific categories.

Price Comparison

{
  "keyword": "macbook air",
  "orderBy": "price_low_to_high",
  "maxResults": 200
}

Compare prices across multiple listings to find the best deals.

Local Search

{
  "keyword": "bicicleta",
  "location": "41.3851,2.1734",
  "orderBy": "closest",
  "maxResults": 100
}

Find products near Barcelona (or any other province with coordinates).

Inventory Monitoring

{
  "keyword": "playstation 5",
  "location": "40.4168,-3.7038",
  "orderBy": "closest",
  "maxResults": 100
}

Track available inventory for high-demand products in your area.

---

Comparison: Wallapop Scraper vs. Other Methods

Feature	This Actor	Manual Search	Web Scraping
Cost	$0.002 per product	Free (labor cost)	Variable
Speed	1000+ products/min	1 product/min	20-40 products/min
Reliability	API (stable)	N/A	DOM-dependent
Data depth	Full product details	Limited	Often limited
Shipping	Yes (boolean)	Manual check	Sometimes
Location	Yes (with proximity)	Manual check	Sometimes
Data format	Clean JSON	Copy-paste	Varies

---

Tech Stack

• Apify SDK — Actor platform for cloud execution
• Bun — JavaScript runtime for fast performance
• Wallapop API — Official marketplace API
• TypeScript — Type safety and better developer experience
• Zod — Schema validation for data integrity

---

Frequently Asked Questions

How does this scraper work?

The actor uses the official Wallapop API (api.wallapop.com/api/v3/search) to query product listings. It sends HTTP requests with the search parameters and parses the JSON response. Pagination is handled automatically by following the next_page token returned by the API.

Is this legal?

This tool uses Wallapop's public API to retrieve product listings. It should be used for legitimate data collection purposes only. Ensure compliance with Wallapop's Terms of Service. This is not affiliated with Wallapop.

How many products can I collect?

The maxResults parameter allows you to set a limit between 40 and 10000. The default is 120 products. The API returns 40 products per request, so larger result sets require multiple API calls.

Does this work with private seller accounts?

The API accesses public product listings only. Private seller information is not accessible.

How fast is the actor?

The actor processes approximately 1000+ products per minute, depending on network speed and API response times. Each page request returns 40 products.

What provinces are available for location search?

The input schema includes all 50 Spanish provinces with their coordinates. Select a province from the dropdown to search for products near that location. Use "closest" as the orderBy to get products nearest to the coordinates.

---

Related Tools

• Wallapop — Official Wallapop website
• Apify Platform — Actor hosting platform
• Apify SDK Documentation — Actor development

---

Pricing

This actor supports pay-per-event pricing. Each scraped product charges for the event (configured as products event).

---

Legal Notice

This tool is for legitimate data collection purposes only. Ensure compliance with Wallapop's Terms of Service. This tool is not affiliated with, endorsed by, or connected to Wallapop.