{
"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": "jwQvQRyJHjJhW0z4n"
},
"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."
},
"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. Defaults to Madrid.",
"default": 40.4168
},
"longitude": {
"title": "Longitude",
"type": "number",
"description": "Paired with \"Latitude\". Defaults to Madrid.",
"default": -3.7038
},
"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
}
}
}
}
}
}
}
}
}
}