Wallapop Scraper by ScrapeBadger — Overview

Scraper API for Wallapop

Search second-hand listings with Wallapop’s own filters, pull full listing detail (description, attributes, photos, views, and favorites), and look up seller profiles, their live listings, and the reviews they received across Wallapop’s 3 markets — Spain, Italy, and Portugal. Prices are in EUR.

Key Features

3 Markets

One API for Spain (es), Italy (it), and Portugal (pt). Pick one with the market parameter, or search anywhere with latitude / longitude.

Listing Search

Filter by price, condition, brand, model, colour, distance, listing age, shipping, warranty, and refurbished — plus car filters for year, mileage, gearbox, and horsepower.

Rich Listing Detail

Title, description, price, category path, structured attributes, photos, location, shipping, and engagement counters — views, favorites, and conversations.

Seller Profiles

Profiles with rating, sales and purchase counters, response rate, verifications, and every live listing.

Reviews

The reviews a user received, with rating, comment, reviewer, and the listing that was bought or sold.

Structured Data

Clean JSON with numeric prices, ISO 8601 and Unix timestamps, normalised image sizes, and full listing URLs.

Markets

A Wallapop market picks two things: the default search location and the language of category names, filter labels, and attribute text.

Market	Country	Default search location	Language	Currency
:es: `es`	Spain	Madrid (40.4168, -3.7038)	`es-ES`	EUR
:it: `it`	Italy	Rome (41.9028, 12.4964)	`it-IT`	EUR
:portugal: `pt`	Portugal	Lisbon (38.7223, -9.1393)	`pt-PT`	EUR

Wallapop searches by location, not by domain. Pass latitude and longitude to search around any point. Those coordinates override the market’s default location, and the country searched follows them: coordinates in Barcelona return Spanish listings even with market=it. Each search response reports the country Wallapop searched in as country_code.

If no market is specified, it defaults to es. Use /v1/wallapop/markets to get the list, with default coordinates, programmatically.

Quick Start

curl "https://scrapebadger.com/v1/wallapop/search?query=iphone+14&market=es&max_price=400" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

res = requests.get(
    "https://scrapebadger.com/v1/wallapop/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "iphone 14", "market": "es", "max_price": 400},
)
data = res.json()

for item in data["items"]:
    print(item["price"], item["title"], item["url"])

const res = await fetch(
  "https://scrapebadger.com/v1/wallapop/search?" +
    new URLSearchParams({ query: "iphone 14", market: "es", max_price: "400" }),
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();

for (const item of data.items) {
  console.log(item.price, item.title, item.url);
}

scrapebadger wallapop search "iphone 14" --market es --max-price 400

The ScrapeBadger Python and Node.js SDKs do not have typed Wallapop clients yet. Call the REST endpoints directly as shown above, or use the CLI or the MCP server (wallapop_* tools).

Endpoints

Endpoint	Method	Description
`/v1/wallapop/search`	GET	Search listings with Wallapop’s filters
`/v1/wallapop/items/{item_id}`	GET	Full detail for a single listing
`/v1/wallapop/users/{user_id}`	GET	Seller profile with ratings and counters
`/v1/wallapop/users/{user_id}/items`	GET	A seller’s live listings
`/v1/wallapop/users/{user_id}/reviews`	GET	Reviews a user received
`/v1/wallapop/autocomplete`	GET	Search-box suggestions
`/v1/wallapop/categories`	GET	Full category tree
`/v1/wallapop/filters`	GET	Filters available for a category or query
`/v1/wallapop/filters/{filter_id}/options`	GET	Long option lists, such as brands and models
`/v1/wallapop/markets`	GET	Supported markets

Pagination

Search, user listings, and user reviews return up to 40 results per page and a next_page cursor.

Make the first request with your parameters.
To get the next page, send next_page back on its own, with the same market. The cursor carries the original query and filters, so any other search parameters are ignored.
When next_page is null, there are no more results.

import requests

params = {"query": "bicicleta", "market": "es"}
items = []
while True:
    data = requests.get(
        "https://scrapebadger.com/v1/wallapop/search",
        headers={"X-API-Key": "YOUR_API_KEY"},
        params=params,
    ).json()
    items += data["items"]
    if not data["next_page"] or len(items) >= 200:
        break
    params = {"next_page": data["next_page"], "market": "es"}

Credit Costs

Endpoint	Cost
Search listings	5 credits
Get item	5 credits
Get user	5 credits
Get user items	5 credits
Get user reviews	5 credits
List filters	2 credits
List filter options	2 credits
Autocomplete	1 credit
List categories	1 credit
List markets	0 credits
Empty results and failed requests	0 credits

Authentication

All requests require your API key in the X-API-Key header:

curl "https://scrapebadger.com/v1/wallapop/items/nzxeknm5x562" \
  -H "X-API-Key: YOUR_API_KEY"

Next Steps

Search Listings

Full API reference for searching Wallapop, including car filters

Get User

Seller ratings, sales counters, and verifications

ScrapeBadger is an independent tool and is not affiliated with, endorsed by, or sponsored by Wallapop. “Wallapop” is a trademark of Wallapop, S.L., used here only to describe the platform this scraper is designed to work with.

Overview

Search

Items

Users

Reference

Wallapop Scraper by ScrapeBadger — Overview

Scraper API for Wallapop

Key Features

3 Markets

Listing Search

Rich Listing Detail

Seller Profiles

Reviews

Structured Data

Markets

Quick Start

Endpoints

Credit Costs

Authentication

Next Steps

Search Listings

Get User

​Scraper API for Wallapop

​Key Features

3 Markets

Listing Search

Rich Listing Detail

Seller Profiles

Reviews

Structured Data

​Markets

​Quick Start

​Endpoints

​Pagination

​Credit Costs

​Authentication

​Next Steps

Search Listings

Get User

Scraper API for Wallapop

Key Features

Markets

Quick Start

Endpoints

Pagination

Credit Costs

Authentication

Next Steps