Ecommerce Scraper API

Wallapop Scraper API for Second-Hand Listings and Seller Data

Extract structured Wallapop data for resale pricing, market research and seller analysis. Search second-hand listings with Wallapop’s own filters, retrieve complete item details and explore seller profiles, listings and reviews across Spain, Italy and Portugal.

1,000 free credits
No credit card required

Use the same API key and credit balance across every ScrapeBadger API.

GET /v1/wallapop/search
{
  "items": [
    {
      "id": "nzxeknm5x562",
      "title": "iPhone 14 128GB Negro",
      "price": 420.0,
      "currency": "EUR",
      "condition": "as_good_as_new",
      "brand": "Apple",
      "shippable": true,
      "url": "https://es.wallapop.com/item/iphone-14-128gb-1311318554"
    }
  ],
  "result_count": 40,
  "total_results": 2873,
  "next_page": "eyJhbGciOiJIUzI1NiJ9...",
  "market": "es"
}
Endpoints

Explore All 10 Wallapop API Endpoints

Search listings, retrieve complete item details, inspect seller profiles, listings and reviews, and look up categories, filters and markets through structured JSON responses.

  1. Search
  2. Item data
  3. Seller insights
  4. Structured JSON
GET/v1/wallapop/search5 credits

Search Items

Search Wallapop listings with the marketplace’s own filters. Results include the listing id, title, price, condition, brand, model, images, location, shipping availability, slug and URL, plus Wallapop’s estimate of the total number of matches. Pages hold 40 listings and paginate with the next_page cursor.

Optional Parameters: market, latitude, longitude, distance_km, category_id, min_price, max_price, condition, brand, model, color, time_filter, shippable, has_warranty, refurbished, order_by, next_page

Car Filters: min_year, max_year, min_km, max_km, gearbox, min_horsepower, max_horsepower

Supported Sorting: most_relevance, newest, closest, price_low_to_high, price_high_to_low

Parameters
queryrequiredSearch keywords, such as iphone 14. Optional when category_id is set.
Request
curl --get \
  'https://scrapebadger.com/v1/wallapop/search' \
  --data-urlencode 'query=iphone 14' \
  --data-urlencode 'market=es' \
  --data-urlencode 'max_price=500' \
  --data-urlencode 'order_by=newest' \
  --header 'X-API-Key: YOUR_API_KEY'
Response200 OK
{
  "items": [
    {
      "id": "nzxeknm5x562",
      "user_id": "dqjwdd53wwzo",
      "title": "iPhone 14 128GB Negro",
      "description": "iPhone 14 de color negro, con 128GB de almacenamiento. En perfectas condiciones...",
      "price": 420.0,
      "currency": "EUR",
      "category_id": 24200,
      "taxonomy": [
        {
          "id": 24200,
          "name": "Tecnología y electrónica"
        },
        {
          "id": 24201,
          "name": "Telefonía: móviles y smartwatches"
        },
        {
          "id": 9447,
          "name": "Smartphones"
        }
      ],
      "condition": "as_good_as_new",
      "brand": "Apple",
      "model": "iPhone 14",
      "images": [
        {
          "id": "e65ve2rg0l2j",
          "small": "https://cdn.wallapop.com/images/10420/lo/q3/__/c10420p1311318554/i6787540572.jpg?pictureSize=W320",
          "medium": "https://cdn.wallapop.com/images/10420/lo/q3/__/c10420p1311318554/i6787540572.jpg?pictureSize=W640",
          "large": "https://cdn.wallapop.com/images/10420/lo/q3/__/c10420p1311318554/i6787540572.jpg?pictureSize=W800",
          "average_color": "13C1AC"
        }
      ],
      "location": {
        "latitude": 40.4168,
        "longitude": -3.7038,
        "postal_code": "28013",
        "city": "Madrid",
        "region": "Comunidad de Madrid",
        "region2": "Madrid",
        "country_code": "ES",
        "approximated": true
      },
      "shippable": true,
      "reserved": false,
      "bumped": false,
      "is_top_profile": true,
      "slug": "iphone-14-128gb-1311318554",
      "url": "https://es.wallapop.com/item/iphone-14-128gb-1311318554",
      "created_utc": 1791580763,
      "created_at": "2026-10-08T09:19:23Z"
    }
  ],
  "result_count": 40,
  "total_results": 2873,
  "next_page": "eyJhbGciOiJIUzI1NiJ9.eyJwYXJhbXMiOnsibmV4dFBhZ2VQYXJhbXMiOnt9fX0.c2lnbmF0dXJl",
  "order_by": "most_relevance",
  "market": "es",
  "country_code": "ES",
  "search_id": "f3b1c2d4-6a7e-4b8f-9c0d-1e2f3a4b5c6d"
}
View Search Items documentation
200
Request completed successfully
401
API key is missing or invalid
402
The account does not have enough credits
404
The listing or seller does not exist or is no longer available
422
A required parameter or filter is missing or invalid
429
The plan’s request limit has been reached

What Can You Build With the Wallapop Scraper API?

Resale Price Tracking

Monitor asking prices by category, brand, model, condition and location to benchmark second-hand values in Spain, Italy and Portugal. Compare Wallapop listings with data from the Vinted Scraper API and eBay Scraper API.

Search ItemsGet ItemList Filter Options

Used Car Market Analysis

Filter car listings by model year, mileage, gearbox and horsepower to track used-car prices and supply by region. Every listing includes its location and structured vehicle attributes.

Search ItemsGet ItemList Filters

Seller and Shop Intelligence

Analyze seller ratings, review history, sales counters, response rates and verification status to identify trusted sellers, professional resellers and sourcing partners.

Get UserGet User ItemsGet User Reviews

New Listing and Deal Alerts

Sort searches by newest or limit them to today’s listings, then alert on items below your target price within a set distance. Pair with autocomplete to widen keyword coverage.

Search ItemsAutocompleteGet Item
Sign Up For Free

1,000 free credits · No credit card required

Explore More E-commerce Scraper APIs

Connect Wallapop data with other marketplace sources through the same ScrapeBadger account, API key and credit balance.

Why Choose ScrapeBadger?

Build Faster

Get normalized Wallapop data without building parsers or reverse-engineering the marketplace. Start with REST or an official SDK and ship the same day.

Scale Confidently

ScrapeBadger maintains the integration when Wallapop changes, so your pipelines keep running. Failed requests cost 0 credits, and live uptime is on the API status page.

Complete Wallapop Data in One API

Use 10 dedicated endpoints to search listings, retrieve item details, analyze sellers and their reviews, and look up categories, filters and markets in Spain, Italy and Portugal.

Integrate Anywhere

Connect through a REST API, 12 official SDKs or ScrapeBadger's MCP server. Responses use consistent structured JSON with timestamps in both Unix and ISO 8601 form.

Integrate With Your Stack

Use ScrapeBadger through an official SDK, a standard API request or the tools already in your workflow.

Python SDK

Search Wallapop listings, retrieve item details and analyze sellers with typed methods and structured response objects.

Node.js SDK

Add Wallapop listing, pricing and seller data to Node.js or TypeScript applications with an official SDK.

REST API

Connect from any backend or programming language using standard HTTP requests and receive structured JSON responses.

12 Official SDKs

Use official clients for Python, TypeScript, Go, Rust, PHP, C#, Java, Kotlin, Ruby, Swift, Dart and C++.

MCP for AI Tools

Give Claude, ChatGPT, Cursor and other MCP-compatible tools access to typed Wallapop tools for listing search, items, sellers, reviews and reference data.

One API Key

Access Wallapop and ScrapeBadger's other supported marketplace APIs through one account, API key and shared credit balance.

Trusted by Developers Worldwide

See what customers say about ScrapeBadger.

“Awesome scraper! we've used it to analyse products to launch for a ecom analytics company. probably will use further; also used their Amazon product and search scrapers.”

MR
MRiabov
Apify Store review
18 June 2026

“Perfect for my small SAAS, couldnt get vinted working but they do!”

NE
Nebulus
Trustpilot review · Spain
3 September 2026

“Fantastic service - been using this for over 6 months and hasn't failed me ONCE. They are consistently bringing out new scrapers and the prices are the cheapest ive seen on the market. Definitely recommended!”

PY
P Yam
Trustpilot review · United Kingdom
25 September 2026

“Looked for a scraper for multiple platforms to integrate in my projects, ScrapeBadger simply worked for everything I needed. Also integrating the API in my code was a breeze thanks to provided documentation.”

DV
Daniel Varan
Trustpilot review · Romania
8 July 2026

“It is the simplest scraper I ever tried, simple yet effective. simple end points, direct and straighforward. affordable. without doubt : it is a winner. application is easy to use and to connect to your database. service is amazing.”

EA
Emran Andraos
Trustpilot review · Saudi Arabia
10 September 2026

“really easy to use, excellent integration and plenty of free credits meant I was able to test and validate what I wanted without spending money. Great service!”

AT
Alan Tweddell
Trustpilot review · United Kingdom
8 September 2026
Pricing

Simple, transparent pricing

Pay As You Go from $10 or save with a monthly or annual subscription. Every Wallapop endpoint and all 3 markets are available on every plan.

Not Sure Which Plan Fits Your Needs? Calculate Your Cost and Find the Right Plan.

Choose a Wallapop endpoint and enter the number of successful requests you expect to make. Failed requests cost 0 credits.

FAQ

Frequently asked questions

Everything you need to know about the Wallapop Scraper API.

What data can I retrieve with the Wallapop Scraper API?

Search results include listing ids, titles, descriptions, prices, categories, condition, brand, model, images, location, shipping availability and URLs. Get Item adds structured attributes, hashtags and view, favourite and conversation counts. Seller endpoints return profiles with ratings and sales counters, live listings and received reviews.

Which Wallapop markets are supported?

The API supports Spain, Italy and Portugal. Select a market with market (es, it or pt); Spain is the default. The market sets the country searched, the default search location and the language of category names and filter labels. All prices are in EUR.

Can I filter Wallapop search results?

Yes. Search Items supports category, price range, condition, brand, model, colour, listing age, distance from a location, and shippable, warranty and refurbished toggles. Car searches add model year, mileage, gearbox and horsepower ranges. Results can be sorted by relevance, newest, closest or price.

How do I search near a specific location?

Pass latitude and longitude for the search centre and distance_km for the radius, from 1 to 500 km. Without coordinates, searches are centred on the market’s capital: Madrid, Rome or Lisbon.

How does pagination work?

Search Items, Get User Items and Get User Reviews return 40 results per page and a next_page cursor. Pass the cursor back as next_page to fetch the next page. When next_page is empty, there are no more results.

How do I find category ids and filter values?

List Categories returns the full category tree with ids you can pass as category_id. List Filters shows the filters available for a category or query, and List Filter Options returns long option lists such as every brand or model.

Can I look up an item or seller from a Wallapop URL?

Yes. Get Item accepts a listing id, a listing slug or a full Wallapop item URL. The seller endpoints accept a user id or the profile slug from a Wallapop profile URL.

Do I need a Wallapop account?

No. The API returns publicly available Wallapop data, so you do not need a Wallapop account, login or developer key. You only need a ScrapeBadger API key.

How much does the Wallapop Scraper API cost?

Search Items, Get Item, Get User, Get User Items and Get User Reviews cost 5 credits per successful request. Autocomplete and List Categories cost 1 credit, List Filters and List Filter Options cost 2 credits, and List Markets is free. Failed requests cost 0 credits.

Start Building With the Wallapop Scraper API

Use 1,000 free credits to search second-hand listings, track resale prices, inspect items and analyze sellers across Spain, Italy and Portugal.

No credit card required · 1,000 free credits · Failed requests cost 0 credits