{ "openapi": "3.0.1", "info": { "title": "Hipcamp Campsites & Host Scraper", "description": "Scrape Hipcamp campsite listings, host profiles, and public campgrounds. Search by location, filter by type, amenities, price, and rating. Supports 5 modes: search, get site detail, get host profile, browse by type, and browse by state", "version": "1.0", "x-build-id": "u2hKEZOZ6hRHruUY2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~hipcamp-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-hipcamp-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~hipcamp-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-hipcamp-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~hipcamp-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-hipcamp-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": [ "searchSites", "getSite", "getHost", "byType", "byState" ], "type": "string", "description": "What to scrape. Use `searchSites` to search by keyword/location, `getSite` to fetch detail for specific URLs, `getHost` to extract host profiles, `byType` to browse by campsite type, or `byState` to browse all sites in a US state.", "default": "searchSites" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Keyword or location to search (e.g. `Yosemite`, `Big Sur`, `lake camping Texas`). Used in `searchSites` mode.", "default": "Yosemite" }, "location": { "title": "Location", "type": "string", "description": "City, state, region, or area name as an alternative to `searchQuery`." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "List of Hipcamp campsite or land URLs. Used in `getSite` and `getHost` modes. Example: `https://www.hipcamp.com/en-US/land/california-camping-at-yosemite-s-doorstep-lz9hk605`", "default": [], "items": { "type": "string" } }, "state": { "title": "US State", "enum": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ], "type": "string", "description": "US state to browse or filter by. Required for `byState` mode; optional filter in other modes." }, "siteType": { "title": "Campsite type", "enum": [ "Tent Camping", "RV Camping", "Glamping", "Cabin", "Treehouse", "Farm", "Ranch", "Yurt", "Tiny House", "Other" ], "type": "string", "description": "Filter results by campsite type. Also used to select a type category in `byType` mode." }, "minPrice": { "title": "Min price per night ($)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Only include campsites at or above this nightly price." }, "maxPrice": { "title": "Max price per night ($)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Only include campsites at or below this nightly price." }, "minRating": { "title": "Min rating (0–5)", "minimum": 0, "maximum": 5, "type": "number", "description": "Only include campsites with a rating at or above this value (0–5 scale)." }, "hasElectric": { "title": "Electric hookup required", "type": "boolean", "description": "Only include campsites with electric hookup available.", "default": false }, "petFriendly": { "title": "Pet friendly required", "type": "boolean", "description": "Only include campsites that allow pets.", "default": false }, "hasWifi": { "title": "WiFi required", "type": "boolean", "description": "Only include campsites with WiFi available.", "default": false }, "hasWater": { "title": "Potable water required", "type": "boolean", "description": "Only include campsites with potable water available.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of records to output.", "default": 20 } } }, "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 } } } } } } } } } }