{
"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": "fPEjvjou4GGEzmZ5c"
},
"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",
"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."
},
"maxItems": {
"title": "Max results",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Hard cap on the number of listings returned.
The default of 50 finishes in under a minute. Raise it for full exports — 500 items ≈ 1 min, 5 000 items ≈ 5–8 min.
For nationwide ingestion with orderBy: newest, set 50 000+ to capture all daily activity.",
"default": 50
},
"location": {
"title": "Search center",
"enum": [
"madrid",
"barcelona",
"valencia",
"sevilla",
"bilbao",
"malaga",
"zaragoza"
],
"type": "string",
"description": "City used as the geographic center of the search. Ignored when Custom latitude and Custom longitude are both set.",
"default": "madrid"
},
"minPrice": {
"title": "Min price (€)",
"minimum": 0,
"type": "integer",
"description": "Only return listings priced at or above this amount."
},
"maxPrice": {
"title": "Max price (€)",
"minimum": 0,
"type": "integer",
"description": "Only return listings priced at or below this amount."
},
"minYear": {
"title": "Min year",
"minimum": 1950,
"maximum": 2030,
"type": "integer",
"description": "Oldest registration year to include."
},
"maxYear": {
"title": "Max year",
"minimum": 1950,
"maximum": 2030,
"type": "integer",
"description": "Newest registration year to include."
},
"engine": {
"title": "Fuel type",
"enum": [
"gasoline",
"gasoil",
"electric-hybrid",
"hybride",
"hybride_plugin",
"lpg"
],
"type": "string",
"description": "Filter by engine fuel type."
},
"gearbox": {
"title": "Gearbox",
"enum": [
"manual",
"automatic",
"semiautomatic"
],
"type": "string",
"description": "Filter by transmission type."
},
"sellerType": {
"title": "Seller type",
"enum": [
"private",
"professional"
],
"type": "string",
"description": "Filter by seller profile.
When used with enableCursor, each seller type gets its own independent cursor — so you can run parallel private and professional streams without interference."
},
"orderBy": {
"title": "Sort order",
"enum": [
"most_relevance",
"newest",
"price_low_to_high",
"price_high_to_low",
"closest"
],
"type": "string",
"description": "How results are ordered.
Newest first returns listings from all of Spain sorted by date — ideal for continuous nationwide ingestion.
Closest fans out from the search center by proximity — ideal for geographic snapshots.",
"default": "most_relevance"
},
"distanceKm": {
"title": "Search radius (km)",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Maximum distance in km from the search center.
Only applies when orderBy is set to Closest.
Leave empty for no radius limit.
Example: 50 → only listings within 50 km of the search center."
},
"timeFilter": {
"title": "Time filter",
"enum": [
"today",
"lastWeek"
],
"type": "string",
"description": "Restrict results to a recent time window.
Today returns listings created or modified today.
Last week covers the last 7 days.
Leave empty for no time restriction."
},
"enableCursor": {
"title": "Incremental mode (cursor)",
"type": "boolean",
"description": "Only return listings newer than the last run.
When enabled, the actor stores the most recent modified_at timestamp in a Named KV Store after each run. On the next run, it skips all listings older than that timestamp — so you only pay for genuinely new results.
Requires orderBy: Newest first. Incompatible with timeFilter.
First run: captures all available listings and sets the initial cursor.
Subsequent runs: only new/modified listings since the previous run.",
"default": false
},
"customLatitude": {
"title": "Custom latitude",
"minimum": 27,
"maximum": 44,
"type": "number",
"description": "Latitude of your custom search center.
Range: 27.0 (Canarias) to 44.0 (Pyrenees).
Example: 42.84998 → Vitoria-Gasteiz
Example: 28.12357 → Las Palmas de Gran Canaria"
},
"customLongitude": {
"title": "Custom longitude",
"minimum": -18.2,
"maximum": 5,
"type": "number",
"description": "Longitude to pair with custom latitude.
Range: -18.2 (western Canarias) to 5.0 (Balearics).
Example: -2.67268 → Vitoria-Gasteiz
Example: -15.43620 → Las Palmas de Gran Canaria"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}