Spain has several large second-hand marketplaces, and each one has its own search box, its own filters and its own result page. If you want to see what a phone or a piece of furniture costs across them, you end up opening tabs. This tutorial shows a different route: one keyword goes into one Actor, and one table of listings comes back, with each row labelled by the marketplace it came from.

The Actor is Wallapop + Vinted + Milanuncios Scraper (reventadata/wallapop-vinted-milanuncios-scraper). It reads public pages without a login, and it returns one row per listing. The sample rows below are real rows from a run on 2026-11-16, copied from the run's saved dataset without changes to any value.

Prerequisites

You need three things:

  1. Python 3.11 or newer, because the Apify client for Python 3.x requires it.
  2. A free Apify account, which you can create with an email address or a GitHub login.
  3. Your API token, from Settings > API & Integrations in Apify Console.

Install the client and export the token:

pip install -U "apify-client~=3.0" export APIFY_API_TOKEN="your_apify_token_here" 

No scraping code is needed on your side. The Actor fetches the pages.

What you'll achieve

You will search for one keyword, read the rows in Python and print one line per listing: the marketplace, the price in euros, the title and the link. The same script works for a buyer comparing asking prices, a seller checking what similar items sell for, or an analyst building a small price table. Only the input changes.

The Actor has five marketplaces in its input list: Wallapop, Vinted, Milanuncios, Cash Converters and eBay Spain. You choose which ones to search with the sites field.

Step 1: Open the Actor

Open the Actor page on Apify Store. The Try for free button there opens the Actor in Apify Console. This tutorial uses the API from Python, so you only need the Actor name, reventadata/wallapop-vinted-milanuncios-scraper.

Step 2: Choose the search

The input has three fields that matter for a first run:

  • searchQueries: a list of search terms. Each term is searched on every marketplace you pick. The field is required; a run without it stops with a message.
  • sites: a list of marketplace names from this set: wallapop, vinted, milanuncios, cashconverters and ebay. A name outside the set is refused before the run starts.
  • maxItemsPerSite: how many listings to collect from each marketplace. The default is 100 and the example below uses 10.

Two optional fields, minPrice and maxPrice, set a price floor and ceiling in euros. Leave minPrice out and Wallapop applies its own minimum of 1 EUR.

The input for this tutorial searches two marketplaces for one term:

{ "searchQueries": ["iphone 13"], "sites": ["cashconverters", "wallapop"], "maxItemsPerSite": 10 } 

This Actor has no battery, damage or accessory filters. The single-marketplace Actors in the Store expose their own filters, for example battery health on Wallapop, so use one of those when you need a filter on one site.

Step 3: Run it from Python

This script starts the Actor, waits for it, reads the dataset and prints two lines per listing:

import os from apify_client import ApifyClient # 1. Initialise the client with your token from the environment client = ApifyClient(os.environ["APIFY_API_TOKEN"]) # 2. One keyword, two marketplaces, up to 10 listings from each run_input = { "searchQueries": ["iphone 13"], "sites": ["cashconverters", "wallapop"], "maxItemsPerSite": 10, } # 3. Start the Actor and wait for it to finish run = client.actor("reventadata/wallapop-vinted-milanuncios-scraper").call(run_input=run_input) if run is None or run.status != "SUCCEEDED": status = run.status if run else "unknown" raise SystemExit(f"Run did not succeed (status: {status}).") # 4. Read the rows from the run's default dataset items = client.dataset(run.default_dataset_id).list_items().items print(f"Retrieved {len(items)} listings.\n") # 5. Print two lines per listing: marketplace, price and title, then the link for item in items: print(f"{item['sourceSite']:<15} {item['price']!s:>6} EUR {item['title']}") print(f"{'':<15} {item['url']}") 

When the run succeeds, the script prints the number of listings and then the two lines for each one. If a search matches nothing, the run still ends SUCCEEDED, with a status message that says nothing matched.

Understanding your results

Each row is one listing. These fields are on every row:

  • sourceSite: the marketplace the listing came from.
  • query: the search term of the run. With more than one term it holds them joined with ", "; the Actor does not tag each row with a single term.
  • title, price, currency, url: the listing's title, asking price in EUR, and link.
  • priceBasis: which field the price came from. On Vinted this is the total including the buyer protection fee, and the field is totalPrice; on the other marketplaces it is price.
  • condition, id, imageUrl, sellerType, category: the marketplace's own values where it publishes them. Any field the marketplace does not publish is null.
  • raw: the listing exactly as that marketplace returned it, with every field it publishes.

Here are three rows from the run, with raw cut to three keys. The values are unchanged.

[ { "sourceSite": "wallapop", "query": "iphone 13", "title": "iPhone 13 Pro Max", "price": 370, "priceBasis": "price", "currency": "EUR", "url": "https://es.wallapop.com/item/iphone-13-pro-max-1324812954", "condition": null, "id": null, "imageUrl": "https://cdn.wallapop.com/images/10420/lw/rc/__/c10420p1324812954/i6868369659.jpg?pictureSize=W800", "sellerType": null, "category": null, "raw": { "batteryHealth": 100, "city": "Madrid", "distanceKm": 0.9 } }, { "sourceSite": "wallapop", "query": "iphone 13", "title": "Pantalla original iPhone 13 Pro Max", "price": 40, "priceBasis": "price", "currency": "EUR", "url": "https://es.wallapop.com/item/pantalla-original-iphone-13-pro-max-1324013357", "condition": null, "id": null, "imageUrl": "https://cdn.wallapop.com/images/10420/lw/a7/__/c10420p1324013357/i6864526603.jpg?pictureSize=W800", "sellerType": null, "category": null, "raw": { "batteryHealth": null, "city": "Madrid", "distanceKm": 0.9 } }, { "sourceSite": "wallapop", "query": "iphone 13", "title": "iPhone 13 256GB batería 100% impecable", "price": 270, "priceBasis": "price", "currency": "EUR", "url": "https://es.wallapop.com/item/iphone-13-256gb-bateria-100-impecable-1324426079", "condition": null, "id": null, "imageUrl": "https://cdn.wallapop.com/images/10420/lw/j1/__/c10420p1324426079/i6866606302.jpg?pictureSize=W800", "sellerType": null, "category": null, "raw": { "batteryHealth": 100, "city": "Madrid", "distanceKm": 0.8 } } ] 

The run returned 20 listings from two marketplaces. The first 10 of those listings are the rows saved for this article, and all 10 are from Wallapop. Across those 10 rows, the asking prices run from 40 to 370 EUR, with a median of 310 EUR. All 10 rows give Madrid as the city. In this run, condition, id, sellerType and category are empty on every row. raw.batteryHealth is set on 6 of the 10 rows.

Pro tips

  1. Use the same keyword on every marketplace. The searchQueries term goes to each marketplace in sites, so the rows are comparable by keyword, not by category.
  2. Expect accessories. The lowest-priced row in the sample is titled "Pantalla original iPhone 13 Pro Max". A broad keyword returns parts as well as devices.
  3. Set a price range early. minPrice and maxPrice narrow the rows you read, which helps when a keyword returns parts.
  4. Compute your own summary. The Actor returns the rows; medians, averages and per-marketplace counts are yours to work out in Python, from the price and sourceSite fields.
  5. Keep maxItemsPerSite small while testing. Ten listings per marketplace is enough to check the output before a bigger search.

Troubleshooting

  • The run ends FAILED. The status message names the problem. A missing searchQueries or a site name outside the list is refused before the run starts.
  • A marketplace is missing from the rows. The status message names each marketplace whose run did not succeed.
  • Zero rows, status SUCCEEDED. The marketplaces answered and nothing matched the keyword. Try a broader term.
  • Fewer rows than maxItemsPerSite. The marketplace had fewer listings for the term. The count is per marketplace.

Next steps

For current pricing and details, see the Store page.

To repeat a search, save it as an Apify task and attach a schedule, which runs an Actor or task on a cron expression. Datasets export as JSON, CSV, XML, Excel, HTML table, RSS or JSONL (dataset docs), and a webhook can notify your application when a run finishes (webhook docs).

Which search would you run first across the Spanish marketplaces? Drop a comment! 💬

About the author: reventadata builds and publishes data extraction Actors on the Apify Store.