# SpotHero Scraper (`crawlerbros/spothero-scraper`) Actor Scrape SpotHero - the parking spot marketplace. Browse city parking overviews, search venues/addresses/businesses by name, and get per-facility live pricing, ratings, amenities, and address details for parking near any destination. No login required. - **URL**: https://apify.com/crawlerbros/spothero-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Travel, Integrations - **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 and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## SpotHero Scraper Scrape **SpotHero** — the parking spot marketplace. Get city-level parking price overviews, search for parking near any venue, address, or business by name, and pull live per-facility pricing, ratings, amenities, and address details for parking near a specific destination. HTTP-only, no login, no proxy. ### What this actor does - **Three modes:** `city`, `search`, `destination` - **146 cities** exposed as a dropdown enum, spanning the US and Canada - **Live facility pricing** — real quoted total price, advertised price, and currency straight from SpotHero - **Ratings, amenities, and parking-pass type** per facility (self park, valet, scan-in/ticket-out, license plate, etc.) - **Filters:** min/max price, parking-pass type, monthly-parking-only - **Empty fields are omitted** — you'll never see `null`, `""`, or `[]` in the output ### Output per city overview (`recordType: "cityOverview"`, mode=city) - `citySlug`, `cityName`, `state`, `countryCode`, `timezone`, `latitude`, `longitude` - `avgPriceCommuterLow/High`, `avgPriceWeekendLow/High`, `avgPriceEventLow/High`, `avgPriceOvernightLow/High`, `avgPriceMonthlyLow/High`, `avgPriceAirportLow/High` - `popularDestinationCount`, `performerCount` - `sourceUrl`, `recordType: "cityOverview"`, `scrapedAt` ### Output per destination pointer (`recordType: "destinationPointer"`, mode=city) - `destinationTitle`, `destinationSlug`, `citySlug` - `sourceUrl`, `recordType: "destinationPointer"`, `scrapedAt` ### Output per destination search result (`recordType: "destination"`, mode=search) - `destinationId`, `destinationTitle`, `destinationSlug` - `cityName`, `citySlug`, `state`, `streetAddress`, `zipcode`, `timezone` - `latitude`, `longitude`, `monthlyEnabled` - `sourceUrl`, `recordType: "destination"`, `scrapedAt` ### Output per parking spot (`recordType: "parkingSpot"`, mode=destination, or mode=search with `includeSpots`) - `spotId`, `facilityTitle`, `facilitySlug` - `destinationTitle`, `destinationSlug`, `citySlug`, `cityName`, `state` - `streetAddress`, `postalCode`, `latitude`, `longitude` - `distanceMeters`, `walkingMeters`, `walkingDurationSeconds` - `ratingAverage`, `ratingCount`, `imageUrl` - `parkingType`, `parkingTypeDisplay`, `amenities[]` - `rateWindowStart`, `rateWindowEnd` — the actual quoted time window (see FAQ) - `totalPrice`, `advertisedPrice`, `priceCurrency`, `rateRuleGroup`, `cancellationThresholdMinutes` - `sourceUrl`, `recordType: "parkingSpot"`, `scrapedAt` ### Output per upcoming event at a destination (`recordType: "destinationEvent"`, mode=destination, or mode=search with `includeSpots`) - `eventId`, `eventTitle`, `startDate`, `endDate` - `destinationTitle`, `destinationSlug`, `citySlug` - `sourceUrl`, `recordType: "destinationEvent"`, `scrapedAt` Only emitted for destinations that host scheduled events (stadiums, theaters, festival grounds) — useful context for why parking prices spike on certain dates. ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `city` | `city` / `search` / `destination` | | `citySlug` | string (select) | `chicago` | City to browse (mode=city, destination) | | `searchQuery` | string | `united center` | Venue/address/business name (mode=search) | | `destinationSlugs` | array | `["united-center-parking"]` | Destination URL slugs within `citySlug` (mode=destination) | | `arrivalDateTime` | string | – | Requested arrival time (advisory — see FAQ) | | `departureDateTime` | string | – | Requested departure time (advisory — see FAQ) | | `monthlyOnly` | boolean | `false` | Only keep monthly-parking-enabled destinations/spots | | `parkingType` | string (select) | Any | Filter spots by parking-pass type | | `minPrice` | integer | – | Drop spots priced below this (USD) | | `maxPrice` | integer | – | Drop spots priced above this (USD) | | `includeSpots` | boolean | `false` | Also fetch live pricing for each search result (mode=search) | | `maxItems` | integer | `50` | Hard cap on emitted records (1–1000) | #### Example: city parking price overview ```json { "mode": "city", "citySlug": "chicago" } ```` #### Example: search for parking near a venue, with live pricing ```json { "mode": "search", "searchQuery": "united center", "includeSpots": true, "maxItems": 20 } ``` #### Example: live pricing at a specific destination, self-park only ```json { "mode": "destination", "citySlug": "chicago", "destinationSlugs": ["united-center-parking", "wrigley-field-parking"], "parkingType": "self_park", "maxPrice": 30 } ``` ### Use cases - **Event planning** — compare parking prices near a stadium or theater before a show - **Price tracking** — monitor a venue's average commuter/weekend/event parking rates over time - **Travel apps** — surface real parking options and ratings alongside a destination - **Facility research** — compare amenities and pass types across nearby parking facilities - **Local SEO / directories** — build a parking directory for a city with real, live data ### FAQ **Is this affiliated with SpotHero?** No. This is an independent third-party actor that reads SpotHero's own publicly rendered page data — no login or account is used. **Why does `rateWindowStart`/`rateWindowEnd` not match my requested `arrivalDateTime`/`departureDateTime`?** SpotHero's public pages return a live default quote (the site's next available or currently active pricing window) server-side; picking an arbitrary custom date/time requires the interactive date picker on spothero.com, which runs client-side after page load. This actor passes your requested times through, but the price and window on each record are the value the site actually returned — real, not fabricated, just possibly not your exact requested window. **What does `parkingType` mean?** It's SpotHero's own redemption method for a facility: `self_park` (park it yourself), `self_park_see_attendant`, `scan_in_ticket_out` (scan a code, keep a paper ticket), `scan_in_out` (scan both ways, no ticket), `license_plate` (monitored by plate, no ticket), or `operator_scan`. **Why do some cities show fewer `avgPrice*` bands than others?** SpotHero only publishes bands (commuter/weekend/event/overnight/monthly/airport) it has enough data for in a given city; unavailable bands are simply omitted rather than shown as zero. **How fresh is the pricing?** Every run fetches SpotHero's live pages directly, so prices, ratings, and availability reflect the current market at scrape time. **Is `mode=search` sorted by relevance?** No — SpotHero's underlying destination directory does a plain substring match on the name, not a relevance ranking. An exact match (e.g. "United Center") may not be the first row returned for a query like "united center"; increase `maxItems` if you don't see the exact venue you expect on the first page. **Does this work outside the US?** Yes — the city list includes Canadian cities (Toronto, Vancouver, Calgary, Edmonton, Ottawa, Winnipeg, Halifax, and more) alongside US markets. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `citySlug` (type: `string`): SpotHero city to browse or the city a destination belongs to. ## `searchQuery` (type: `string`): Venue, business, address, or landmark name to search for, e.g. `united center`, `times square`, `123 main st`. ## `destinationSlugs` (type: `array`): SpotHero destination URL slugs within `citySlug`, e.g. `united-center-parking`, `wrigley-field-parking`. Find slugs via mode=city or mode=search. ## `arrivalDateTime` (type: `string`): Requested arrival time (ISO 8601, e.g. 2026-08-15T18:00:00). SpotHero returns its own live quoted rate window per facility (see `rateWindowStart`/`rateWindowEnd` on each record) — the requested window is not guaranteed to be honored without an interactive browser session. ## `departureDateTime` (type: `string`): Requested departure time (ISO 8601). See `arrivalDateTime` note. ## `monthlyOnly` (type: `boolean`): Only keep destinations/spots that support monthly (subscription) parking, not just hourly/daily. ## `parkingType` (type: `string`): Only keep parking spots redeemed via this pass type. ## `minPrice` (type: `integer`): Drop parking spots priced below this. ## `maxPrice` (type: `integer`): Drop parking spots priced above this. ## `includeSpots` (type: `boolean`): For each search result, additionally fetch its destination page for facility-level pricing. Slower — bounded by Max items. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "city", "citySlug": "chicago", "searchQuery": "united center", "destinationSlugs": [ "united-center-parking" ], "monthlyOnly": false, "parkingType": "", "includeSpots": false, "maxItems": 50 } ``` # Actor output Schema ## `parkingSpots` (type: `string`): Dataset containing all scraped SpotHero city overviews, destinations, and parking spot records. # 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 = { "mode": "city", "citySlug": "chicago", "searchQuery": "united center", "destinationSlugs": [ "united-center-parking" ], "monthlyOnly": false, "parkingType": "", "includeSpots": false, "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/spothero-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 = { "mode": "city", "citySlug": "chicago", "searchQuery": "united center", "destinationSlugs": ["united-center-parking"], "monthlyOnly": False, "parkingType": "", "includeSpots": False, "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/spothero-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 '{ "mode": "city", "citySlug": "chicago", "searchQuery": "united center", "destinationSlugs": [ "united-center-parking" ], "monthlyOnly": false, "parkingType": "", "includeSpots": false, "maxItems": 50 }' | apify call crawlerbros/spothero-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/spothero-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SpotHero Scraper", "description": "Scrape SpotHero - the parking spot marketplace. Browse city parking overviews, search venues/addresses/businesses by name, and get per-facility live pricing, ratings, amenities, and address details for parking near any destination. No login required.", "version": "1.0", "x-build-id": "J20Tr42kZ0UjNYof5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~spothero-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-spothero-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/crawlerbros~spothero-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-spothero-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/crawlerbros~spothero-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-spothero-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "city", "search", "destination" ], "type": "string", "description": "What to fetch.", "default": "city" }, "citySlug": { "title": "City (mode=city, destination)", "enum": [ "chicago", "nyc", "washington-dc", "san-francisco", "newark", "denver", "philadelphia", "baltimore", "boston", "new-orleans", "minneapolis", "st-paul", "nashville", "milwaukee", "seattle", "miami", "san-diego", "indianapolis", "cleveland", "dallas", "houston", "phoenix", "atlanta", "pittsburgh", "orlando", "cincinnati", "st-louis", "arlington", "detroit", "los-angeles", "jacksonville", "oakland", "hoboken", "san-jose", "monterey", "tampa", "fort-lauderdale", "jersey-city", "white-plains", "austin", "beverly-hills", "wilmington", "santa-monica", "sacramento", "el-paso", "fort-worth", "lexington", "kansas-city", "san-antonio", "charlotte", "norfolk", "portland", "columbus", "omaha", "buffalo", "las-vegas", "memphis", "richmond", "hartford", "stamford", "providence", "oklahoma-city", "raleigh", "burlington", "annapolis", "tulsa", "louisville", "blacksburg", "santa-barbara", "malibu", "jackson", "mobile-alabama", "knoxville", "honolulu", "salt-lake-city", "dayton", "greenville", "toronto", "edmonton", "calgary", "anchorage", "hamilton", "vancouver", "ottawa", "winnipeg", "portland-maine", "reading", "savannah", "charleston", "baton-rouge", "auburn", "tucson", "south-bend", "grand-rapids", "birmingham", "newport-news", "hunting", "springfield-massachusetts", "palm-springs-california", "new-haven", "charleston-wv", "fort-myers-fl", "manchester-nh", "albuquerque", "des-moines", "reno", "london", "shreveport", "san-ramon", "green-bay", "toledo", "tallahassee", "albany", "fayetteville", "waterloo", "corpus-christi", "little-rock", "richmond-bc", "spokane", "santa-fe", "halifax", "st-johns", "harrisburg", "college-station", "eugene-or", "salem-or", "springfield-mo", "kapaa-hi", "wilmington-nc", "chattanooga-tn", "regina-sk", "saskatoon-sk", "pensacola-fl", "kahului-hi", "waco-tx", "barrie-on", "myrtle-beach-sc", "columbia-sc", "virginia-beach-va", "syracuse-ny", "portsmouth-nh", "billings-mt", "st-catharines-on", "sioux-falls-sd", "kelowna-bc", "vancouver-wa" ], "type": "string", "description": "SpotHero city to browse or the city a destination belongs to.", "default": "chicago" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Venue, business, address, or landmark name to search for, e.g. `united center`, `times square`, `123 main st`.", "default": "united center" }, "destinationSlugs": { "title": "Destination slugs (mode=destination)", "type": "array", "description": "SpotHero destination URL slugs within `citySlug`, e.g. `united-center-parking`, `wrigley-field-parking`. Find slugs via mode=city or mode=search.", "default": [ "united-center-parking" ], "items": { "type": "string" } }, "arrivalDateTime": { "title": "Arrival date/time (mode=destination)", "type": "string", "description": "Requested arrival time (ISO 8601, e.g. 2026-08-15T18:00:00). SpotHero returns its own live quoted rate window per facility (see `rateWindowStart`/`rateWindowEnd` on each record) — the requested window is not guaranteed to be honored without an interactive browser session." }, "departureDateTime": { "title": "Departure date/time (mode=destination)", "type": "string", "description": "Requested departure time (ISO 8601). See `arrivalDateTime` note." }, "monthlyOnly": { "title": "Monthly parking only", "type": "boolean", "description": "Only keep destinations/spots that support monthly (subscription) parking, not just hourly/daily.", "default": false }, "parkingType": { "title": "Parking pass type filter", "enum": [ "", "self_park", "self_park_see_attendant", "scan_in_ticket_out", "scan_in_out", "license_plate", "operator_scan" ], "type": "string", "description": "Only keep parking spots redeemed via this pass type.", "default": "" }, "minPrice": { "title": "Min total price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop parking spots priced below this." }, "maxPrice": { "title": "Max total price (USD)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop parking spots priced above this." }, "includeSpots": { "title": "Also fetch live pricing (mode=search)", "type": "boolean", "description": "For each search result, additionally fetch its destination page for facility-level pricing. Slower — bounded by Max items.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 50 } } }, "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 } } } } } } } } } } ```