# Wallapop.com product search (`data_alchemist/wallapop-search`) Actor

Extracting products from wallapop.com search

- **URL**: https://apify.com/data\_alchemist/wallapop-search.md
- **Developed by:** [Dennis](https://apify.com/data_alchemist) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 9 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 search page scraped (up to 40 items)s

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?

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

## Wallapop Search Scraper

Scrapes search results from [Wallapop](https://wallapop.com) using their internal API. No browser required — fast, lightweight, and easy to configure.

Supports Spain, Portugal, UK, France, and Italy listings. Returns structured item data including price, location, images, and direct item URLs.

### Features

- Searches Wallapop by keyword, price range, and location
- Paginates automatically through results (up to 50 pages)
- Adds human-readable `created_at`, `modified_at`, and `scraped_at` timestamps
- Adds a direct `item_url` link for each listing
- Preset city locations for quick setup
- Configurable result limit

### Input

| Field | Type | Description | Default |
|-------|------|-------------|---------|
| `keywords` | string | Search query | `iphone 5c` |
| `minPrice` | integer | Minimum price in EUR (0 = no minimum) | `0` |
| `maxPrice` | integer | Maximum price in EUR (0 = no maximum) | `200` |
| `city` | select | Preset city location (overrides `location`) | — |
| `location` | string | Custom coordinates as `latitude, longitude` | `40.4165, -3.70256` |
| `orderBy` | select | Sort order | `newest` |
| `maxResults` | integer | Max items to collect (0 = unlimited) | `30` |

#### Order By options

- `newest` — most recently listed
- `closest` — nearest to the search location
- `most_relevance` — best keyword match
- `price_low_to_high`
- `price_high_to_low`

#### City presets

Includes the 4 largest cities from Spain, Portugal, UK, France, and Italy:

| City | Country |
|------|---------|
| Madrid | Spain |
| Barcelona | Spain |
| Valencia | Spain |
| Seville | Spain |
| Zaragoza | Spain |
| Lisbon | Portugal |
| Porto | Portugal |
| Braga | Portugal |
| London | UK |
| Birmingham | UK |
| Manchester | UK |
| Glasgow | UK |
| Paris | France |
| Marseille | France |
| Lyon | France |
| Toulouse | France |
| Rome | Italy |
| Milan | Italy |
| Naples | Italy |
| Turin | Italy |

Select **Custom (use Location field)** to enter your own coordinates.

#### Getting coordinates

The `location` field accepts coordinates in `latitude, longitude` format, for example:

```
40.42119938031212, -3.6949881171162775
```

The easiest way to get coordinates for any place is directly from Google Maps:

1. Open [Google Maps](https://maps.google.com)
2. Navigate to the location you want to search near
3. Right-click on the map
4. The coordinates appear at the top of the context menu — click them to copy

Paste the copied value directly into the `location` field.

### Output

Each item in the dataset contains the full Wallapop listing data plus these added fields:

| Field | Description |
|-------|-------------|
| `item_url` | Direct link to the listing on wallapop.com |
| `created_at` | ISO 8601 timestamp of when the listing was created |
| `modified_at` | ISO 8601 timestamp of the last modification |
| `scraped_at` | ISO 8601 timestamp of when the item was scraped |

#### Example output item

```json
{
  "id": "ejkmwwwep9zx",
  "title": "iPhone 5c 16GB Blue",
  "price": { "amount": 25, "currency": "EUR" },
  "location": { "city": "Madrid", "country_code": "es" },
  "item_url": "https://es.wallapop.com/item/iphone-5c-16gb-blue-1234567",
  "created_at": "2025-04-29T14:33:09.580Z",
  "modified_at": "2025-04-29T14:33:24.851Z",
  "scraped_at": "2025-04-29T15:00:00.000Z"
}
```

# Actor input Schema

## `keywords` (type: `string`):

Search keywords (e.g. 'iphone 5c')

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

Minimum sale price in EUR (0 = no minimum)

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

Maximum sale price in EUR (0 = no maximum)

## `city` (type: `string`):

Pick a city to set the search location. Overrides the Location field.

## `location` (type: `string`):

Latitude and longitude separated by a comma (e.g. '40.4165, -3.70256'). Ignored if City is selected.

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

Sort order for search results

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

Maximum number of items to push to the dataset (0 = unlimited)

## Actor input object example

```json
{
  "keywords": "iphone 5c",
  "minPrice": 0,
  "maxPrice": 200,
  "location": "40.4165, -3.70256",
  "orderBy": "newest",
  "maxResults": 30
}
```

# 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 5c",
    "location": "40.4165, -3.70256",
    "maxResults": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("data_alchemist/wallapop-search").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 5c",
    "location": "40.4165, -3.70256",
    "maxResults": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("data_alchemist/wallapop-search").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 5c",
  "location": "40.4165, -3.70256",
  "maxResults": 30
}' |
apify call data_alchemist/wallapop-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,data_alchemist/wallapop-search"
        }
    }
}

```

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/51ICerGv98B4gPEqI/builds/u5jUscrOhAsU9ynuO/openapi.json