Wallapop Listings by Keyword, Item & Seller
Searches Wallapop by keyword and location, fetches a specific item by URL, or pulls a seller's full listing set, returning price, location, images, and seller details.
Input schema
Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | required | What to fetch from Wallapop. |
keywords | array | optional | One or more search phrases. Each keyword is searched separately and results are merged without duplicates (mode=search). |
itemUrls | array | optional | Wallapop item URLs or raw item IDs (mode=itemDetails). |
Show all input fields
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | required | What to fetch from Wallapop. |
keywords | array | optional | One or more search phrases. Each keyword is searched separately and results are merged without duplicates (mode=search). |
itemUrls | array | optional | Wallapop item URLs or raw item IDs (mode=itemDetails). |
sellerIds | array | optional | Seller IDs, profile URLs or item URLs whose seller should be used (mode=sellerListings and sellerProfile). |
country | string | optional | Market centre used when latitude and longitude are empty. |
latitude | number | optional | Optional search centre latitude. Leave empty to use the country centre. |
longitude | number | optional | Optional search centre longitude. Leave empty to use the country centre. |
category | string | optional | Top-level Wallapop category (mode=search). |
subcategory | string | optional | Optional subcategory. It can be used alone or together with a category (mode=search). |
orderBy | string | optional | Result order (mode=search). |
minPrice | integer | optional | Minimum asking price (mode=search). |
maxPrice | integer | optional | Maximum asking price (mode=search). |
condition | string | optional | Item condition (mode=search). |
timeFilter | string | optional | Only listings posted within this window (mode=search). |
shippableOnly | boolean | optional | Only listings whose seller allows shipping (mode=search). |
distanceKm | integer | optional | Maximum distance from the search centre. Leave empty to use the market default. |
includeItemDetails | boolean | optional | Fetch full item details such as condition, attributes, views, favorites and conversations (mode=search and sellerListings). |
includeSellerDetails | boolean | optional | Add seller name, rating, review count and verification to each search result (mode=search). |
includeReviews | boolean | optional | Include the seller's latest reviews (mode=sellerProfile). |
maxReviews | integer | optional | Maximum reviews per seller (mode=sellerProfile). Wallapop serves older reviews in pages. |
maxItems | integer | optional | Maximum records to return for search, itemDetails and sellerListings. |
Download the published input schema
View complete JSON
{
"description": "Search Wallapop listings, fetch items, or read seller catalogues and profiles.",
"properties": {
"category": {
"default": "",
"description": "Top-level Wallapop category (mode=search).",
"editor": "select",
"enum": [
"",
"100",
"14000",
"12800",
"12465",
"200",
"12545",
"16000",
"15000",
"12579",
"17000",
"12900",
"12467",
"13100",
"12463",
"12461",
"18000",
"19000",
"20000",
"21000",
"13200",
"12485"
],
"enumTitles": [
"All categories",
"Cars",
"Motorbike",
"Motors & accessories",
"Fashion & accessories",
"Real Estate",
"Technology and Electronics",
"Cell Phones & Accessories",
"Computers",
"Sports & leisure",
"Bikes",
"Games & Consoles",
"Home & garden",
"Appliances",
"Movies, books & music",
"Baby & child",
"Collectibles & Art",
"Construction",
"Agriculture & industrial",
"Jobs",
"Services",
"Other"
],
"prefill": "",
"title": "Category",
"type": "string"
},
"condition": {
"default": "",
"description": "Item condition (mode=search).",
"editor": "select",
"enum": [
"",
"new",
"in_box",
"un_opened",
"un_worn",
"as_good_as_new",
"good",
"fair",
"has_given_it_all"
],
"enumTitles": [
"Any condition",
"New",
"New in box",
"Unopened",
"Unworn",
"As good as new",
"Good",
"Fair",
"Has given it all"
],
"prefill": "",
"title": "Condition",
"type": "string"
},
"country": {
"default": "ES",
"description": "Market centre used when latitude and longitude are empty.",
"editor": "select",
"enum": [
"ES",
"IT",
"PT",
"FR",
"DE",
"GB",
"CUSTOM"
],
"enumTitles": [
"Spain",
"Italy",
"Portugal",
"France",
"Germany",
"United Kingdom",
"Custom coordinates"
],
"prefill": "ES",
"title": "Country",
"type": "string"
},
"distanceKm": {
"description": "Maximum distance from the search centre. Leave empty to use the market default.",
"maximum": 1000,
"minimum": 1,
"title": "Max distance (km)",
"type": "integer"
},
"includeItemDetails": {
"default": false,
"description": "Fetch full item details such as condition, attributes, views, favorites and conversations (mode=search and sellerListings).",
"prefill": false,
"title": "Include item details",
"type": "boolean"
},
"includeReviews": {
"default": true,
"description": "Include the seller's latest reviews (mode=sellerProfile).",
"prefill": false,
"title": "Include reviews",
"type": "boolean"
},
"includeSellerDetails": {
"default": true,
"description": "Add seller name, rating, review count and verification to each search result (mode=search).",
"prefill": false,
"title": "Include seller details",
"type": "boolean"
},
"itemUrls": {
"default": [],
"description": "Wallapop item URLs or raw item IDs (mode=itemDetails).",
"editor": "stringList",
"prefill": [],
"title": "Item URLs or IDs",
"type": "array"
},
"keywords": {
"default": [
"iphone"
],
"description": "One or more search phrases. Each keyword is searched separately and results are merged without duplicates (mode=search).",
"editor": "stringList",
"prefill": [
"iphone"
],
"title": "Keywords",
"type": "array"
},
"latitude": {
"description": "Optional search centre latitude. Leave empty to use the country centre.",
"maximum": 90,
"minimum": -90,
"title": "Latitude",
"type": "number"
},
"longitude": {
"description": "Optional search centre longitude. Leave empty to use the country centre.",
"maximum": 180,
"minimum": -180,
"title": "Longitude",
"type": "number"
},
"maxItems": {
"default": 20,
"description": "Maximum records to return for search, itemDetails and sellerListings.",
"maximum": 2000,
"minimum": 1,
"prefill": 1,
"title": "Max items",
"type": "integer"
},
"maxPrice": {
"description": "Maximum asking price (mode=search).",
"maximum": 999999,
"minimum": 0,
"title": "Max price (EUR)",
"type": "integer"
},
"maxReviews": {
"default": 20,
"description": "Maximum reviews per seller (mode=sellerProfile). Wallapop serves older reviews in pages.",
"maximum": 2000,
"minimum": 1,
"prefill": 1,
"title": "Max reviews",
"type": "integer"
},
"minPrice": {
"description": "Minimum asking price (mode=search).",
"maximum": 999999,
"minimum": 0,
"title": "Min price (EUR)",
"type": "integer"
},
"mode": {
"default": "search",
"description": "What to fetch from Wallapop.",
"editor": "select",
"enum": [
"search",
"itemDetails",
"sellerListings",
"sellerProfile"
],
"enumTitles": [
"Search listings by keyword or category",
"Fetch items by URL or ID",
"Get all active listings from sellers",
"Get seller profile, ratings and reviews"
],
"prefill": "search",
"title": "Mode",
"type": "string"
},
"orderBy": {
"default": "most_relevance",
"description": "Result order (mode=search).",
"editor": "select",
"enum": [
"most_relevance",
"newest",
"closest",
"price_low_to_high",
"price_high_to_low"
],
"enumTitles": [
"Most relevant",
"Newest first",
"Nearest first",
"Price: low to high",
"Price: high to low"
],
"prefill": "most_relevance",
"title": "Sort order",
"type": "string"
},
"sellerIds": {
"default": [],
"description": "Seller IDs, profile URLs or item URLs whose seller should be used (mode=sellerListings and sellerProfile).",
"editor": "stringList",
"prefill": [],
"title": "Seller IDs or URLs",
"type": "array"
},
"shippableOnly": {
"default": false,
"description": "Only listings whose seller allows shipping (mode=search).",
"prefill": false,
"title": "Shippable only",
"type": "boolean"
},
"subcategory": {
"default": "",
"description": "Optional subcategory. It can be used alone or together with a category (mode=search).",
"editor": "select",
"enum": [
"",
"10167",
"10164",
"10165",
"10168",
"10166",
"11002",
"11003",
"10436",
"10156",
"10437",
"10094",
"10101",
"10096",
"10097",
"10099",
"10095",
"10102",
"10105",
"10100",
"10107",
"10106",
"10098",
"10103",
"10108",
"10109",
"10104",
"10055",
"10058",
"10056",
"10059",
"10057",
"10125",
"10119",
"10120",
"10122",
"10123",
"10124",
"24276",
"10118",
"10111",
"10112",
"10114",
"10113",
"10115",
"10441",
"24003",
"24002",
"24001",
"10178",
"10185",
"10181",
"10177",
"10187",
"10183",
"10182",
"10189",
"10179",
"10188",
"10180",
"10184",
"10186",
"10071",
"10075",
"10081",
"10073",
"10074",
"10072",
"10080",
"10079",
"10083",
"10085",
"10076",
"10078",
"10082",
"10077",
"10086",
"10084",
"10138",
"10149",
"10141",
"10147",
"10143",
"10142",
"10148",
"10144",
"10145",
"10146",
"10128",
"10129",
"10117",
"10116",
"10191",
"10190",
"10195",
"10196",
"10192",
"10194",
"10197",
"10193"
],
"enumTitles": [
"All subcategories",
"Motors & accessories → Car & van spare parts",
"Motors & accessories → GPS & electronics",
"Motors & accessories → Mechanical tools",
"Motors & accessories → Motorbike and four-wheeler spare parts",
"Motors & accessories → Others",
"Fashion & accessories → Women",
"Fashion & accessories → Men",
"Fashion & accessories → Accessories",
"Fashion & accessories → Jewellery",
"Fashion & accessories → Beauty",
"Sports & leisure → Basketball",
"Sports & leisure → Crafts Arts & crafts",
"Sports & leisure → Exercise bikes",
"Sports & leisure → Fitness, running & yoga",
"Sports & leisure → Golf",
"Sports & leisure → Handball",
"Sports & leisure → Mountain & ski",
"Sports & leisure → Others sports",
"Sports & leisure → Recreational & board games",
"Sports & leisure → Rugby",
"Sports & leisure → Scooters & skating",
"Sports & leisure → Soccer",
"Sports & leisure → Swimming & pool accessories",
"Sports & leisure → Tennis & paddle tennis",
"Sports & leisure → Volleyball",
"Sports & leisure → Others",
"Bikes → Bike accessories",
"Bikes → Bike components & spare parts",
"Bikes → Bikes & tricycles",
"Bikes → Protective gear & clothing",
"Bikes → Others",
"Home & garden → Furniture and organization",
"Home & garden → Bathroom and accessories",
"Home & garden → Kitchen",
"Home & garden → Decoration and mirrors",
"Home & garden → Lighting",
"Home & garden → Garden and outdoors",
"Home & garden → Heating and air conditioning",
"Home & garden → Pet supplies",
"Appliances → Kitchen appliances",
"Appliances → Laundry & ironing",
"Appliances → Replacement parts",
"Appliances → Small appliances",
"Appliances → Vitroceramic hobs",
"Appliances → Others",
"Movies, books & music → Books, comics & magazines",
"Movies, books & music → Movies & series",
"Movies, books & music → Music",
"Baby & child → Baby feeding",
"Baby & child → Baby furniture",
"Baby & child → Baby transport",
"Baby & child → Bath accessories",
"Baby & child → Children's clothes",
"Baby & child → Children's costumes",
"Baby & child → Cots & beds",
"Baby & child → High chairs & baby walkers",
"Baby & child → Maternity",
"Baby & child → Safety & care",
"Baby & child → School supplies",
"Baby & child → Toys, games & teddies",
"Baby & child → Others",
"Collectibles & Art → Antiques",
"Collectibles & Art → Cars & motorbikes",
"Collectibles & Art → Coins & bills",
"Collectibles & Art → Desk supplies",
"Collectibles & Art → Flags",
"Collectibles & Art → Handcrafts & decoration",
"Collectibles & Art → Key holders",
"Collectibles & Art → Magnets",
"Collectibles & Art → Playing cards",
"Collectibles & Art → Postcards & souvenirs",
"Collectibles & Art → Sporting collectibles",
"Collectibles & Art → Stamp collecting",
"Collectibles & Art → Toy collecting",
"Collectibles & Art → Wartime collectibles",
"Collectibles & Art → Watches",
"Collectibles & Art → Others",
"Construction → Balconies",
"Construction → Doors & windows",
"Construction → Electricity & home lighting",
"Construction → Flooring & paving",
"Construction → Hardware",
"Construction → Ladder & scaffoldings",
"Construction → Paints & varnishes",
"Construction → Tools & machinery",
"Construction → Wood & other materials",
"Construction → Others",
"Agriculture & industrial → Agriculture & farming",
"Agriculture & industrial → Industry",
"Jobs → Job offers",
"Jobs → Job seeking",
"Services → Carers & babysitters",
"Services → Classes & lessons",
"Services → Cleaning services",
"Services → Housework services",
"Services → Moving & transport",
"Services → Repairs",
"Services → Therapies & personal growth",
"Services → Others"
],
"prefill": "",
"title": "Subcategory",
"type": "string"
},
"timeFilter": {
"default": "",
"description": "Only listings posted within this window (mode=search).",
"editor": "select",
"enum": [
"",
"today",
"lastWeek",
"lastMonth"
],
"enumTitles": [
"Any time",
"Today",
"Last 7 days",
"Last 30 days"
],
"prefill": "",
"title": "Posted within",
"type": "string"
}
},
"required": [
"mode"
],
"schemaVersion": 1,
"title": "Wallapop Scraper Input",
"type": "object"
}
Output schema
Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.
| Field | Type | Required | Description |
|---|---|---|---|
listings | string | optional | Dataset containing all scraped Wallapop listings. |
Download the published output schema
View complete JSON
{
"actorOutputSchemaVersion": 1,
"description": "Wallapop listings and seller profiles with prices, condition, images, location, shipping, engagement counts and seller reputation.",
"properties": {
"listings": {
"description": "Dataset containing all scraped Wallapop listings.",
"template": "{{links.apiDefaultDatasetUrl}}/items",
"title": "Wallapop listings",
"type": "string"
}
},
"title": "Wallapop Listings by Keyword, Item & Seller Output"
}
Dataset schema
Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.
Download the published dataset schema
View complete JSON
{
"actorSpecification": 1,
"views": {
"overview": {
"display": {
"component": "table",
"properties": {}
},
"title": "Wallapop Listings",
"transformation": {
"fields": [
"title",
"price",
"currency",
"condition",
"city",
"country",
"seller",
"views",
"itemUrl"
]
}
}
}
}
Key-value schema
Published key-value store definitions, when provided by this build.
This definition is not present in the default published build. See the published README for available documentation.
Published README
Read the full published documentation
Wallapop Listings by Keyword, Item & Seller
Scrape Wallapop — the large second-hand marketplace in Spain, Italy and Portugal. Search by keyword or category, look up an item by its URL or ID, pull every active listing from a seller, or read a seller's profile, ratings and reviews. The actor returns prices, condition, photos, location, shipping, engagement counts and seller reputation as clean JSON. No login, no cookies, no API key, and no proxy setup.
What this actor does
- Four modes:
search,itemDetails,sellerListings,sellerProfile. - Search by keyword or category: multiple keywords, all 21 Wallapop categories and 99 subcategories, with price, condition, posting-date, shipping, distance and sort filters.
- Market-aware: Spain, Italy, Portugal, France, Germany and the United Kingdom by coordinates, with EUR prices and country-local listings.
- Item lookup by URL or ID: full item detail including condition, attributes, images, reserves/sold status, views, favourites and conversations.
- Seller tools: every active listing from one or more sellers, plus profile stats, rating breakdown, public contact details, business legal data and recent reviews.
- Empty fields are omitted: a missing value is never returned as
null,""or[].
Output per listing
Every listing record has recordType: "listing".
itemId,title,description,itemUrl,webSlugprice,currency,financedPricecondition,conditionTextcategoryId,categoryName,categoryPathbrand,model,attributes— Wallapop's structured item attributesimageUrl,imageUrlscity,country,postalCode,region,latitude,longitude,locationApproximatedistanceM— distance from the search centre, in metres (search mode)publishedDate,modifiedDate— legacy Unix timestamps, when Wallapop provides thempublishedAt,modifiedAt— ISO 8601 versionsreserved,sold,expired,onHold,bumped,bumpTypeisRefurbished,hasWarrantyshippable,shippingAllowedviews,favorites,conversationsseller,sellerId,sellerRating,sellerReviewCount,sellerVerified,sellerType,sellerIsTopProfile,sellerProfileUrl,sellerRegisteredAtsellerContact— public address, phone, website and opening hours (business/pro sellers only)sellerLegal— public legal name, email, registration number and registry (business sellers only)scrapedAt
Which optional fields appear depends on the mode and on what Wallapop publishes:
searchincludes location, dates, reserve/shipping flags and taxonomy out of the box. Condition, attributes, views, favourites and conversations require Include item details. Seller name, rating and verification require Include seller details.itemDetailsincludes condition, attributes, flags, views, favourites, conversations and seller reputation.publishedDate/publishedAtare not available for a single item.sellerListingsincludes condition, attributes, shipping, refurbished/warranty and seller fields. Location, dates, views and favourites require Include item details; published date is not available in this mode.
Output per seller profile
sellerProfile returns one record per seller with recordType: "seller".
sellerId,sellerName,sellerWebSlug,sellerProfileUrlsellerType,sellerVerified,sellerIsTopProfile,sellerIsFeatured,sellerBadgeavatarUrl,registeredAt,sellerDescriptionrating,reviewCount,ratingBreakdownresponseRate,scoringStars,activityLevel,validationsactiveListings,soldCount,purchases,sales,reportsReceived,successfulShipmentscity,country,postalCode,latitude,longitudewebsite,phone,address,openingHourslegalName,legalEmail,registrationNumber,registryName,selfCertificationreviews[]— reviews up tomaxReviews(1–2000), newest firstscrapedAt
Input
| Field | Type | Default | Description |
|---|---|---|---|
mode |
string | search |
search, itemDetails, sellerListings or sellerProfile |
keywords |
array | ["iphone"] |
Search phrases; each is searched and results are merged without duplicates (mode=search) |
itemUrls |
array | – | Wallapop item URLs or alphanumeric item IDs such as wzvg1nvq81zl; the numeric suffix at the end of an item URL is not an item ID (mode=itemDetails) |
sellerIds |
array | – | Seller IDs, profile URLs or item URLs (mode=sellerListings / sellerProfile) |
country |
string | ES |
Market centre: ES, IT, PT, FR, DE, GB or Custom coordinates |
latitude |
number | – | Optional search centre latitude |
longitude |
number | – | Optional search centre longitude |
category |
string | all | One of Wallapop's 21 top-level categories |
subcategory |
string | all | One of the 99 subcategories; can be used alone |
orderBy |
string | most_relevance |
Relevance, newest, nearest, price low-to-high or price high-to-low |
minPrice |
integer | – | Minimum asking price in EUR |
maxPrice |
integer | – | Maximum asking price in EUR |
condition |
string | any | New, new in box, unopened, unworn, as good as new, good, fair or has given it all |
timeFilter |
string | any | Today, last 7 days or last 30 days |
shippableOnly |
boolean | false |
Only listings whose seller allows shipping |
distanceKm |
integer | – | Maximum distance from the search centre (1–1000 km) |
includeItemDetails |
boolean | false |
Add condition, attributes, views, favourites and conversations to listings |
includeSellerDetails |
boolean | true |
Add seller name, rating, review count and verification to search results |
includeReviews |
boolean | true |
Include recent reviews in seller profiles |
maxReviews |
integer | 20 |
Maximum reviews per seller (1–2000); fetched in pages of 40 |
maxItems |
integer | 20 |
Maximum records for search, itemDetails, sellerListings and sellerProfile (1–2000) |
Example: keyword search in Madrid
{
"mode": "search",
"keywords": ["iphone 14", "iphone 15"],
"country": "ES",
"orderBy": "newest",
"minPrice": 200,
"maxPrice": 700,
"condition": "good",
"includeItemDetails": true,
"maxItems": 50
}
Example: Italian category with a radius
{
"mode": "search",
"country": "IT",
"category": "12465",
"orderBy": "closest",
"distanceKm": 50,
"shippableOnly": true,
"maxItems": 100
}
Example: one item by URL
{
"mode": "itemDetails",
"itemUrls": ["https://es.wallapop.com/item/iphone-11-64gb-rojo-1315331517"]
}
Example: a seller's catalogue and profile
{
"mode": "sellerListings",
"sellerIds": ["https://es.wallapop.com/user/santiagob-407326113"],
"includeItemDetails": true,
"maxItems": 200
}
{
"mode": "sellerProfile",
"sellerIds": ["pj9ygg2gvv6e"],
"includeReviews": true,
"maxReviews": 20
}
Use cases
- Price research: compare asking prices for the same product across Spanish, Italian and Portuguese cities.
- Resale sourcing: follow a category with a price cap and spot under-priced listings early.
- Seller vetting: read seller ratings, review history and public business details before buying.
- Catalogue monitoring: export a shop's full active inventory to a spreadsheet on a schedule.
- Demand analysis: rank listings by views, favourites and conversations.
- Marketplace analytics: build a clean dataset of condition, attributes and geography.
Limitations
publishedDateis available in keyword/category search only. Wallapop does not expose a creation date on item or seller endpoints, so those modes omit it.- Seller contact details and business legal data are returned only when the seller has made them public (business, shop or pro accounts).
- Reviews are fetched newest-first in pages of 40 until
maxReviews(default 20, maximum 2,000) or the source stops. Verified full collections of 411/411, 1,226/1,226 and 1,714/1,714 reviews for sellers of those sizes; the practical ceiling is the seller's public review count. sellerListingsreturns active listings only. Sold items are not searchable; an item URL that is already sold still works throughitemDetails.- Nearest uses Wallapop's proximity ranking; the source does not guarantee a strict distance
order. Sort on
distanceMif you need exact ordering. categoryIdis Wallapop's top-level taxonomy id, whilecategoryNameis the leaf name andcategoryPathis the full hierarchy. Names follow the source locale.- Italy and Portugal have smaller catalogues. For the largest local result set use Most relevant or Nearest, and a distance that matches the country.
FAQ
Do I need a Wallapop account, cookies or an API key? No. The actor reads publicly accessible listing and seller data without authentication.
Do I need to configure a proxy? No. The actor connects directly to Wallapop; no proxy configuration is required.
Which countries are supported? Spain, Italy and Portugal are the primary markets. France, Germany and the United Kingdom also return local listings when you choose their country or supply coordinates; inventory there is much smaller.
Why are some fields missing from a record?
Wallapop omits data for some listings, and some fields are mode-specific. Empty fields are left out
rather than returned as null. Turn on Include item details for condition, attributes, views and
favourites.
Why did I get fewer rows than maxItems?
Wallapop exhausted the matching results, or the country filter removed cross-border listings. The
run status reports the requested and returned counts honestly. The actor never fabricates rows.
Can I get sold items?
Only if you already have the item URL. Keyword and category search return active listings, and
seller catalogues return active listings. itemDetails reports sold: true when Wallapop marks the
item sold.
How many reviews can I get?
The actor fetches reviews newest-first in pages of 40 until maxReviews is reached or Wallapop
has no older reviews. Set maxReviews up to 2,000. The run status reports a shortfall if the
source stops earlier.
How fresh is the data? Every run reads the live marketplace. Values reflect Wallapop at the moment of collection.
Is this affiliated with Wallapop? No. This is an independent third-party actor using publicly accessible marketplace data.
Python quickstart
Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.
Source build YTSKoUyzDC7iXiO8P. Documentation is regenerated from the default published build; private drafts are not included.