{ "openapi": "3.0.1", "info": { "title": "Yaencontre Scraper - Spanish Property Listings", "description": "Find Spanish property listings on yaencontre.com for sale, rent, and business transfers. Search by city or coordinates, filter by property type, price, rooms, area, amenities, and rental duration, then export JSON, CSV, Excel-ready data, listing links, images, locations, prices, and contact details.", "version": "0.0", "x-build-id": "nLbAIzlq22hEXfmXJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~yaencontre-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-yaencontre-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/igolaizola~yaencontre-scraper/runs": { "post": { "operationId": "runs-sync-igolaizola-yaencontre-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/igolaizola~yaencontre-scraper/run-sync": { "post": { "operationId": "run-sync-igolaizola-yaencontre-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": [ "maxItems" ], "properties": { "location": { "title": "Location", "type": "string", "description": "City, province, or neighborhood to search. Use coordinates for an arbitrary point." }, "locationType": { "title": "Location scope (optional)", "enum": [ "", "municipality", "province", "district", "neighborhood" ], "type": "string", "description": "Optionally choose whether the location means a municipality, province, district, or neighborhood.", "default": "" }, "operation": { "title": "Operation", "enum": [ "sale", "rent", "businessTransfer" ], "type": "string", "description": "Choose whether to find properties for sale, rent, or business transfer.", "default": "sale" }, "propertyType": { "title": "Property type", "enum": [ "building", "flat", "home", "garage", "house", "land", "commercialUnit", "newDevelopment", "office", "premises", "storage", "business", "apartment", "penthouse", "chalet", "duplex", "loft", "townhouse", "countryHouse", "studio", "villa" ], "type": "string", "description": "Type of property to find.", "default": "flat" }, "rentalDuration": { "title": "Rental duration", "enum": [ "", "longTerm", "seasonal", "holiday" ], "type": "string", "description": "For rental searches, choose long-term, seasonal, or holiday accommodation.", "default": "" }, "sortBy": { "title": "Sort results", "enum": [ "newest", "relevance", "highestPrice", "lowestPrice", "largestArea", "smallestArea" ], "type": "string", "description": "How results should be ordered.", "default": "newest" }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Fetch additional information for each listing and add it under _details. This uses one extra request per listing.", "default": false }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only include listings at or above this price.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only include listings at or below this price.", "default": 0 }, "minBedrooms": { "title": "Minimum bedrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bedrooms.", "default": 0 }, "minBathrooms": { "title": "Minimum bathrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bathrooms.", "default": 0 }, "minArea": { "title": "Minimum area (m²)", "minimum": 0, "type": "integer", "description": "Minimum property area in square meters.", "default": 0 }, "maxArea": { "title": "Maximum area (m²)", "minimum": 0, "type": "integer", "description": "Maximum property area in square meters.", "default": 0 }, "amenities": { "title": "Amenities and filters", "type": "array", "description": "Optional equipment, characteristics, opportunities, and visualization filters.", "items": { "type": "string", "enum": [ "airConditioning", "furnished", "elevator", "centralHeating", "chimney", "garden", "swimmingPool", "parking", "terrace", "balcony", "neighborhoods", "cityCenter", "beachfront", "urbanization", "bargain", "luxury", "privateSeller", "secondHand", "banks", "priceReduced", "urgent", "newDevelopment", "homeStaging", "floorPlan", "virtualTour", "threeDTour", "video" ], "enumTitles": [ "Air conditioning", "Furnished", "Elevator", "Central heating", "Chimney", "Garden", "Swimming pool", "Garage parking", "Terrace", "Balcony", "Neighborhoods", "City center", "Beachfront", "Urbanization", "Cheap", "Luxury", "Private owner", "Second-hand", "Banks", "Have reduced price", "Urgent", "New construction", "Home staging", "Floor plan", "Virtual tour", "3D tour", "Video" ] } }, "latitude": { "title": "Latitude", "type": "number", "description": "Latitude for a coordinate search." }, "longitude": { "title": "Longitude", "type": "number", "description": "Longitude for a coordinate search." }, "radiusKm": { "title": "Search radius (km)", "minimum": 1, "type": "integer", "description": "Radius around the coordinates, in kilometers.", "default": 20 }, "pageSize": { "title": "Page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "Number of listings requested at a time.", "default": 20 }, "maxItems": { "title": "Maximum listings", "type": "integer", "description": "Maximum number of listings to save. Use 0 for all available listings. Negative values are treated as 0.", "default": 100 } } }, "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 } } } } } } } } } }