API Reference
Discover Wallapop categories and search filters, query public listings, and retrieve public item details from an item URL. 5 endpoints documented below.
curl -X GET "https://api.crawlora.net/api/v1/wallapop/categories" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora's five Wallapop routes cover public category discovery, search-filter metadata, paged brand/model options, location-aware listing search, and public item detail. A categories pull on 2026-10-27 returned a 997-node search taxonomy under 18 root categories, up to five levels deep, and a filters call for iphone 13 with no category returned only six filters, so the richest schemas appear once a category is chosen. Read categories and filters first, use returned filter IDs and options, then pass caller-provided coordinates and an opaque cursor to search. Follow an item's public URL from search for detail lookup; upstream blocks can still produce a typed unavailable response. Seller contact, favorites, messaging, transactions, and view tracking are not part of this public catalog.
/wallapop/categories on 2026-10-27 held 997 nodes: 18 roots, then 105, 252, 299 and 323 nodes at depths two to five, 859 of them leaves. Four roots are leaves themselves (Cars, Motorbike, Real Estate and Other), so a depth-one id can already be a complete search category. Use the returned ids, not the navigation menu's legacy ones, and re-pull the tree rather than caching it for long.
Call /wallapop/filters with the same query and category you plan to search. With q=iphone 13 and no category it returned a category tree, a location filter (distance_in_km with latitude and longitude), a shipping toggle, a listing-date list (today, lastWeek, lastMonth), a price slider in EUR and a condition list (new, as_good_as_new, good, fair, has_given_it_all). The slider steps by 1 up to 10, by 5 to 100, by 50 to 1,000 and by 500 to 20,000, and the upstream price parameters are named max_sale_price and min_sale_price, unlike the min_price and max_price you send to /wallapop/search.
Use a returned filter_id and category_id with /wallapop/filter-options. Preserve its opaque cursor and option values rather than inventing a brand or model label.
Call /wallapop/search with q and caller-provided latitude/longitude, then apply documented category, price, condition, shipping, distance, time, and dynamic filters. Follow the returned cursor for the next page.
Pass a clean ES, IT, or PT item URL returned by /wallapop/search to /wallapop/item. The endpoint reads only anonymous item-page data and can return a typed upstream error when Wallapop blocks the request.
Wallapop's Help Center says buyers have 48 hours after delivery to inspect an order sent through Wallapop Envíos. These read-only listing routes do not expose transaction state, so a shipping flag alone cannot confirm that a purchase or its protection applies.
A Wallapop result only means something for the place and filters that produced it, so store latitude, longitude, distance_in_km, the category, the filters, the cursor and the retrieval time beside each listing. Treat a typed upstream error as a retry condition, not as an empty result set, so a blocked request is never recorded as zero listings.
Wallapop API endpoints/wallapop/categoriesapiKey1 credit/requestReturns the complete live search taxonomy as a flat parent-linked list, including all descendant IDs used by /wallapop/search. Only IDs from this search taxonomy are accepted; legacy navigation-only IDs are excluded. Re-fetch periodically because the upstream taxonomy changes.
Takes no parameters.
/wallapop/filter-optionsapiKey2 credits/requestReturns one page from a remote option list advertised by /wallapop/filters. Use its exact filter_id and category_id. brand/model lists use a root category ID; category-specific lists use the selected category ID. Model discovery requires brand. Multi-select options such as size map to the live search parameter fashion_size. q and sort provide listing context; options_query narrows the option list. Follow next_cursor while repeating the same context; an empty terminal page has no next_cursor. Option IDs are accepted by /wallapop/search's filter parameter.
Required: filter_id, category_id. Optional: brand, q, sort (5 allowed values: closest, most_relevance, newest, price_low_to_high, price_high_to_low), options_query, cursor.
/wallapop/filtersapiKey1 credit/requestReturns Wallapop's live search filter schema for a query and optional category. Each filter includes its current type, the upstream search-enabled flag when provided, accepted parameter names, inline option values or slider bounds, and a category-scoped /wallapop/filter-options link for remote value lists.
Optional: q, category_id.
/wallapop/itemapiKey5 credits/requestReturns public listing details parsed from the anonymous server-rendered item page: description, price, taxonomy, condition, images, coarse location, shipping, category attributes, hashtags, and related-search links. Pass a clean https item URL returned by /wallapop/search, using es.wallapop.com, it.wallapop.com, or pt.wallapop.com. Seller/profile/contact data, exact coordinates, postal codes, favorites, and view-tracking state are omitted. The upstream may rate-limit or block requests; this endpoint retries automatically (up to three attempts).
Required: url.
/wallapop/searchapiKey3 credits/requestReturns one page of public Wallapop listing cards with title, price, currency, images, coarse location, taxonomy, shipping state, and a public item URL. q is a free-text search. latitude and longitude are required caller-provided coordinates because Wallapop otherwise infers location from the server's network location. category_id accepts any ID returned by /wallapop/categories, including descendants. sort is one of closest, most_relevance, newest, price_low_to_high, or price_high_to_low. When category_id is supplied, discover condition values from /wallapop/filters; categories can add values beyond the base set. Use /wallapop/filter-options for remote filter values. Pass next_cursor back as cursor by itself to fetch the next page.
Required: q, latitude, longitude. Optional: category_id, sort (5 allowed values: closest, most_relevance, newest, price_low_to_high, price_high_to_low), min_price, max_price, condition, is_shippable (true), time_filter (3 allowed values: today, lastWeek, lastMonth), distance_in_km, filter, cursor.