{
"openapi": "3.0.1",
"info": {
"title": "Wallapop Cars Scraper — Spain Classifieds",
"description": "Scrape car listings from Wallapop, Spain's largest classifieds marketplace. Extract price, mileage, year, location, seller info, and photos for every listing. Filter by brand, model, price range, and region. Ideal for market research, price comparison, and automotive analytics in Spain.",
"version": "0.1",
"x-build-id": "lFdGKxnxE7t1q5Jbn"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/rastriq~wallapop-cars-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-rastriq-wallapop-cars-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/rastriq~wallapop-cars-scraper/runs": {
"post": {
"operationId": "runs-sync-rastriq-wallapop-cars-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/rastriq~wallapop-cars-scraper/run-sync": {
"post": {
"operationId": "run-sync-rastriq-wallapop-cars-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",
"required": [
"proxyConfiguration"
],
"properties": {
"keywords": {
"title": "🔍 Search keywords",
"type": "string",
"description": "Free-text search across make, model and trim. Examples: \"BMW Serie 3\", \"Subaru Outback\", \"Seat Leon FR\". Leave empty to browse the full car category."
},
"location": {
"title": "📍 Search center",
"enum": [
"madrid",
"barcelona",
"valencia",
"sevilla",
"bilbao",
"malaga",
"zaragoza"
],
"type": "string",
"description": "City used as the geographic center of the search.",
"default": "madrid"
},
"minYear": {
"title": "📅 Minimum registration year",
"minimum": 1950,
"maximum": 2030,
"type": "integer",
"description": "Only return listings registered in this year or later. Leave blank for no lower bound."
},
"maxYear": {
"title": "📅 Maximum registration year",
"minimum": 1950,
"maximum": 2030,
"type": "integer",
"description": "Only return listings registered in this year or earlier. Leave blank for no upper bound."
},
"minPrice": {
"title": "💰 Minimum price (EUR)",
"minimum": 0,
"type": "integer",
"description": "Only return listings priced at or above this amount. Leave blank for no lower bound."
},
"maxPrice": {
"title": "💰 Maximum price (EUR)",
"minimum": 0,
"type": "integer",
"description": "Only return listings priced at or below this amount. Leave blank for no upper bound."
},
"engine": {
"title": "⛽ Fuel type",
"enum": [
"gasoline",
"gasoil",
"electric-hybrid",
"hybride",
"hybride_plugin",
"lpg"
],
"type": "string",
"description": "Filter by engine fuel. Leave blank to include all fuel types."
},
"gearbox": {
"title": "⚙️ Gearbox",
"enum": [
"manual",
"automatic",
"semiautomatic"
],
"type": "string",
"description": "Filter by transmission type. Leave blank to include all gearboxes."
},
"sellerType": {
"title": "🏪 Seller type",
"enum": [
"private",
"professional"
],
"type": "string",
"description": "Filter by seller type. Leave blank to include both private and professional sellers."
},
"orderBy": {
"title": "↕️ Sort order",
"enum": [
"most_relevance",
"newest",
"price_low_to_high",
"price_high_to_low",
"closest"
],
"type": "string",
"description": "How results are ordered.",
"default": "most_relevance"
},
"maxItems": {
"title": "🔢 Maximum results",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Hard cap on the number of listings returned. The default of 50 finishes in well under a minute. Raise it for full exports — 500 items takes roughly 1 minute, 5 000 items takes roughly 5–8 minutes.",
"default": 50
},
"proxyConfiguration": {
"title": "🛡️ Proxy configuration",
"type": "object",
"description": "Apify residential proxy in Spain is required for reliable access to Wallapop's API."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}