{ "openapi": "3.0.1", "info": { "title": "Wallapop New Listings Alert (Spain, Italy, Portugal)", "description": "Newest Wallapop listings for a keyword or category near a city in Spain, Italy or Portugal, one flat row each: title, price in EUR, previous price, location, shipping, photos, item URL - and whether each listing is new, cheaper or dearer than on the last run.", "version": "0.1", "x-build-id": "aM9iohKeFAGX128oZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~wallapop-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-wallapop-listings", "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/superslowsloth~wallapop-listings/runs": { "post": { "operationId": "runs-sync-superslowsloth-wallapop-listings", "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/superslowsloth~wallapop-listings/run-sync": { "post": { "operationId": "run-sync-superslowsloth-wallapop-listings", "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": { "keyword": { "title": "Search keyword", "type": "string", "description": "What you would type into Wallapop's search box, in any language. Leave empty only if you search by category id instead." }, "city": { "title": "City", "enum": [ "madrid", "barcelona", "valencia", "sevilla", "malaga", "bilbao", "zaragoza", "milano", "roma", "torino", "napoli", "lisboa", "porto" ], "type": "string", "description": "Where to search from. Spanish cities search all of Spain unless you set a radius. Italian and Portuguese cities default to a 50 km radius: without one, Wallapop ignores the country and returns Spanish listings (measured 2026-10-05 - Milan and Lisbon both returned 40 of 40 Spanish listings). Ignored when you give latitude and longitude.", "default": "madrid" }, "latitude": { "title": "Latitude", "pattern": "^-?[0-9]{1,2}(\\.[0-9]+)?$", "type": "string", "description": "Search from exactly here instead of a city, written as text such as 40.4168 (via the API, send a string, not a JSON number). Give longitude too. Outside Spain, also set a radius - see City." }, "longitude": { "title": "Longitude", "pattern": "^-?[0-9]{1,3}(\\.[0-9]+)?$", "type": "string", "description": "Search from exactly here instead of a city, written as text such as -3.7038. Give latitude too." }, "distanceKm": { "title": "Radius (km)", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Only listings within this many kilometres of the location. Leave empty for Wallapop's default: country-wide for a Spanish location, 50 km for an Italian or Portuguese city preset." }, "categoryId": { "title": "Category id", "minimum": 1, "type": "integer", "description": "One Wallapop category id, such as 24200 (Technology & electronics) or 12465 (Fashion & accessories). Every row carries its category_id, so a first run tells you the id to use here. Leave empty for any category." }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Lowest asking price to return, in whole euros. Leave empty for no lower bound." }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Highest asking price to return, in whole euros. Leave empty for no upper bound." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many listings. Wallapop serves 40 per request, newest first.", "default": 100 }, "changesOnly": { "title": "Only new and re-priced listings", "type": "boolean", "description": "Return (and charge for) only listings that are new, or whose price changed while still among the newest listings read, since the last run of this same search; unchanged ones are skipped and cost nothing. The memory is per search (keyword, location, radius, category, price band). The FIRST run has nothing to compare against, so it labels every listing new and returns them all.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxy is the default and is what this actor was measured on: Wallapop's API answered Apify datacenter exits with HTTP 200 on 2026-10-05. A proxy is what lets a refused request be retried from a fresh address.", "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 }, "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 } } } } } } } } } }