{ "openapi": "3.0.1", "info": { "title": "Yad2 Vehicles - Israel Car Listings", "description": "Used by Israeli used-car dealerships monitoring competitor inventory, insurance teams pricing risk by make and model, fleet operators tracking resale values, and arbitrage traders scanning for underpriced vehicles. Returns make, model, year, price, mileage, photos, and seller contact info.", "version": "1.0", "x-build-id": "MJRMcY3KhzeH1cgCV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/swerve~yad2-vehicles/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-swerve-yad2-vehicles", "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/swerve~yad2-vehicles/runs": { "post": { "operationId": "runs-sync-swerve-yad2-vehicles", "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/swerve~yad2-vehicles/run-sync": { "post": { "operationId": "run-sync-swerve-yad2-vehicles", "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": { "vehicleType": { "title": "Vehicle Type", "enum": [ "cars", "motorcycles", "scooters", "all" ], "type": "string", "description": "Type of vehicle to scrape", "default": "cars" }, "maxItems": { "title": "Max Listings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of listings to return.", "default": 200 }, "minPrice": { "title": "Min Price (₪)", "type": "integer", "description": "Minimum price filter in ILS (optional)" }, "maxPrice": { "title": "Max Price (₪)", "type": "integer", "description": "Maximum price filter in ILS (optional)" }, "minYear": { "title": "Min Year", "type": "integer", "description": "Minimum year of production (optional)" }, "maxYear": { "title": "Max Year", "type": "integer", "description": "Maximum year of production (optional)" }, "maxKm": { "title": "Max Kilometers", "type": "integer", "description": "Maximum km driven (optional)" }, "maxHand": { "title": "Max Previous Owners", "type": "integer", "description": "Maximum number of previous owners (1 = first hand only, 2 = up to second hand, etc.)" }, "manufacturer": { "title": "Manufacturer", "type": "string", "description": "Filter by manufacturer name (Hebrew or English, e.g. 'Toyota' or 'טויוטה'). Uses server-side filtering when possible. Leave empty for all." }, "model": { "title": "Model", "type": "string", "description": "Filter by model name (e.g. 'Corolla', 'קורולה'). Client-side filter." }, "city": { "title": "City", "type": "string", "description": "Filter by city name in Hebrew or English (e.g. 'רעננה', 'תל אביב', 'Tel Aviv'). Returns only listings from this specific city." }, "area": { "title": "Area / Region", "enum": [ "tel aviv", "jerusalem", "haifa", "center", "sharon", "south", "north", "shfela" ], "type": "string", "description": "Filter by region. Returns listings from all cities in the selected area. Use 'city' for a specific city instead." }, "excludeAgents": { "title": "Exclude Dealers/Agents", "type": "boolean", "description": "Only return listings from private sellers (exclude commercial/dealer listings)", "default": false }, "cfWorkerUrl": { "title": "Cloudflare Worker URL", "type": "string", "description": "URL of a CF Worker proxy to bypass Radware. Recommended for reliable scraping." }, "cfWorkerToken": { "title": "CF Worker Auth Token", "type": "string", "description": "Bearer token for CF Worker authentication (optional)" }, "proxyConfig": { "title": "Proxy Configuration", "type": "object", "description": "Proxy configuration (optional). Yad2 APIs work without proxy from Apify infrastructure. Only enable if you experience blocks." } } }, "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 } } } } } } } } } }