Skip to main content
GET
Search Listings
Search Wallapop listings, 40 per page, with the same filters the Wallapop app offers. Send a query, a category_id, or both. Credits: 5 per page. Empty results are not charged.

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
Search text, e.g. iphone 14, bicicleta montaña. Required unless you pass category_id; requests with neither return 422.
string
default:"es"
es (Spain), it (Italy), or pt (Portugal). Sets the default search location (Madrid, Rome, or Lisbon) and the language of category and attribute text. Any other value returns 422. See /v1/wallapop/markets.
number
Search centre latitude, -90 to 90. Defaults to the market’s capital. The country searched follows the coordinates, not the market.
number
Search centre longitude, -180 to 180. Defaults to the market’s capital.
integer
Radius around the search centre in kilometres, 1 to 500. Omit to search without a radius limit.
integer
Category id from /v1/wallapop/categories, e.g. 24200 (Technology & electronics) or 100 (Cars). Required unless you pass query.
number
Minimum price in EUR, 0 or more.
number
Maximum price in EUR, 0 or more.
string
Comma-separated conditions: un_opened, in_box, new, as_good_as_new, good, fair, has_given_it_all. Example: new,as_good_as_new.
string
Brand option id, e.g. Apple. Get valid ids from /v1/wallapop/filters/brand/options for your category or query.
string
Model option id, e.g. iPhone 14. Get valid ids from /v1/wallapop/filters/model/options.
string
Colour option id, e.g. black. Valid ids are listed under the color filter in /v1/wallapop/filters.
string
Only listings published within: today, lastWeek, or lastMonth.
boolean
default:"false"
true returns only listings that can be shipped.
boolean
default:"false"
true returns only listings with a warranty.
boolean
default:"false"
true returns only refurbished listings.
string
default:"most_relevance"
Sort order: most_relevance, newest, closest, price_low_to_high, or price_high_to_low.
string
Cursor from the previous response’s next_page. Send it on its own (with the same market): the cursor carries the original query and filters, and all other search parameters are ignored.

Car filters

These filters apply when you search cars with category_id=100.
integer
Earliest model year, e.g. 2015.
integer
Latest model year.
integer
Minimum mileage in km, 0 or more.
integer
Maximum mileage in km, 0 or more.
string
manual or automatic.
integer
Minimum engine power in hp, 0 or more.
integer
Maximum engine power in hp, 0 or more.
For car searches, brand and model take the car make and model option ids from /v1/wallapop/filters/brand/options?category_id=100 and /v1/wallapop/filters/model/options?category_id=100.
There is no sold-listings search: Wallapop search only returns live listings. To see what a seller has sold, read their reviews — reviews with type: "sell" name the listing they sold.

Response

SearchItem[]
Matching listings, up to 40 per page.
integer
Number of listings on this page.
integer | null
Wallapop’s own estimate of how many listings match the search. null on the last page.
string | null
Cursor for the next page. Pass it back as next_page; null when there are no more results.
string | null
The sort order Wallapop applied.
string
The market used for the request.
string | null
The country Wallapop searched in, which follows the search coordinates.
string | null
Wallapop’s id for this search.

Example

Car search — manual cars from 2015 on with under 100,000 km, closest to Madrid first:
Car listings carry their specs in attributes:
Response

Errors

Each search request costs 5 credits. Pages with no results and failed requests are not charged.