{ "openapi": "3.0.1", "info": { "title": "Wallapop Scraper | Spain Listings & Sellers", "description": "Collect public Wallapop listings in Spain by keyword or category and postal code or town. Get prices, images, locations and shipping information, with optional item details and seller ratings. Apply price, distance and condition filters, then export JSON, CSV or Excel.", "version": "0.1", "x-build-id": "ZkwHGxpQdHm7LcB1c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datascraperes~wallapop-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datascraperes-wallapop-marketplace-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/datascraperes~wallapop-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-datascraperes-wallapop-marketplace-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/datascraperes~wallapop-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-datascraperes-wallapop-marketplace-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": "Keywords", "maxLength": 120, "type": "string", "description": "What to search for, for example bicicleta, iPhone 14 or sofá. Leave empty when you search by category ID." }, "location": { "title": "Location", "minLength": 1, "maxLength": 120, "type": "string", "description": "Spanish postal code or town, for example 28001, Tarragona or Mojácar. It is geocoded at run time." }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of new listings to save for this search." }, "distanceKm": { "title": "Radius (km)", "minimum": 0, "maximum": 500, "type": "integer", "description": "Search radius around the city centre, from 0 to 500 km." }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Optional minimum sale price in euros." }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Optional maximum sale price in euros." }, "condition": { "title": "Condition", "enum": [ "", "new", "as_good_as_new", "good", "fair", "has_given_it_all" ], "type": "string", "description": "Optional item condition filter." }, "orderBy": { "title": "Sort order", "enum": [ "most_relevance", "closest", "price_low_to_high", "price_high_to_low", "newest" ], "type": "string", "description": "Result order for this search." }, "shippableOnly": { "title": "Shippable items only", "type": "boolean", "description": "When enabled, only listings that can be shipped are returned." }, "categoryId": { "title": "Category ID", "maxLength": 12, "type": "string", "description": "Optional Wallapop category ID, for example 100 for cars, 200 for real estate or 13100 for heating and climate. Required when keywords are empty." }, "subcategoryIds": { "title": "Subcategory IDs", "maxLength": 120, "type": "string", "description": "Optional comma-separated subcategory IDs used together with the category ID." }, "includeItemDetails": { "title": "Include item details", "type": "boolean", "description": "Fetch each listing detail page to add condition, view/favourite counters, hashtags and the public share URL. This makes one extra request per listing.", "default": false }, "includeSellerDetails": { "title": "Include seller details", "type": "boolean", "description": "Fetch the public seller profile, rating and validation badges for each unique seller. Adds up to three requests per seller, cached per run.", "default": false }, "language": { "title": "Language", "enum": [ "es-ES", "en-US" ], "type": "string", "description": "Language used for category and condition names returned by the public API.", "default": "es-ES" }, "searches": { "title": "Multiple searches", "minItems": 0, "maxItems": 20, "type": "array", "description": "Optional advanced list of up to 20 searches. Each search uses its own keywords or category, location and filters. When non-empty, this list replaces the single-search fields above; it never adds an extra search.", "items": { "type": "object", "additionalProperties": false, "properties": { "keywords": { "title": "Keywords", "type": "string", "description": "What to search for, for example bicicleta, iPhone 14 or sofá. Leave empty when you search by category ID.", "editor": "textfield", "maxLength": 120 }, "location": { "title": "Location", "type": "string", "description": "Spanish postal code or town, for example 28001, Tarragona or Mojácar. It is geocoded at run time.", "editor": "textfield", "minLength": 1, "maxLength": 120 }, "distanceKm": { "title": "Radius (km)", "type": "integer", "description": "Search radius around the city centre, from 0 to 500 km.", "default": 50, "minimum": 0, "maximum": 500 }, "categoryId": { "title": "Category ID", "type": "string", "description": "Optional Wallapop category ID, for example 100 for cars, 200 for real estate or 13100 for heating and climate. Required when keywords are empty.", "editor": "textfield", "maxLength": 12 }, "subcategoryIds": { "title": "Subcategory IDs", "type": "string", "description": "Optional comma-separated subcategory IDs used together with the category ID.", "editor": "textfield", "maxLength": 120 }, "minPrice": { "title": "Minimum price (EUR)", "type": "integer", "description": "Optional minimum sale price in euros.", "minimum": 0 }, "maxPrice": { "title": "Maximum price (EUR)", "type": "integer", "description": "Optional maximum sale price in euros.", "minimum": 0 }, "condition": { "title": "Condition", "type": "string", "description": "Optional item condition filter.", "editor": "select", "enum": [ "", "new", "as_good_as_new", "good", "fair", "has_given_it_all" ], "enumTitles": [ "Any condition", "New", "As good as new", "Good", "Fair", "Has given it all" ] }, "shippableOnly": { "title": "Shippable items only", "type": "boolean", "description": "When enabled, only listings that can be shipped are returned.", "default": false }, "orderBy": { "title": "Sort order", "type": "string", "description": "Result order for this search.", "editor": "select", "default": "most_relevance", "enum": [ "most_relevance", "closest", "price_low_to_high", "price_high_to_low", "newest" ], "enumTitles": [ "Most relevant", "Closest first", "Price: low to high", "Price: high to low", "Newest first" ] }, "maxItems": { "title": "Maximum items", "type": "integer", "description": "Maximum number of new listings to save for this search.", "default": 100, "minimum": 1, "maximum": 2000 } } } } } }, "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 } } } } } } } } } }