Listing Search
/api/wallapop/search
Search listings by keyword, category, price, condition, shipping and market
Scrappa's Wallapop API returns structured JSON from Wallapop, one of Southern Europe's largest peer-to-peer marketplaces. Search current second-hand listings with keyword, category, price, condition, and shipping filters, open any listing for full details with its seller, browse seller inventories, reputation, scoring and activity counters, read review text, and explore the category tree across the Spanish, Italian, and Portuguese markets. Scrappa is an independent service and is not affiliated with or endorsed by Wallapop.
Try it now
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
curl -X GET "https://scrappa.co/api/wallapop/search?keywords=bici&search_country=ES&latitude=40.4168&longitude=-3.7038" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
{
"success": true,
"data": {
"items": [
{
"id": "8j38nemrv2z9",
"title": "Bici de montaña",
"price": { "amount": 70.0, "currency": "EUR" },
"is_shippable": true,
"location": {
"postal_code": "28001",
"city": "Madrid",
"country_code": "ES"
},
"distance": 2.4
}
],
"pagination": { "count": 1, "next_cursor": "eyJvZmZzZXQiOjQwfQ" },
"applied_filters": {
"radius_km": null,
"radius_filtering": "client_side_on_returned_page"
}
},
"meta": { "endpoint_family": "search" }
}
Structured data for real applications. Here are some ideas.
Compare second-hand prices across Spain, Italy and Portugal with numeric prices, listing condition, shipping eligibility and per-listing country codes.
Screen a seller before you buy with their public profile, rating summary, review text and full current inventory.
Track a seller's current listings and price movements, including other listings from the same seller as an item you already hold.
Add second-hand marketplace search to your own product with keyword, category, price, condition and shipping filters and cursor pagination.
Enrich your catalog with a deep category tree, real listing descriptions, images, and locality data resolved from postal codes.
Wallapop marketplace API
The Wallapop API is built for resale research, price comparison, and marketplace search features. Each listing returns a title, description, numeric price and currency, image set, category taxonomy, locality with country code, shipping eligibility, and timestamps. Item details add the full description, listing attributes, engagement counters and the public seller profile.
Search by keyword, category ID, price range, condition, shipping eligibility and market across Spain, Italy and Portugal.
Sort only with values the marketplace publishes in the filters endpoint; an unpublished sort is rejected instead of silently defaulted.
Read the category tree once and reuse its numeric IDs — the same taxonomy serves all three markets.
Open any listing for full details and its seller, then read the seller's inventory, reputation summary and review text.
Filter the returned page by distance with radius_km and by market with search_country; both are applied client-side to results the marketplace returns.
Test the Wallapop API with 500 free monthly credits before scaling production traffic.
Combine keyword, category, price and condition filters with market and coordinates to collect matching listings with numeric prices, shipping eligibility and per-listing country codes.
Open Wallapop Search API docsOpen a listing by item_id for the full description, attributes and counters, then read the seller profile, rating summary and review text before you commit to a purchase.
Open Wallapop Item API docsTrack a seller's current listings with the seller inventory endpoint, and use the seller other items endpoint to see everything a seller has listed around a listing you already hold.
Open Wallapop Seller Inventory API docsEverything you need in one API.
/api/wallapop/search
Search listings by keyword, category, price, condition, shipping and market
/api/wallapop/filters
Get the filter facets and sort options published for a search
/api/wallapop/items/{item_id}
Get the full record of one listing with its public seller
/api/wallapop/users/{user_id}
Get a seller public profile with rating, scoring and counters
/api/wallapop/users/{user_id}/reviews
Get reviews a seller received with full review text
/api/wallapop/users/{user_id}/items
Browse the current inventory of one seller
/api/wallapop/items/{item_id}/seller-items
Get other current listings from the seller of a given listing
/api/wallapop/categories
Get the category tree with numeric IDs for filtering
/api/wallapop/postal-codes
Resolve a postal code to its city, region and country
/api/wallapop/markets
Get the country and market reference for the supported markets
/api/wallapop/suggesters/car-brands
Get the car brand vocabulary for vehicle filters
/api/wallapop/suggesters/car-models
Get the car model vocabulary for a brand
/api/wallapop/suggesters/car-years
Get the car year vocabulary for vehicle filters
/api/wallapop/items/{item_id}/legacy-id
Translate between current listing IDs and legacy numeric IDs
/api/wallapop/items/by-legacy-id/{legacy_item_id}
Resolve a legacy numeric item ID back to its current listing
Add second-hand fashion listings alongside second-hand goods with Vinted inventory and seller data.
Compare German classifieds listings with Wallapop listings for European resale research.
Add used-vehicle listing data to your European marketplace research.
See how Scrappa compares to the official API.
| Feature | Scrappa | Wallapop official API |
|---|---|---|
| Wallapop listing data | Yes (dedicated API) | No public API |
| Markets | ES, IT, PT | ES only |
| Seller reputation | Not published | |
| Review text | Not published | |
| Authentication | API key only | Not available |
| Price per 1k requests | $0.20 | n/a |
| Setup time | Minutes | n/a |
| Free tier | 500 credits/month | n/a |
No public API exists for Wallapop listing data. Scrappa provides structured JSON access to search, listings, sellers, reviews and categories across Spain, Italy and Portugal.
Spain, Italy and Portugal. Pass search_country to scope a search; the response reports how many cross-border listings were kept and how many were discarded.
The marketplace index has no radius parameter. radius_km filters the returned page on the distance each listing already carries, and the response states that filtering mode in applied_filters.
Just a Scrappa API key in the X-API-KEY header. No Wallapop account, no OAuth, no developer programme.
Yes. The seller endpoint returns the rating summary, response rate, scoring stars, rating average, published validations and activity counters. Personal fields are never included.
Every Scrappa account includes 500 free credits each month. After that each request costs one credit. A request that fails is never billed.