# AllTrails Scraper (`crawlerbros/alltrails-scraper`) Actor Scrape AllTrails, the world's largest hiking, biking, and running trail database. Search trails by keyword/location; fetch full trail detail (difficulty, distance, elevation, GPS coordinates, photos, recent reviews); browse trails by park, city, or country. - **URL**: https://apify.com/crawlerbros/alltrails-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 16 bookmarks - **User rating**: 5.00 out of 5 stars ## 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 ## AllTrails Scraper Scrape **AllTrails** — the world's largest hiking, biking, and running trail database — for trail detail, location-based browse, or keyword search. Returns full structured data including difficulty, distance, elevation profile, GPS coordinates, photos, ratings, and recent reviews. ### What this actor extracts For every emitted trail record: - `name`, `slug`, `url`, `trailId`, `mapId` - `overview` — long-form trail description - Geometry: `lengthMeters`, `lengthKm`, `lengthMiles`, `elevationGainMeters`, `elevationGainFeet`, `elevationStartMeters`, `elevationMaxMeters` - Difficulty: `difficulty` (`easy`/`moderate`/`hard`), `difficultyScore` (1-7) - `routeType` (`out_and_back`/`loop`/`point_to_point`) - Location: `latitude`, `longitude`, `city`, `state`, `stateCode`, `country`, `countryCode`, `areaName`, `areaSlug` - Ratings: `avgRating`, `reviewCount`, `ratingsBreakdown` (per-star counts), `popularity`, `visitorUsage` - Counts: `photoCount`, `trackCount`, `completedCount` - `activities[]` — primary activity slugs (hiking, mountain-biking, etc.) - `features[]` — trail attributes (Forests, Rivers, Views, Waterfalls, etc.) - `seasonStartMonth`, `seasonEndMonth` - `coverPhoto` — `{id, url, title, username}` and top-level `coverUrl` - `recentReviews[]` — recent review excerpts (rating, author, text, date) when available from the trail page ### Modes | Mode | Input | Output | |-----------------------|--------------------------------------------------------|--------| | `byTrail` | `url` or `country` + `state` + `trailSlug` | One full trail record | | `byUrl` | `url` or `urls[]` — any alltrails.com URL | Auto-routed (trail/park/city/country/search) | | `searchTrails` | `query` + optional `country` | Trails matching the query (Algolia API) | | `byPark` | `url` or `country` + `state` + `parkSlug` | Trails inside a park (with detail) | | `byCity` | `url` or `country` + `state` + `city` | Popular trails near a city | | `topTrailsByCountry` | `url` or `country` | Curated trail list for a country page | ### Filters | Filter | Description | |------------------|-------------| | `difficulty` | `easy` / `moderate` / `hard` | | `routeType` | `out_and_back` / `loop` / `point_to_point` | | `activity` | One of 23 activity slugs (hiking, mountain-biking, …) | | `minRating` | Drop trails below this avgRating (0-5) | | `minLengthKm` | Drop trails shorter than this (km) | | `maxLengthKm` | Drop trails longer than this (km) | | `maxItems` | Hard cap on emitted records (1-1000) | ### Reliability - HTTP-first via `curl_cffi` with **Safari iOS** TLS fingerprint (this is the only impersonation that bypasses AllTrails' Cloudflare-edge filter — Chrome/Firefox impersonations get 403'd). - Auto-escalates to **Apify residential proxy** on 403 / 429 / Cloudflare-challenge if `autoEscalateOnBlock=true` (default). - Retries with exponential backoff up to 4 attempts. - Algolia search uses AllTrails' public client-facing keys — no auth gymnastics required. ### Multi-country support The `country` enum exposes 48 of the most-trafficked AllTrails country slugs. Search uses the matching localized Algolia index when one exists (e.g. `germany` → `alltrails_primary_de-DE`). For all other countries, the global English index is used. ### FAQ **Do I need an account or login?** No. AllTrails' trail pages, park pages, country pages, and search index are all publicly accessible. **Why is `recentReviews` shorter than `reviewCount`?** AllTrails' trail page only embeds the most-recent ~5-10 reviews server-side; the rest are loaded client-side via API. To pull large review sets, use the `byTrail` mode with the canonical URL — the actor returns whatever the page exposes. **Are GPX track files included?** No — the actor focuses on trail metadata. GPX/KML downloads are paywalled by AllTrails. **Do I get photos?** Yes — the cover photo URL is included as `coverUrl`. AllTrails CDN images are publicly accessible without referer headers. **Can I scrape user profiles or saved lists?** Not in v1 — those routes are mostly login-walled. ### Limitations - AllTrails Pro-only fields (downloadable maps, real-time conditions API) are not exposed. - Search results sometimes return `area` records (parks/regions) before trails; we filter to `type=trail` only. - A handful of country slugs return 403 from datacenter IPs — auto-escalation kicks in transparently. # Actor input Schema ## `mode` (type: `string`): Which discovery axis to use. ## `url` (type: `string`): An alltrails.com URL — trail, park, city, or country page. Used by mode=byTrail/byPark/byCity/byUrl/topTrailsByCountry. ## `urls` (type: `array`): Multiple alltrails.com URLs. Trail/park/city/country URLs are auto-routed. ## `query` (type: `string`): Free-text query, e.g. `yosemite`, `coastal hike california`. ## `country` (type: `string`): Country slug used by AllTrails URLs and for search index selection. `us` is the default. ## `state` (type: `string`): State slug (e.g. `california`, `new-york`). Used with byPark/byCity/byTrail. ## `city` (type: `string`): City slug (e.g. `san-francisco`, `los-angeles`). ## `trailSlug` (type: `string`): Trail slug — the part after the state in the URL. ## `parkSlug` (type: `string`): Park slug, e.g. `yosemite-national-park`. ## `difficulty` (type: `string`): Filter by AllTrails difficulty band. ## `routeType` (type: `string`): Filter by trail route type. ## `activity` (type: `string`): Filter by primary activity. Trails matching this activity in their `activities` array pass. ## `minRating` (type: `number`): Drop trails with avgRating below this (0-5). ## `minLengthKm` (type: `number`): Drop trails shorter than this length (km). ## `maxLengthKm` (type: `number`): Drop trails longer than this length (km). ## `fetchTrailDetails` (type: `boolean`): For listing modes (byPark/byCity/topTrailsByCountry/byUrl-listing), fetch the full trail detail page for every trail. Disable to emit lightweight stubs faster. ## `useProxy` (type: `boolean`): Route requests through Apify proxy. AllTrails works without a proxy in most cases; auto-escalation handles 403/429 transparently. ## `autoEscalateOnBlock` (type: `boolean`): If direct fetches return 403/429/Cloudflare-challenge, retry through Apify (residential first) proxy automatically. ## `proxyConfiguration` (type: `object`): Optional Apify proxy configuration override. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "byTrail", "url": "https://www.alltrails.com/trail/us/california/half-dome-trail", "urls": [], "country": "us", "difficulty": "", "routeType": "", "activity": "", "fetchTrailDetails": true, "useProxy": false, "autoEscalateOnBlock": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] }, "maxItems": 25 } ```` # Actor output Schema ## `records` (type: `string`): Dataset containing all scraped AllTrails 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": "byTrail", "url": "https://www.alltrails.com/trail/us/california/half-dome-trail", "urls": [], "country": "us", "fetchTrailDetails": true, "useProxy": false, "autoEscalateOnBlock": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] }, "maxItems": 25 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/alltrails-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": "byTrail", "url": "https://www.alltrails.com/trail/us/california/half-dome-trail", "urls": [], "country": "us", "fetchTrailDetails": True, "useProxy": False, "autoEscalateOnBlock": True, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": [], }, "maxItems": 25, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/alltrails-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": "byTrail", "url": "https://www.alltrails.com/trail/us/california/half-dome-trail", "urls": [], "country": "us", "fetchTrailDetails": true, "useProxy": false, "autoEscalateOnBlock": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] }, "maxItems": 25 }' | apify call crawlerbros/alltrails-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/alltrails-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AllTrails Scraper", "description": "Scrape AllTrails, the world's largest hiking, biking, and running trail database. Search trails by keyword/location; fetch full trail detail (difficulty, distance, elevation, GPS coordinates, photos, recent reviews); browse trails by park, city, or country.", "version": "1.1", "x-build-id": "Cuds6baHSlcYCXdlA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~alltrails-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-alltrails-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~alltrails-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-alltrails-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~alltrails-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-alltrails-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": [ "byTrail", "byUrl", "searchTrails", "byPark", "byCity", "topTrailsByCountry" ], "type": "string", "description": "Which discovery axis to use.", "default": "byTrail" }, "url": { "title": "URL", "type": "string", "description": "An alltrails.com URL — trail, park, city, or country page. Used by mode=byTrail/byPark/byCity/byUrl/topTrailsByCountry.", "default": "https://www.alltrails.com/trail/us/california/half-dome-trail" }, "urls": { "title": "URLs (mode=byUrl, batch)", "type": "array", "description": "Multiple alltrails.com URLs. Trail/park/city/country URLs are auto-routed.", "default": [], "items": { "type": "string" } }, "query": { "title": "Search query (mode=searchTrails)", "type": "string", "description": "Free-text query, e.g. `yosemite`, `coastal hike california`." }, "country": { "title": "Country", "enum": [ "us", "canada", "mexico", "united-kingdom", "ireland", "france", "germany", "spain", "portugal", "italy", "switzerland", "austria", "netherlands", "belgium", "denmark", "sweden", "norway", "finland", "iceland", "poland", "czech-republic", "greece", "australia", "new-zealand", "japan", "south-korea", "thailand", "vietnam", "indonesia", "philippines", "india", "south-africa", "morocco", "egypt", "kenya", "tanzania", "argentina", "brazil", "chile", "colombia", "costa-rica", "peru", "ecuador", "uae", "turkey", "israel", "russia", "china" ], "type": "string", "description": "Country slug used by AllTrails URLs and for search index selection. `us` is the default.", "default": "us" }, "state": { "title": "State / region slug", "type": "string", "description": "State slug (e.g. `california`, `new-york`). Used with byPark/byCity/byTrail." }, "city": { "title": "City slug (mode=byCity)", "type": "string", "description": "City slug (e.g. `san-francisco`, `los-angeles`)." }, "trailSlug": { "title": "Trail slug (mode=byTrail)", "type": "string", "description": "Trail slug — the part after the state in the URL." }, "parkSlug": { "title": "Park slug (mode=byPark)", "type": "string", "description": "Park slug, e.g. `yosemite-national-park`." }, "difficulty": { "title": "Difficulty", "enum": [ "", "easy", "moderate", "hard" ], "type": "string", "description": "Filter by AllTrails difficulty band.", "default": "" }, "routeType": { "title": "Route type", "enum": [ "", "out_and_back", "loop", "point_to_point" ], "type": "string", "description": "Filter by trail route type.", "default": "" }, "activity": { "title": "Activity", "enum": [ "", "hiking", "trail-running", "running", "mountain-biking", "biking", "road-biking", "walking", "backpacking", "camping", "rock-climbing", "via-ferrata", "horseback-riding", "snowshoeing", "cross-country-skiing", "skiing", "fishing", "birding", "off-road-driving", "scenic-driving", "paddle-sports", "nature-trips", "bike-touring" ], "type": "string", "description": "Filter by primary activity. Trails matching this activity in their `activities` array pass.", "default": "" }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Drop trails with avgRating below this (0-5)." }, "minLengthKm": { "title": "Minimum length (km)", "minimum": 0, "maximum": 1000, "type": "number", "description": "Drop trails shorter than this length (km)." }, "maxLengthKm": { "title": "Maximum length (km)", "minimum": 0, "maximum": 1000, "type": "number", "description": "Drop trails longer than this length (km)." }, "fetchTrailDetails": { "title": "Fetch full trail detail per result", "type": "boolean", "description": "For listing modes (byPark/byCity/topTrailsByCountry/byUrl-listing), fetch the full trail detail page for every trail. Disable to emit lightweight stubs faster.", "default": true }, "useProxy": { "title": "Use Apify proxy", "type": "boolean", "description": "Route requests through Apify proxy. AllTrails works without a proxy in most cases; auto-escalation handles 403/429 transparently.", "default": false }, "autoEscalateOnBlock": { "title": "Auto-escalate to proxy on block", "type": "boolean", "description": "If direct fetches return 403/429/Cloudflare-challenge, retry through Apify (residential first) proxy automatically.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify proxy configuration override.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 25 } } }, "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 } } } } } } } } } } ```