{
"openapi": "3.0.1",
"info": {
"title": "Wallapop Scraper 🇪🇸 (listings, prices, seller info)",
"description": "Scrape Wallapop.com search results into flat JSON: title, price, location and photos, plus demand signals like view and favorite counts. Filter by keyword, category, price band and distance. No API key, one flat price per listing with platform usage included.",
"version": "0.1",
"x-build-id": "Z360IIdgfHEZHXAcD"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~wallapop-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-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/tagadanar~wallapop-scraper/runs": {
"post": {
"operationId": "runs-sync-tagadanar-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/tagadanar~wallapop-scraper/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-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": {
"query": {
"title": "Search terms",
"type": "array",
"description": "One search per entry, exactly what you would type into the Wallapop search box, e.g. iphone 13, bicicleta electrica. Leave empty to browse a single category with \"Category ID\" instead.",
"items": {
"type": "string"
}
},
"categoryId": {
"title": "Category ID",
"type": "integer",
"description": "Restrict the search to one Wallapop category. A few top-level ids: 100 Coches (cars), 14000 Motos, 24200 Tecnologia y electronica, 12465 Moda y accesorios, 200 Inmobiliaria, 12467 Hogar y jardin, 17000 Bicicletas, 13100 Electrodomesticos. Leave empty to search every category."
},
"priceFrom": {
"title": "Price from (EUR)",
"minimum": 0,
"type": "number",
"description": "Lowest price to include, in euros."
},
"priceTo": {
"title": "Price up to (EUR)",
"minimum": 0,
"type": "number",
"description": "Highest price to include, in euros."
},
"country": {
"title": "Country",
"enum": [
"es",
"it",
"pt"
],
"type": "string",
"description": "Which Wallapop market to search. This sets the default search point (Madrid, Rome or Lisbon) and the language the listing titles come back in. Wallapop translates titles to whichever language you ask for, so picking the right country is what keeps an Italian ad reading as Italian.",
"default": "es"
},
"latitude": {
"title": "Latitude",
"type": "number",
"description": "Wallapop ranks and filters results by distance from a point, so this matters even for a nationwide keyword search. Leave empty to use the centre of the country you picked (Madrid, Rome or Lisbon)."
},
"longitude": {
"title": "Longitude",
"type": "number",
"description": "Paired with \"Latitude\". Leave empty to use the centre of the country you picked. Setting a point of your own overrides the country default."
},
"orderBy": {
"title": "Sort by",
"enum": [
"relevance",
"newest",
"price_low_to_high",
"price_high_to_low",
"closest"
],
"type": "string",
"description": "Order of the results, same choices as on the site.",
"default": "relevance"
},
"maxResults": {
"title": "Max listings",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Stop after this many listings across all searches. You are only charged for listings actually delivered.",
"default": 40
},
"includeDetails": {
"title": "Include listing details",
"type": "boolean",
"description": "Fetch each listing's own page for its view count, favorite count and structured specs (brand, model, condition and similar), on top of what the search already returns. One extra request per listing, same price per listing either way.",
"default": false
},
"includeSeller": {
"title": "Include seller info",
"type": "boolean",
"description": "Fetch the seller's public profile for their display name. One extra request per listing, same price per listing either way.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}