# Otelpuan Reviews Scraper (`one_house/otelpuan-reviews-scraper`) Actor Scrape hotel reviews, ratings, and owner replies from Otelpuan by hotel URL or vendor ID. - **URL**: https://apify.com/one\_house/otelpuan-reviews-scraper.md - **Developed by:** [One House](https://apify.com/one_house) (community) - **Categories:** E-commerce, Travel, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Otelpuan Reviews Scraper Extract hotel reviews from [Otelpuan](https://www.otelpuan.com) using a hotel page URL or vendor ID. Ideal for reputation monitoring and hospitality analytics focused on the Turkish market. ### What you get - Hotel name, aggregate rating, and review count - Review title and body - Overall score on Otelpuan’s 10-point scale, plus category scores - Author name and avatar - Travel / booking period and room type - Recommendation and channel - Owner reply text and date - Photos (when available) - Full raw review object for advanced use ### How to use 1. Open this Actor and click **Start** 2. Add Otelpuan hotel URLs under **Hotel URLs**, or paste vendor IDs under **Vendor IDs** 3. Set **Max reviews per hotel** (`0` = all) 4. Run and download results from the **Dataset** tab #### Finding the vendor ID - From an Otelpuan hotel page, the Actor reads `data-hd-vendorId` automatically - Or pass the numeric vendor ID directly ### Input example ```json { "startUrls": [ { "url": "https://www.otelpuan.com/Concorde-De-Luxe-Resort" } ], "maxReviews": 100 } ```` Or with a vendor ID: ```json { "vendorIds": ["12345"], "maxReviews": 100 } ``` ### Output example Each dataset item is one review: ```json { "reviewId": "4956089", "vendorId": "25545", "hotelName": "Example Hotel", "title": "Otel çok güzel ve temizdi.", "text": "Oda harikaydı. 24 saat yeme-içme imkanı vardı.", "rating": 10, "ratingScale": 10, "authorName": "S*** K***", "travelDate": "2025-09-01T00:00:00.000Z", "roomTypeName": "COURTYARD SUITE", "recommendation": "RECOMMEND", "replyText": "Teşekkür ederiz...", "source": "otelpuan", "scrapedAt": "2026-07-11T12:00:00.000Z" } ``` A hotel summary is also saved in the key-value store as `HOTEL_INFO_{vendorId}`. ### Tips - Prefer **Vendor IDs** when you already know them — reviews are fetched via API and work reliably. - Hotel URLs are useful when you need hotel name/rating metadata from the page; enable Apify Proxy if page fetches are blocked. - Use `maxReviews` to control cost on hotels with many reviews. - Ratings use a **1–10** scale (`ratingScale: 10`). - Add multiple hotels in one run to batch scraping. ### Limitations - Only public Otelpuan hotel reviews are returned. - Review text is typically in Turkish. # Actor input Schema ## `startUrls` (type: `array`): Otelpuan hotel page URLs. The vendor ID is extracted from the page automatically. ## `vendorIds` (type: `array`): Otelpuan numeric vendor/hotel IDs (alternative to URLs). ## `maxReviews` (type: `integer`): Maximum number of reviews to scrape per hotel. Set 0 for all available reviews. ## `pageSize` (type: `integer`): Reviews fetched per API request (1–50). ## `proxyConfiguration` (type: `object`): Optional Apify Proxy for larger batches. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.otelpuan.com/Concorde-De-Luxe-Resort" } ], "maxReviews": 100, "pageSize": 20, "proxyConfiguration": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.otelpuan.com/Concorde-De-Luxe-Resort" } ], "maxReviews": 100, "pageSize": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("one_house/otelpuan-reviews-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.otelpuan.com/Concorde-De-Luxe-Resort" }], "maxReviews": 100, "pageSize": 20, } # Run the Actor and wait for it to finish run = client.actor("one_house/otelpuan-reviews-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.otelpuan.com/Concorde-De-Luxe-Resort" } ], "maxReviews": 100, "pageSize": 20 }' | apify call one_house/otelpuan-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=one_house/otelpuan-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Otelpuan Reviews Scraper", "description": "Scrape hotel reviews, ratings, and owner replies from Otelpuan by hotel URL or vendor ID.", "version": "0.1", "x-build-id": "8dxTmXBiNXwTXyf8A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/one_house~otelpuan-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-one_house-otelpuan-reviews-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/one_house~otelpuan-reviews-scraper/runs": { "post": { "operationId": "runs-sync-one_house-otelpuan-reviews-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/one_house~otelpuan-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-one_house-otelpuan-reviews-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": { "startUrls": { "title": "Hotel URLs", "type": "array", "description": "Otelpuan hotel page URLs. The vendor ID is extracted from the page automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "vendorIds": { "title": "Vendor IDs", "uniqueItems": true, "type": "array", "description": "Otelpuan numeric vendor/hotel IDs (alternative to URLs).", "items": { "type": "string" } }, "maxReviews": { "title": "Max reviews per hotel", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to scrape per hotel. Set 0 for all available reviews.", "default": 200 }, "pageSize": { "title": "Page size", "minimum": 1, "maximum": 50, "type": "integer", "description": "Reviews fetched per API request (1–50).", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy for larger batches.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```