{ "openapi": "3.0.1", "info": { "title": "Accor Hotel Details Scraper", "description": "Scrape full Accor hotel records. Add hotel ids and get the description, address, coordinates, stars, guest rating with category scores, every room type with size and beds, restaurants and facilities, amenities, photos and the latest guest reviews. $0.80 per 1,000 hotels, reviews included.", "version": "1.0", "x-build-id": "6uwpDuJKm3OIQd9ud" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/boncross~accor-hotel-details/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-boncross-accor-hotel-details", "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/boncross~accor-hotel-details/runs": { "post": { "operationId": "runs-sync-boncross-accor-hotel-details", "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/boncross~accor-hotel-details/run-sync": { "post": { "operationId": "run-sync-boncross-accor-hotel-details", "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": { "hotels": { "title": "Hotels", "type": "array", "description": "Accor hotel ids (four characters, e.g. 0663, C185) or all.accor.com hotel URLs.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (bulk upload)", "type": "array", "description": "Accor page addresses, with the option to load them in bulk from a file, a Google Sheet or a remote list. Use this when you have more links than you want to paste. Combined with anything in the list above.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum hotels for the whole run", "minimum": 0, "type": "integer", "description": "Stop after this many hotels have been returned. 0 means no limit.", "default": 0 }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Add the most recent guest reviews to every hotel record, with the rating, text, trip type and the hotel's reply.", "default": true }, "reviewsLimit": { "title": "Reviews per hotel", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many of the most recent reviews to return, up to 20, which is all Accor publishes per hotel.", "default": 20 }, "flattenReviews": { "title": "One row per review", "type": "boolean", "description": "Emit one dataset row per review, each carrying the hotel fields, instead of one row per hotel with a reviews array.", "default": false }, "includeRooms": { "title": "Include room types", "type": "boolean", "description": "Add every room type with size, beds, maximum occupancy, views and room amenities.", "default": true }, "includeFacilities": { "title": "Include facilities", "type": "boolean", "description": "Add restaurants, bars, spas, pool, fitness centre and breakfast with their descriptions.", "default": true }, "includePhotos": { "title": "Include photos", "type": "boolean", "description": "Add photo URLs in every size Accor publishes.", "default": true }, "photosLimit": { "title": "Photos per hotel", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many photos to return per hotel.", "default": 20 }, "language": { "title": "Language", "enum": [ "en", "fr", "de", "es", "it", "pt", "nl", "pl", "ja", "ko", "zh", "ru", "tr", "ar" ], "type": "string", "description": "Language for the description, room names, amenity labels and reviews.", "default": "en" }, "includeRaw": { "title": "Include raw hotel", "type": "boolean", "description": "Add the untouched hotel object to every record, next to the mapped fields.", "default": false }, "delayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Optional pause before each call, in milliseconds. 0 (the default) runs as fast as the parallel limit allows. Values above 2000 are treated as 2000.", "default": 0 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 32, "type": "integer", "description": "How many requests run at once across the whole run. The default is the fastest level measured clean; lower it only if a run reports refusals or errors.", "default": 8 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }