# Wallapop Listings by Keyword, Item & Seller (`dataspryva/wallapop-listings-by-keyword-item-and-seller`) Actor

Searches Wallapop by keyword and location, fetches a specific item by URL, or pulls a seller's full listing set, returning price, location, images, and seller details.

- **URL**: https://apify.com/dataspryva/wallapop-listings-by-keyword-item-and-seller.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** E-commerce, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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 Listings by Keyword, Item & Seller

Scrape **Wallapop** — the large second-hand marketplace in Spain, Italy and Portugal. Search by
keyword or category, look up an item by its URL or ID, pull every active listing from a seller, or
read a seller's profile, ratings and reviews. The actor returns prices, condition, photos, location,
shipping, engagement counts and seller reputation as clean JSON. No login, no cookies, no API key,
and no proxy setup.

### What this actor does

- **Four modes:** `search`, `itemDetails`, `sellerListings`, `sellerProfile`.
- **Search by keyword or category:** multiple keywords, all 21 Wallapop categories and 99
  subcategories, with price, condition, posting-date, shipping, distance and sort filters.
- **Market-aware:** Spain, Italy, Portugal, France, Germany and the United Kingdom by coordinates,
  with EUR prices and country-local listings.
- **Item lookup by URL or ID:** full item detail including condition, attributes, images,
  reserves/sold status, views, favourites and conversations.
- **Seller tools:** every active listing from one or more sellers, plus profile stats, rating
  breakdown, public contact details, business legal data and recent reviews.
- **Empty fields are omitted:** a missing value is never returned as `null`, `""` or `[]`.

### Output per listing

Every listing record has `recordType: "listing"`.

- `itemId`, `title`, `description`, `itemUrl`, `webSlug`
- `price`, `currency`, `financedPrice`
- `condition`, `conditionText`
- `categoryId`, `categoryName`, `categoryPath`
- `brand`, `model`, `attributes` — Wallapop's structured item attributes
- `imageUrl`, `imageUrls`
- `city`, `country`, `postalCode`, `region`, `latitude`, `longitude`, `locationApproximate`
- `distanceM` — distance from the search centre, in metres (search mode)
- `publishedDate`, `modifiedDate` — legacy Unix timestamps, when Wallapop provides them
- `publishedAt`, `modifiedAt` — ISO 8601 versions
- `reserved`, `sold`, `expired`, `onHold`, `bumped`, `bumpType`
- `isRefurbished`, `hasWarranty`
- `shippable`, `shippingAllowed`
- `views`, `favorites`, `conversations`
- `seller`, `sellerId`, `sellerRating`, `sellerReviewCount`, `sellerVerified`, `sellerType`,
  `sellerIsTopProfile`, `sellerProfileUrl`, `sellerRegisteredAt`
- `sellerContact` — public address, phone, website and opening hours (business/pro sellers only)
- `sellerLegal` — public legal name, email, registration number and registry (business sellers only)
- `scrapedAt`

Which optional fields appear depends on the mode and on what Wallapop publishes:

- `search` includes location, dates, reserve/shipping flags and taxonomy out of the box. Condition,
  attributes, views, favourites and conversations require **Include item details**. Seller name,
  rating and verification require **Include seller details**.
- `itemDetails` includes condition, attributes, flags, views, favourites, conversations and seller
  reputation. `publishedDate`/`publishedAt` are not available for a single item.
- `sellerListings` includes condition, attributes, shipping, refurbished/warranty and seller fields.
  Location, dates, views and favourites require **Include item details**; published date is not
  available in this mode.

### Output per seller profile

`sellerProfile` returns one record per seller with `recordType: "seller"`.

- `sellerId`, `sellerName`, `sellerWebSlug`, `sellerProfileUrl`
- `sellerType`, `sellerVerified`, `sellerIsTopProfile`, `sellerIsFeatured`, `sellerBadge`
- `avatarUrl`, `registeredAt`, `sellerDescription`
- `rating`, `reviewCount`, `ratingBreakdown`
- `responseRate`, `scoringStars`, `activityLevel`, `validations`
- `activeListings`, `soldCount`, `purchases`, `sales`, `reportsReceived`, `successfulShipments`
- `city`, `country`, `postalCode`, `latitude`, `longitude`
- `website`, `phone`, `address`, `openingHours`
- `legalName`, `legalEmail`, `registrationNumber`, `registryName`, `selfCertification`
- `reviews[]` — reviews up to `maxReviews` (1–2000), newest first
- `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search`, `itemDetails`, `sellerListings` or `sellerProfile` |
| `keywords` | array | `["iphone"]` | Search phrases; each is searched and results are merged without duplicates (mode=search) |
| `itemUrls` | array | – | Wallapop item URLs or alphanumeric item IDs such as `wzvg1nvq81zl`; the numeric suffix at the end of an item URL is not an item ID (mode=itemDetails) |
| `sellerIds` | array | – | Seller IDs, profile URLs or item URLs (mode=sellerListings / sellerProfile) |
| `country` | string | `ES` | Market centre: ES, IT, PT, FR, DE, GB or Custom coordinates |
| `latitude` | number | – | Optional search centre latitude |
| `longitude` | number | – | Optional search centre longitude |
| `category` | string | all | One of Wallapop's 21 top-level categories |
| `subcategory` | string | all | One of the 99 subcategories; can be used alone |
| `orderBy` | string | `most_relevance` | Relevance, newest, nearest, price low-to-high or price high-to-low |
| `minPrice` | integer | – | Minimum asking price in EUR |
| `maxPrice` | integer | – | Maximum asking price in EUR |
| `condition` | string | any | New, new in box, unopened, unworn, as good as new, good, fair or has given it all |
| `timeFilter` | string | any | Today, last 7 days or last 30 days |
| `shippableOnly` | boolean | `false` | Only listings whose seller allows shipping |
| `distanceKm` | integer | – | Maximum distance from the search centre (1–1000 km) |
| `includeItemDetails` | boolean | `false` | Add condition, attributes, views, favourites and conversations to listings |
| `includeSellerDetails` | boolean | `true` | Add seller name, rating, review count and verification to search results |
| `includeReviews` | boolean | `true` | Include recent reviews in seller profiles |
| `maxReviews` | integer | `20` | Maximum reviews per seller (1–2000); fetched in pages of 40 |
| `maxItems` | integer | `20` | Maximum records for search, itemDetails, sellerListings and sellerProfile (1–2000) |

#### Example: keyword search in Madrid

```json
{
  "mode": "search",
  "keywords": ["iphone 14", "iphone 15"],
  "country": "ES",
  "orderBy": "newest",
  "minPrice": 200,
  "maxPrice": 700,
  "condition": "good",
  "includeItemDetails": true,
  "maxItems": 50
}
```

#### Example: Italian category with a radius

```json
{
  "mode": "search",
  "country": "IT",
  "category": "12465",
  "orderBy": "closest",
  "distanceKm": 50,
  "shippableOnly": true,
  "maxItems": 100
}
```

#### Example: one item by URL

```json
{
  "mode": "itemDetails",
  "itemUrls": ["https://es.wallapop.com/item/iphone-11-64gb-rojo-1315331517"]
}
```

#### Example: a seller's catalogue and profile

```json
{
  "mode": "sellerListings",
  "sellerIds": ["https://es.wallapop.com/user/santiagob-407326113"],
  "includeItemDetails": true,
  "maxItems": 200
}
```

```json
{
  "mode": "sellerProfile",
  "sellerIds": ["pj9ygg2gvv6e"],
  "includeReviews": true,
  "maxReviews": 20
}
```

### Use cases

- **Price research:** compare asking prices for the same product across Spanish, Italian and
  Portuguese cities.
- **Resale sourcing:** follow a category with a price cap and spot under-priced listings early.
- **Seller vetting:** read seller ratings, review history and public business details before buying.
- **Catalogue monitoring:** export a shop's full active inventory to a spreadsheet on a schedule.
- **Demand analysis:** rank listings by views, favourites and conversations.
- **Marketplace analytics:** build a clean dataset of condition, attributes and geography.

### Limitations

- `publishedDate` is available in keyword/category search only. Wallapop does not expose a creation
  date on item or seller endpoints, so those modes omit it.
- Seller contact details and business legal data are returned only when the seller has made them
  public (business, shop or pro accounts).
- Reviews are fetched newest-first in pages of 40 until `maxReviews` (default 20, maximum 2,000) or
  the source stops. Verified full collections of 411/411, 1,226/1,226 and 1,714/1,714 reviews for
  sellers of those sizes; the practical ceiling is the seller's public review count.
- `sellerListings` returns active listings only. Sold items are not searchable; an item URL that is
  already sold still works through `itemDetails`.
- **Nearest** uses Wallapop's proximity ranking; the source does not guarantee a strict distance
  order. Sort on `distanceM` if you need exact ordering.
- `categoryId` is Wallapop's top-level taxonomy id, while `categoryName` is the leaf name and
  `categoryPath` is the full hierarchy. Names follow the source locale.
- Italy and Portugal have smaller catalogues. For the largest local result set use **Most relevant**
  or **Nearest**, and a distance that matches the country.

### FAQ

**Do I need a Wallapop account, cookies or an API key?**
No. The actor reads publicly accessible listing and seller data without authentication.

**Do I need to configure a proxy?**
No. The actor connects directly to Wallapop; no proxy configuration is required.

**Which countries are supported?**
Spain, Italy and Portugal are the primary markets. France, Germany and the United Kingdom also
return local listings when you choose their country or supply coordinates; inventory there is much
smaller.

**Why are some fields missing from a record?**
Wallapop omits data for some listings, and some fields are mode-specific. Empty fields are left out
rather than returned as `null`. Turn on **Include item details** for condition, attributes, views and
favourites.

**Why did I get fewer rows than `maxItems`?**
Wallapop exhausted the matching results, or the country filter removed cross-border listings. The
run status reports the requested and returned counts honestly. The actor never fabricates rows.

**Can I get sold items?**
Only if you already have the item URL. Keyword and category search return active listings, and
seller catalogues return active listings. `itemDetails` reports `sold: true` when Wallapop marks the
item sold.

**How many reviews can I get?**
The actor fetches reviews newest-first in pages of 40 until `maxReviews` is reached or Wallapop
has no older reviews. Set `maxReviews` up to 2,000. The run status reports a shortfall if the
source stops earlier.

**How fresh is the data?**
Every run reads the live marketplace. Values reflect Wallapop at the moment of collection.

**Is this affiliated with Wallapop?**
No. This is an independent third-party actor using publicly accessible marketplace data.

# Actor input Schema

## `mode` (type: `string`):

What to fetch from Wallapop.

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

One or more search phrases. Each keyword is searched separately and results are merged without duplicates (mode=search).

## `itemUrls` (type: `array`):

Wallapop item URLs or raw item IDs (mode=itemDetails).

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

Seller IDs, profile URLs or item URLs whose seller should be used (mode=sellerListings and sellerProfile).

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

Market centre used when latitude and longitude are empty.

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

Optional search centre latitude. Leave empty to use the country centre.

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

Optional search centre longitude. Leave empty to use the country centre.

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

Top-level Wallapop category (mode=search).

## `subcategory` (type: `string`):

Optional subcategory. It can be used alone or together with a category (mode=search).

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

Result order (mode=search).

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

Minimum asking price (mode=search).

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

Maximum asking price (mode=search).

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

Item condition (mode=search).

## `timeFilter` (type: `string`):

Only listings posted within this window (mode=search).

## `shippableOnly` (type: `boolean`):

Only listings whose seller allows shipping (mode=search).

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

Maximum distance from the search centre. Leave empty to use the market default.

## `includeItemDetails` (type: `boolean`):

Fetch full item details such as condition, attributes, views, favorites and conversations (mode=search and sellerListings).

## `includeSellerDetails` (type: `boolean`):

Add seller name, rating, review count and verification to each search result (mode=search).

## `includeReviews` (type: `boolean`):

Include the seller's latest reviews (mode=sellerProfile).

## `maxReviews` (type: `integer`):

Maximum reviews per seller (mode=sellerProfile). Wallapop serves older reviews in pages.

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

Maximum records to return for search, itemDetails and sellerListings.

## Actor input object example

```json
{
  "mode": "search",
  "keywords": [
    "iphone"
  ],
  "itemUrls": [],
  "sellerIds": [],
  "country": "ES",
  "category": "",
  "subcategory": "",
  "orderBy": "most_relevance",
  "condition": "",
  "timeFilter": "",
  "shippableOnly": false,
  "includeItemDetails": false,
  "includeSellerDetails": true,
  "includeReviews": true,
  "maxReviews": 1,
  "maxItems": 1
}
```

# Actor output Schema

## `listings` (type: `string`):

Dataset containing all scraped Wallapop listings.

# 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 = {
    "mode": "search",
    "keywords": [
        "iphone"
    ],
    "itemUrls": [],
    "sellerIds": [],
    "country": "ES",
    "category": "",
    "subcategory": "",
    "orderBy": "most_relevance",
    "condition": "",
    "timeFilter": "",
    "shippableOnly": false,
    "includeItemDetails": false,
    "includeSellerDetails": false,
    "includeReviews": false,
    "maxReviews": 1,
    "maxItems": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataspryva/wallapop-listings-by-keyword-item-and-seller").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 = {
    "mode": "search",
    "keywords": ["iphone"],
    "itemUrls": [],
    "sellerIds": [],
    "country": "ES",
    "category": "",
    "subcategory": "",
    "orderBy": "most_relevance",
    "condition": "",
    "timeFilter": "",
    "shippableOnly": False,
    "includeItemDetails": False,
    "includeSellerDetails": False,
    "includeReviews": False,
    "maxReviews": 1,
    "maxItems": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("dataspryva/wallapop-listings-by-keyword-item-and-seller").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 '{
  "mode": "search",
  "keywords": [
    "iphone"
  ],
  "itemUrls": [],
  "sellerIds": [],
  "country": "ES",
  "category": "",
  "subcategory": "",
  "orderBy": "most_relevance",
  "condition": "",
  "timeFilter": "",
  "shippableOnly": false,
  "includeItemDetails": false,
  "includeSellerDetails": false,
  "includeReviews": false,
  "maxReviews": 1,
  "maxItems": 1
}' |
apify call dataspryva/wallapop-listings-by-keyword-item-and-seller --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/wallapop-listings-by-keyword-item-and-seller"
        }
    }
}
```

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/mGhZBe0V7WirMKlSs/builds/YTSKoUyzDC7iXiO8P/openapi.json