# Swimply Scraper (`dadhalfdev/swimply-scraper`) Actor Scrape Swimply pool and space listings by place. Returns title, hourly price, rating, guests, location, images, and listing URL — up to 500 results per run. - **URL**: https://apify.com/dadhalfdev/swimply-scraper.md - **Developed by:** [Marco Rodrigues](https://apify.com/dadhalfdev) (community) - **Categories:** Travel, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## 🏊 Swimply Scraper Want to find private pools, courts, or unique spaces to rent by the hour? This scraper makes it easy! Set a **place** and **space type** (e.g. pools near Los Angeles) and extract up to **2000** listings from [Swimply](https://swimply.com/) — hourly pricing, ratings, capacity, location, and images — into CSV or JSON. You can also paste specific listing URLs instead of searching. ### 💡 Perfect for... - **Guests & planners:** Discover pools, pickleball courts, and mansions near your city - **Hosts & competitors:** Monitor nearby inventory, pricing, and ratings - **Market research:** Analyze hourly rental supply by city, space type, and price - **Data analysts:** Export clean structured data for dashboards and maps ### ✨ Why you'll love this scraper - 🎯 **Search by place:** City or address + space type — no search URL required - 💵 **Hourly pricing:** List price, discounts, and best `price_per_hour` - ⭐ **Ratings & capacity:** Guest ratings, review counts, and max guests - 📍 **Location ready:** City, state, zip, coordinates, and distance - 🔎 **Optional deep dive:** Turn on enrich details for amenities, hours, and sample reviews - 🔗 **Direct URLs:** Or scrape a list of specific Swimply listing links ### 📦 What's inside the data? For every listing you get: - **Core:** `id`, `title`, `url`, `description`, `space_type` - **Pricing:** `price_per_hour`, `list_price_per_hour`, `discounted_price_per_hour`, `promo_percent` - **Location:** `city`, `state`, `zip_code`, `country_code`, `latitude`, `longitude`, `distance_miles` - **Social proof:** `rating`, `review_count`, `badges` - **Booking:** `max_guests`, `instant_booking`, `next_available_day` - **Media:** `cover_image_url`, `image_urls` - **With enrich details:** `amenities`, `opens`, `closes`, `reviews_sample` ### 🛠️ Filters explained | Filter | What it does | |--------|----------------| | **Place** | City or address to search near (e.g. `Los Angeles, CA`). Required for search mode. | | **Space type** | What to look for: Pools, Tennis, Pickleball, Hoops, Pet Parks, Mansions, or Discover. | | **Adults** | Guest count used for pricing context (does not filter by capacity). | | **Max listings** | How many results to return (1–2000). | | **Enrich details** | Also open each listing page for amenities, hours, and sample reviews (slower). | | **Listing URLs** | Optional direct Swimply URLs. If set without a place, only these URLs are scraped. | ### 🚀 Quick start 1. Set **Place** (e.g. `Los Angeles, CA`) — or skip and use Listing URLs only 2. Choose **Space type** (e.g. Pools, Pickleball, Mansions) 3. Optionally set **Adults** for pricing context 4. Set **Max listings** (up to 2000) 5. Optionally enable **Enrich details** 6. Click **Start** and export CSV, Excel, or JSON --- #### Input example ```json { "place": "Los Angeles, CA", "space_type": "Pools", "adults": 1, "max_listings": 100 } ```` ### Input reference | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `place` | string | For search | `Los Angeles, CA` | City or address to search near. | | `space_type` | string | Yes | `Pools` | Pools, Tennis, Pickleball, Hoops, Pet Parks, Mansions, or Discover. | | `adults` | integer | No | `1` | Guest adults for pricing context (`1`–`50`). | | `max_listings` | integer | No | `50` | How many listings to return (`1`–`2000`). | | `enrich_details` | boolean | No | `false` | Fetch amenities, hours, and sample reviews. | | `listing_urls` | string\[] | No | — | Direct listing URLs; can replace place-based search. | # Actor input Schema ## `place` (type: `string`): City or address to search near (e.g. Los Angeles, CA). Required for search mode; leave empty if you only provide listing URLs. ## `space_type` (type: `string`): What kind of space to search (Pools, Tennis, Pickleball, Hoops, Pet Parks, Mansions, or Discover). ## `adults` (type: `integer`): Number of guest adults for pricing context (does not filter by capacity). ## `max_listings` (type: `integer`): How many listings to return (1–2000). ## `enrich_details` (type: `boolean`): Also open each listing page for amenities, hours, and sample reviews (slower). ## `listing_urls` (type: `array`): Optional direct Swimply listing URLs. If set without a place, only these URLs are scraped. ## Actor input object example ```json { "place": "Los Angeles, CA", "space_type": "Pools", "adults": 1, "max_listings": 50, "enrich_details": false } ``` # Actor output Schema ## `overview` (type: `string`): Table view of scraped listings using the dataset 'overview' view. ## `results` (type: `string`): All scraped listings from the default dataset without view transformation. # 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("dadhalfdev/swimply-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 = {} # Run the Actor and wait for it to finish run = client.actor("dadhalfdev/swimply-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 '{}' | apify call dadhalfdev/swimply-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dadhalfdev/swimply-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Swimply Scraper", "description": "Scrape Swimply pool and space listings by place. Returns title, hourly price, rating, guests, location, images, and listing URL — up to 500 results per run.", "version": "0.1", "x-build-id": "i9ldz0jZMonCA2Pfv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dadhalfdev~swimply-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dadhalfdev-swimply-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/dadhalfdev~swimply-scraper/runs": { "post": { "operationId": "runs-sync-dadhalfdev-swimply-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/dadhalfdev~swimply-scraper/run-sync": { "post": { "operationId": "run-sync-dadhalfdev-swimply-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": [ "space_type" ], "properties": { "place": { "title": "Place", "type": "string", "description": "City or address to search near (e.g. Los Angeles, CA). Required for search mode; leave empty if you only provide listing URLs.", "default": "Los Angeles, CA" }, "space_type": { "title": "Space type", "enum": [ "Pools", "Tennis", "Pickleball", "Hoops", "Pet Parks", "Mansions", "Discover" ], "type": "string", "description": "What kind of space to search (Pools, Tennis, Pickleball, Hoops, Pet Parks, Mansions, or Discover).", "default": "Pools" }, "adults": { "title": "Adults", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of guest adults for pricing context (does not filter by capacity).", "default": 1 }, "max_listings": { "title": "Max listings", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many listings to return (1–2000).", "default": 50 }, "enrich_details": { "title": "Enrich with detail page", "type": "boolean", "description": "Also open each listing page for amenities, hours, and sample reviews (slower).", "default": false }, "listing_urls": { "title": "Listing URLs (optional)", "type": "array", "description": "Optional direct Swimply listing URLs. If set without a place, only these URLs are scraped.", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```