{ "openapi": "3.0.1", "info": { "title": "ClassPass Studios Scraper - Gyms, Contacts, Classes & Reviews", "description": "Scrape ClassPass studios, gyms, spas and salons by city and activity: activities, address with GPS, rating breakdown, website, phone, emails, Instagram, amenities, booking platform and demand signal. Optional class schedule with credits and review history. Monitor mode returns only new venues.", "version": "0.1", "x-build-id": "XxBnZUDG83leHpvff" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~classpass-studios-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-classpass-studios-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/scrapersdelight~classpass-studios-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-classpass-studios-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/scrapersdelight~classpass-studios-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-classpass-studios-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": { "locations": { "title": "Locations", "type": "array", "description": "One search per line: a city, neighborhood, ZIP/postcode or address, e.g. \"New York\", \"Austin, TX\", \"Shoreditch, London\", \"10011\", or \"40.7359,-73.9911\". Empty (and no venues) = New York.", "default": [], "items": { "type": "string" } }, "venues": { "title": "Venue URLs, aliases or ids", "type": "array", "description": "Look up known venues: a ClassPass studio link, its alias or its numeric id, e.g. \"https://classpass.com/studios/barrys-park-ave-south-new-york\", \"barrys-park-ave-south-new-york\", \"36301\".", "default": [], "items": { "type": "string" } }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Optional search point instead of a place name, e.g. 40.7359. Use with Longitude; the radius comes from Radius (km) or defaults to 5 km." }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Optional search point instead of a place name, e.g. -73.9911. Use with Latitude." }, "activities": { "title": "Activities", "type": "array", "description": "ClassPass activity names, e.g. \"yoga\", \"pilates\", \"barre\", \"boxing\", \"massage\", \"facial\". Several = venues offering any of them. Empty = every venue.", "default": [], "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "all", "fitness", "wellness", "beauty" ], "type": "string", "description": "ClassPass's top-level category filter.", "default": "all" }, "amenities": { "title": "Amenities", "type": "array", "description": "Only venues that offer every amenity picked.", "items": { "type": "string", "enum": [ "shower", "locker", "parking" ], "enumTitles": [ "Showers", "Lockers", "Parking" ] }, "default": [] }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Search radius around each location in km. 0 = ClassPass's own radius for the place (a city searches its whole area, e.g. Austin 32 km).", "default": 0 }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only venues rated at least this on ClassPass (1-5), e.g. 4.7. 0 = no filter. Unrated venues are dropped when set.", "default": 0 }, "minReviewCount": { "title": "Minimum ratings count", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only venues with at least this many ClassPass ratings, e.g. 100. 0 = no filter.", "default": 0 }, "withContactOnly": { "title": "Only venues with a contact", "type": "boolean", "description": "Keep only venues that publish a website, phone or email on ClassPass.", "default": false }, "includeDetails": { "title": "Venue details", "type": "boolean", "description": "Read each venue's page data: GPS, website, phone, emails, Instagram/Facebook, amenities, rating breakdown, booking platform, photos. Included in the venue price. Off = search-card fields only (faster).", "default": true }, "includeSchedule": { "title": "Class schedule", "type": "boolean", "description": "Add each venue's upcoming classes: name, instructor, start/end time, duration, level, credits, availability. Included in the venue price.", "default": false }, "scheduleDays": { "title": "Schedule days", "minimum": 1, "maximum": 7, "type": "integer", "description": "How many days of classes to collect, starting today in the venue's time zone (1-7).", "default": 1 }, "maxClassesPerVenue": { "title": "Max classes per venue", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap on classes listed per venue, e.g. 50.", "default": 50 }, "includeReviews": { "title": "Review history", "type": "boolean", "description": "Add each venue's written reviews, newest first: author, rating, text, date, class and instructor. Charged per review delivered (the review event).", "default": false }, "maxReviewsPerVenue": { "title": "Max reviews per venue", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap on reviews per venue when Review history is on, e.g. 20. Big studios have thousands.", "default": 20 }, "monitorMode": { "title": "Only new venues", "type": "boolean", "description": "Skip venues this search already delivered in earlier runs, so a scheduled run returns only venues that joined ClassPass (or newly match your filters). Skipped venues are not charged.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store that remembers delivered venues. Use a different name per monitored list, e.g. \"nyc-yoga-studios\".", "default": "classpass-studios-monitor" }, "maxResults": { "title": "Max venues", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Total venues across all locations and lookups. 0 = everything ClassPass lists (New York: ~4,700 venues in its 34 km area).", "default": 100 }, "maxResultsPerLocation": { "title": "Max venues per location", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Cap per location line, so one big city does not use the whole run. 0 = no per-location cap.", "default": 0 }, "compact": { "title": "Compact output", "type": "boolean", "description": "Core fields only (name, link, activities, address, GPS, rating, website, phone, email, Instagram, booking platform) plus any classes/reviews requested - trimmed for CRMs and LLM pipelines.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Direct by default. If ClassPass refuses a request, the run retries through Apify residential and, last, Apify's Unblocker under a small per-run allowance it pays itself. Pick Apify datacenter groups to add them as an extra rung, or set your own proxy URLs.", "default": { "useApifyProxy": false } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Venues read in parallel.", "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 } } } } } } } } } }