{ "openapi": "3.0.1", "info": { "title": "Wallapop Cars Scraper β€” Used Cars & Vans in Spain", "description": "Scrape used car and van listings from Wallapop Spain: price, mileage, year, fuel, gearbox, city and photos. Filter by brand, model, price, year or city. Incremental mode returns only new or changed listings. No login or API key. $1 per 1,000 listings.", "version": "0.6", "x-build-id": "xaezAVzTl29CEhnAh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rastriq~wallapop-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rastriq-wallapop-cars-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/rastriq~wallapop-cars-scraper/runs": { "post": { "operationId": "runs-sync-rastriq-wallapop-cars-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/rastriq~wallapop-cars-scraper/run-sync": { "post": { "operationId": "run-sync-rastriq-wallapop-cars-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "πŸ” Search keywords", "type": "string", "description": "Free-text search across make, model and trim.
Examples: BMW Serie 3, Subaru Outback, Seat Leon FR.
Vans work too: furgoneta, Renault Trafic. Leave empty to browse the full car category." }, "vehicleCategory": { "title": "πŸš— Vehicle category", "enum": [ "cars", "motorbikes" ], "type": "string", "description": "What to search. Cars (default) also covers vans β€” use keywords such as furgoneta. Motorbikes searches Wallapop's motorbike category (brand/model/year/km are filled when Wallapop provides them).", "default": "cars" }, "maxItems": { "title": "πŸ“Š Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap on the number of listings returned.
The default of 50 finishes in under a minute. Raise it for full exports β€” 500 items β‰ˆ 1 min, 5 000 items β‰ˆ 5–8 min.
For nationwide ingestion with orderBy: newest, set 50 000+ to capture all daily activity.", "default": 50 }, "location": { "title": "πŸ“ Search center", "enum": [ "espana", "madrid", "barcelona", "valencia", "sevilla", "bilbao", "malaga", "zaragoza" ], "type": "string", "description": "City used as the geographic center of the search. Ignored when Custom latitude and Custom longitude are both set.", "default": "madrid" }, "minPrice": { "title": "πŸ’Ά Min price (€)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this amount." }, "maxPrice": { "title": "πŸ’Ά Max price (€)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this amount." }, "minYear": { "title": "πŸ“… Min year", "minimum": 1950, "maximum": 2030, "type": "integer", "description": "Oldest registration year to include." }, "maxYear": { "title": "πŸ“… Max year", "minimum": 1950, "maximum": 2030, "type": "integer", "description": "Newest registration year to include." }, "engine": { "title": "β›½ Fuel type", "enum": [ "gasoline", "gasoil", "electric-hybrid", "hybride", "hybride_plugin", "lpg" ], "type": "string", "description": "Filter by engine fuel type." }, "gearbox": { "title": "βš™οΈ Gearbox", "enum": [ "manual", "automatic", "semiautomatic" ], "type": "string", "description": "Filter by transmission type." }, "sellerType": { "title": "πŸ‘€ Seller type", "enum": [ "private", "professional" ], "type": "string", "description": "Filter by seller profile.
When used with enableCursor, each seller type gets its own independent cursor β€” so you can run parallel private and professional streams without interference.

Note: the output field seller_type stays empty in listing rows (Wallapop's search does not return it). This filter works server-side; use Seller profiles to identify dealers." }, "orderBy": { "title": "πŸ“Ά Sort order", "enum": [ "most_relevance", "newest", "price_low_to_high", "price_high_to_low", "closest" ], "type": "string", "description": "How results are ordered.
Newest first returns listings from all of Spain sorted by date β€” ideal for continuous nationwide ingestion.
Closest fans out from the search center by proximity β€” ideal for geographic snapshots.", "default": "most_relevance" }, "distanceKm": { "title": "πŸ“ Search radius (km)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum distance in km from the search center.
Only applies when orderBy is set to Closest.
Leave empty for no radius limit.
Example: 50 β†’ only listings within 50 km of the search center." }, "geoStopPostalPrefix": { "title": "πŸ—ΊοΈ Geographic stop β€” postal prefix", "type": "string", "description": "Optional. Stop the sweep once it leaves this postal area. Example: 48 for Bizkaia.

Wallapop honours distanceKm as a hard cut, but a circle is not a province: a 65 km disc around Bilbao also contains Álava, half of Gipuzkoa and part of Cantabria. With orderBy=closest the sweep works outward, so once several consecutive pages sit outside the prefix there is nothing left to find inside it.

Leave empty to disable. Listings with no postal code are never counted as outside." }, "geoStopThreshold": { "title": "πŸ“ Drift threshold", "minimum": 0.1, "maximum": 1, "type": "number", "description": "Fraction of a page outside the prefix for that page to count as drift.", "default": 0.5 }, "geoStopPages": { "title": "πŸ“„ Consecutive drift pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Consecutive drift pages before stopping. The streak resets if a page comes back inside, so a single border page cannot end the sweep.", "default": 3 }, "timeFilter": { "title": "πŸ• Time filter", "enum": [ "today", "lastWeek" ], "type": "string", "description": "Restrict results by when a listing was last MODIFIED β€” not when it was published.

Measured against the live API: with today, only 8 of 318 results had gone more than 24 h without a modification, versus 317 of 320 unfiltered. So the filter works β€” but it works on modified_at.

What that means in practice:
β€’ A listing published two years ago and edited this morning is returned by today. We measured one 786 days old.
β€’ A listing published yesterday and untouched since is not.

Do not use this to capture new supply. These feeds bump and re-index constantly, so recency of modification says little about recency of publication. Use incremental mode (enableCursor) for that β€” the ledger is what distinguishes a genuinely new listing from one that merely moved.

Where it does help: sweeping for recent activity β€” price changes and bumps β€” without scanning the rest of the catalogue.

Note that today, lastWeek and lastMonth returned identical result sets in testing (238 of 238), because the feed is dominated by recently bumped listings. Treat the granularity between values as unreliable." }, "customLatitude": { "title": "🌐 Custom latitude", "minimum": 27, "maximum": 44, "type": "number", "description": "Latitude of your custom search center.
Range: 27.0 (Canarias) to 44.0 (Pyrenees).
Example: 42.84998 β†’ Vitoria-Gasteiz
Example: 28.12357 β†’ Las Palmas de Gran Canaria" }, "customLongitude": { "title": "🌐 Custom longitude", "minimum": -18.2, "maximum": 5, "type": "number", "description": "Longitude to pair with custom latitude.
Range: -18.2 (western Canarias) to 5.0 (Balearics).
Example: -2.67268 β†’ Vitoria-Gasteiz
Example: -15.43620 β†’ Las Palmas de Gran Canaria" }, "maxPages": { "title": "πŸ“‘ Max pages", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Hard cap on search-result pages swept. ~35 listings per page.
Leave at 0 for automatic: enough pages to satisfy Max results in normal mode, or 30 pages (~1 000 listings scanned) in incremental mode, where most listings are skipped as unchanged and more pages must be walked to find the new ones.", "default": 0 }, "enableCursor": { "title": "πŸ”„ Incremental mode (delta engine)", "type": "boolean", "description": "Return only listings that are new or have changed since your last run.
The actor keeps a ledger of every listing id it has already delivered for this search stream, together with a fingerprint of price / km / title / reserved. A listing is returned when its id is unknown (_delta_status: \"new\") or when its fingerprint moved (_delta_status: \"updated\"). Everything else is skipped and not charged.

The ledger makes no assumption about feed ordering or timestamps, so a listing that surfaces late in Wallapop's rotating feed is still captured.

First run: captures a full baseline and seeds the ledger.
Subsequent runs: new and changed listings only.

Use cursorId to keep parallel searches independent.", "default": false }, "cursorId": { "title": "🏷️ Stream id (cursor namespace)", "type": "string", "description": "Optional. Names the ingestion stream this run belongs to. Runs sharing a stream id share one ledger; different ids are fully independent.

Leave empty and the actor derives a stable id from your search filters, which is normally what you want. Set it explicitly when several searches should feed a single catalogue (e.g. catalogue-es), or to force a clean rebuild by using a new value.

Only used when Incremental mode is on." }, "emitSeenIds": { "title": "πŸ“€ Emit seen ids (delisting detection)", "type": "boolean", "description": "Write every listing id observed during the sweep to the run's key-value store under SEEN_IDS β€” including the ones skipped as unchanged.

With delta ingestion your catalogue never expires rows on its own: a vehicle that sells simply stops appearing. Compare SEEN_IDS across runs and mark anything absent for N consecutive sweeps as sold.

No extra cost.", "default": false }, "stripSellerPII": { "title": "πŸ”’ Strip seller personal data (GDPR)", "type": "boolean", "description": "Remove personal data of private sellers from the output.
When enabled: user_id is set to null, coordinates are truncated to ~1 km precision, and phone numbers / emails embedded in descriptions are redacted.

Professional seller data is not affected β€” their details are commercial, not personal.

Enable this for GDPR-compliant pipelines where individual seller identification is not needed.", "default": false }, "sellerProfiles": { "title": "πŸ‘€ Seller profiles (user IDs)", "type": "array", "description": "Leave empty to search car listings (normal mode).

Enter one or more Wallapop seller user_id values (the user_id field of the listing output, e.g. abc123xyz789), one per line. When this list has at least one ID, the actor does not search listings: it fetches the public profile of each account and outputs one record per account with record_type: \"seller_profile\" β€” name, seller type, city, postal code, coordinates, address, website, active listings count, profile URL and registration date.

πŸ”’ Profiles of private (non-professional) accounts are reduced to user_id + is_professional: false β€” no name or location. Unknown IDs return a record with error and do not stop the run.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }