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