{ "openapi": "3.0.1", "info": { "title": "Spain Rural Accommodation Registry - Phone, Email, Licence", "description": "17,000+ officially registered rural houses, agroturismos, rural hotels and tourist accommodations in Spain, read from the regional government registries and unified into one clean dataset with phone, email, website, GPS and registry number. Filter for the ones with no website.", "version": "1.1", "x-build-id": "cJ2yjv1xQzquYra0Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wellbuilt_zythem~spain-rural-accommodation-registry/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wellbuilt_zythem-spain-rural-accommodation-registry", "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/wellbuilt_zythem~spain-rural-accommodation-registry/runs": { "post": { "operationId": "runs-sync-wellbuilt_zythem-spain-rural-accommodation-registry", "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/wellbuilt_zythem~spain-rural-accommodation-registry/run-sync": { "post": { "operationId": "run-sync-wellbuilt_zythem-spain-rural-accommodation-registry", "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": { "regions": { "title": "Regions", "type": "array", "description": "Which regional registries to read. Leave empty for the standard set (~17,000 records). Canarias holiday homes are excluded unless you name them: that file alone adds 72,000 records with no contact details.", "items": { "type": "string", "enum": [ "CL", "CM", "AR", "MC", "CN", "CN-H", "IB-ME", "IB-MA", "CN-VV" ], "enumTitles": [ "Castilla y Leon (~4,100 - phone + email)", "Castilla-La Mancha (~3,100 - phone + email)", "Aragon (~2,000 - phone + email)", "Region de Murcia (~1,900 - phone + email)", "Canarias - tourism register (~2,800 - GPS)", "Canarias - hotels (~850 - GPS)", "Illes Balears / Menorca (~440 - phone + GPS)", "Illes Balears / Mallorca (~1,850 - GPS)", "Canarias - holiday homes (~72,000 - opt-in, no contact data)" ] }, "default": [] }, "types": { "title": "Accommodation types", "type": "array", "description": "Filter by normalised type. Leave empty to get every type.", "items": { "type": "string", "enum": [ "casa_rural", "apartamento_rural", "hotel_rural", "agroturismo", "albergue", "camping", "villa", "vivienda_turistica", "hotel", "otro" ], "enumTitles": [ "Casa rural", "Apartamento rural", "Hotel rural / Posada", "Agroturismo", "Albergue / Hostel", "Camping", "Villa", "Vivienda de uso turistico", "Hotel", "Other" ] }, "default": [] }, "provinces": { "title": "Provinces", "type": "array", "description": "Filter by province name, accent-insensitive. Example: Ávila, Soria, Cuenca.", "default": [], "items": { "type": "string" } }, "municipalities": { "title": "Municipalities", "type": "array", "description": "Filter by municipality name, accent-insensitive.", "default": [], "items": { "type": "string" } }, "onlyWithoutWebsite": { "title": "Only accommodations WITHOUT a website", "type": "boolean", "description": "The prospecting filter. Returns only places that have no website on record — the ones that still need one.", "default": false }, "onlyWithEmail": { "title": "Only accommodations with an email", "type": "boolean", "description": "Drop records without a usable email address.", "default": false }, "onlyWithPhone": { "title": "Only accommodations with a phone", "type": "boolean", "description": "Drop records without a valid Spanish phone number.", "default": false }, "minCapacity": { "title": "Minimum capacity (beds)", "minimum": 0, "type": "integer", "description": "Only places with at least this many beds. Bigger places have bigger budgets.", "default": 0 }, "maxResults": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "Stop after this many records. Leave at 0 for no limit.", "default": 0 } } }, "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 } } } } } } } } } }