{ "openapi": "3.0.1", "info": { "title": "Wallapop Scraper", "description": "Scrape Wallapop second-hand listings by keyword around any location. One row per item: title, price, GPS, postal code, city/region, images, shipping and the full category taxonomy. Target any city by coordinates — no Spanish proxy needed. Optional seller profile + view counters.", "version": "0.1", "x-build-id": "yZ8is5sa8XoiFnZwT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~wallapop-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-wallapop-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/memo23~wallapop-scraper/runs": { "post": { "operationId": "runs-sync-memo23-wallapop-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/memo23~wallapop-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-wallapop-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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "Keywords to search, e.g. `iphone 15`, `bicicleta`, `sofá`. Each keyword is searched around every location below.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Spanish cities to search around. Each keyword runs once per city.", "items": { "type": "string", "enum": [ "madrid", "barcelona", "valencia", "sevilla", "zaragoza", "malaga", "bilbao", "murcia", "palma", "las-palmas", "alicante", "cordoba" ], "enumTitles": [ "Madrid", "Barcelona", "Valencia", "Sevilla", "Zaragoza", "Málaga", "Bilbao", "Murcia", "Palma de Mallorca", "Las Palmas", "Alicante", "Córdoba" ] }, "default": [ "madrid" ] }, "customLatitude": { "title": "Custom latitude", "type": "string", "description": "Exact search origin latitude, e.g. `40.4168`. Use with Custom longitude to target any town — or Wallapop's Italian/Portuguese markets. Added on top of any cities selected above." }, "customLongitude": { "title": "Custom longitude", "type": "string", "description": "Exact search origin longitude, e.g. `-3.7038`." }, "startUrls": { "title": "Wallapop URLs (search or item)", "type": "array", "description": "Paste Wallapop search or item URLs. Search: `https://es.wallapop.com/search?keywords=iphone` · Item: `https://es.wallapop.com/item/iphone-12-256gb-negro-1284244933`", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "scrapeDetails": { "title": "Also fetch each item's detail (seller + counters)", "type": "boolean", "description": "Off (default) returns the feed fields, which already include price, description, GPS, postal code, city, region, images and the category taxonomy. On additionally calls each item's detail endpoint for the seller profile, view/favourite counters and category characteristics. Slower, and billed at the higher Item detail rate.", "default": false }, "maxItems": { "title": "Max items (total)", "minimum": 1, "type": "integer", "description": "Hard cap on rows for the whole run, across every keyword and location.", "default": 1000 }, "maxItemsPerSearch": { "title": "Max items per feed", "minimum": 1, "type": "integer", "description": "Cap per keyword-and-location feed. Wallapop returns 40 items per page.", "default": 1000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Parallel item-detail requests. 8 is a good balance.", "default": 8 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 30, "type": "integer", "description": "Retries per request before giving up.", "default": 6 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Optional. Wallapop does not require Spanish or residential proxies — the search coordinates control the location, not your IP.", "default": { "useApifyProxy": true } } } }, "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 } } }, "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 } } } } } } } } } }