# Airbnb / STR Comps + Review Tracker (`isotonic/airbnb-str-comps-review-tracker`) Actor Tracks visible public listing and market snapshot data from Airbnb-like pages without login or private API dependence. - **URL**: https://apify.com/isotonic/airbnb-str-comps-review-tracker.md - **Developed by:** [Brian Keefe](https://apify.com/isotonic) (community) - **Categories:** Travel, Real estate, Business - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Airbnb / STR Comps + Review Tracker Public-page Apify Actor for snapshotting Airbnb-like listing data, market/search listing links, visible review snippets, and simple deltas versus a prior snapshot. The repository is fixture-backed for deterministic offline testing. Live runs only target public HTML pages and do not use login flows, private APIs, or bypass behavior. ### Features - Accepts direct `listingUrls` and optional `marketUrls` - Extracts visible fields only: title, location, rating, review count, visible prices, visible fees, amenities, host name, listing URL, and optional public review snippets - Discovers listing links from market/search pages up to `maxListings` - Emits warning rows for login walls, blocked pages, and fetch failures with evidence - Computes `priceDelta`, `ratingDelta`, `reviewCountDelta`, `isNew`, and `isMissing` against `previousSnapshot` - Includes offline fixture smoke coverage ### Input See `.actor/input_schema.json` or `examples/sample-input.json`. ```json { "listingUrls": ["https://www.airbnb.com/rooms/1001"], "marketUrls": ["https://www.airbnb.com/s/denver--co/homes"], "maxListings": 25, "previousSnapshot": [], "includeReviews": false, "fixtureMode": false } ```` ### Output Dataset rows include: - `listingUrl`, `sourceUrl`, `hostUrl` - `title`, `location`, `hostName` - `rating`, `reviewCount` - `pricePerNight`, `cleaningFee`, `serviceFee`, `totalPrice` - `amenities`, `reviews` - `status`, `warningType`, `warningMessage`, `evidence` - `priceDelta`, `ratingDelta`, `reviewCountDelta` - `isNew`, `isMissing`, `previousStatus` - `snapshotTimestamp` Example output is in `examples/sample-output.json`. ### Local Usage 1. Install dependencies: ```bash npm install ``` 2. Run offline fixture mode: ```bash npm start -- --input=examples/sample-input.json ``` Or with Apify locally: ```bash apify run -i examples/sample-input.json ``` ### Tests ```bash npm test npm run smoke ``` Both commands run offline and do not depend on live Airbnb pages. ### Publish ```bash apify push ``` ### Limitations - The actor only uses public HTML and visible page content; it does not authenticate. - Real-world page layouts vary. The extractor is intentionally narrow and may need selector updates if public markup changes. - Market discovery is limited to links visible in supplied HTML. - Warning rows indicate blocked/login-gated pages rather than pretending extraction succeeded. # Actor input Schema ## `listingUrls` (type: `array`): Public listing URLs to snapshot directly. ## `marketUrls` (type: `array`): Optional public market or search result URLs used to discover listing links. ## `maxListings` (type: `integer`): Upper bound for total listing snapshots after combining direct URLs and market-derived links. ## `previousSnapshot` (type: `array`): Prior snapshot rows keyed by listingUrl for delta computation. ## `includeReviews` (type: `boolean`): Include visible public review snippets when present. ## `fixtureMode` (type: `boolean`): Use bundled deterministic fixture HTML instead of live network requests. ## Actor input object example ```json { "marketUrls": [], "maxListings": 25, "previousSnapshot": [], "includeReviews": false, "fixtureMode": 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("isotonic/airbnb-str-comps-review-tracker").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 = {} # Run the Actor and wait for it to finish run = client.actor("isotonic/airbnb-str-comps-review-tracker").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 '{}' | apify call isotonic/airbnb-str-comps-review-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=isotonic/airbnb-str-comps-review-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb / STR Comps + Review Tracker", "description": "Tracks visible public listing and market snapshot data from Airbnb-like pages without login or private API dependence.", "version": "0.1", "x-build-id": "h9fFuvevOLVTicXrC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/isotonic~airbnb-str-comps-review-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-isotonic-airbnb-str-comps-review-tracker", "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/isotonic~airbnb-str-comps-review-tracker/runs": { "post": { "operationId": "runs-sync-isotonic-airbnb-str-comps-review-tracker", "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/isotonic~airbnb-str-comps-review-tracker/run-sync": { "post": { "operationId": "run-sync-isotonic-airbnb-str-comps-review-tracker", "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": [ "listingUrls" ], "properties": { "listingUrls": { "title": "Listing URLs", "type": "array", "description": "Public listing URLs to snapshot directly.", "items": { "type": "string" } }, "marketUrls": { "title": "Market/Search URLs", "type": "array", "description": "Optional public market or search result URLs used to discover listing links.", "items": { "type": "string" }, "default": [] }, "maxListings": { "title": "Max Listings", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper bound for total listing snapshots after combining direct URLs and market-derived links.", "default": 25 }, "previousSnapshot": { "title": "Previous Snapshot", "type": "array", "description": "Prior snapshot rows keyed by listingUrl for delta computation.", "items": { "type": "object" }, "default": [] }, "includeReviews": { "title": "Include Reviews", "type": "boolean", "description": "Include visible public review snippets when present.", "default": false }, "fixtureMode": { "title": "Fixture Mode", "type": "boolean", "description": "Use bundled deterministic fixture HTML instead of live network requests.", "default": 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 } } } } } } } } } } ```