{ "openapi": "3.0.1", "info": { "title": "Yad2 Scraper", "description": "[💰 $4.0 / 1K] Extract listings from Yad2, Israel's largest classifieds site. Real estate (rent, sale, commercial), vehicles, and second-hand goods. Search by category and location or paste Yad2 URLs directly. Returns price, location, photos, agent details, and category-specific attributes.", "version": "1.0", "x-build-id": "pTEKNpvjlX3TaqpOf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~yad2-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-yad2-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/solidcode~yad2-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-yad2-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/solidcode~yad2-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-yad2-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": { "category": { "title": "Category", "enum": [ "realestate-rent", "realestate-forsale", "realestate-commercial", "vehicles-cars", "vehicles-motorcycles", "vehicles-trucks", "market", "pets" ], "type": "string", "description": "Which Yad2 section to search. Ignored when you paste Start URLs below — the URL already specifies the section.", "default": "realestate-rent" }, "location": { "title": "Location", "type": "string", "description": "City, neighborhood, or area name in Hebrew or English (e.g. \"Tel Aviv\", \"תל אביב\", \"Haifa\", \"Jerusalem\"). Leave empty to search Israel-wide. Ignored when Start URLs are provided." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste one or more Yad2 search URLs directly (e.g. https://www.yad2.co.il/realestate/rent?topArea=2&city=5000). When provided, these override Category and Location. Filters in the URL are honored as-is — the most flexible way to scrape.", "items": { "type": "string" } }, "priceMin": { "title": "Minimum Price (ILS)", "minimum": 0, "type": "integer", "description": "Only include listings at or above this price (in Israeli Shekels). Leave empty for no minimum." }, "priceMax": { "title": "Maximum Price (ILS)", "minimum": 0, "type": "integer", "description": "Only include listings at or below this price (in Israeli Shekels). Leave empty for no maximum." }, "roomsMin": { "title": "Minimum Rooms", "minimum": 0, "maximum": 20, "type": "number", "description": "Only include real estate listings with at least this many rooms. Half-rooms are allowed (e.g. 2.5). Ignored for non-real-estate categories." }, "roomsMax": { "title": "Maximum Rooms", "minimum": 0, "maximum": 20, "type": "number", "description": "Only include real estate listings with at most this many rooms. Ignored for non-real-estate categories." }, "yearMin": { "title": "Minimum Vehicle Year", "minimum": 1950, "maximum": 2030, "type": "integer", "description": "Only include vehicle listings from this year onward (e.g. 2018). Ignored for non-vehicle categories." }, "yearMax": { "title": "Maximum Vehicle Year", "minimum": 1950, "maximum": 2030, "type": "integer", "description": "Only include vehicle listings up to this year. Ignored for non-vehicle categories." }, "sortBy": { "title": "Sort By", "enum": [ "newest", "price_low", "price_high", "relevance" ], "type": "string", "description": "How Yad2 should order the listings before we collect them. \"Newest\" surfaces fresh inventory first — best for alerting and lead generation.", "default": "newest" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Hard cap on the total number of listings to collect across all sources. Default 200 — increase for bigger runs, or set to 0 for no cap (an internal upper limit of 100,000 still applies to prevent runaway pagination). The actor stops requesting new pages once this number is reached but keeps the full final page even if it slightly overshoots.", "default": 200 } } }, "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 } } } } } } } } } }