{ "openapi": "3.0.1", "info": { "title": "Komoot Hiking & Outdoor Routes Scraper", "description": "Scrape Komoot hiking, cycling and MTB routes without login. Export trail data to CSV/JSON by location, coordinates or tour ID via an unofficial Komoot API.", "version": "1.0", "x-build-id": "YQf0bkiXvAixNJCQk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~komoot-hiking-outdoor-routes-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-komoot-hiking-outdoor-routes-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/logiover~komoot-hiking-outdoor-routes-scraper/runs": { "post": { "operationId": "runs-sync-logiover-komoot-hiking-outdoor-routes-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/logiover~komoot-hiking-outdoor-routes-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-komoot-hiking-outdoor-routes-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": { "mode": { "title": "Mode", "enum": [ "location", "coords", "tours" ], "type": "string", "description": "How to search for routes. Use 'location' to search by place name (geocoded automatically), 'coords' to search by exact latitude/longitude, or 'tours' to fetch specific routes by their Komoot tour ID.", "default": "location" }, "location": { "title": "Location", "type": "string", "description": "Place name to search around. Used when mode is 'location'. Examples: 'Munich', 'Swiss Alps', 'Antalya', 'Dolomites', 'Black Forest'. The scraper geocodes this name and tiles the search radius with overlapping grid points. Leave empty to browse popular routes around the Alps (Innsbruck) as a sensible default." }, "lat": { "title": "Latitude", "type": "number", "description": "Latitude of the search center point. Used when mode is 'coords'. Example: 48.137154 (Munich). Must be combined with the Longitude field.", "default": null }, "lng": { "title": "Longitude", "type": "number", "description": "Longitude of the search center point. Used when mode is 'coords'. Example: 11.576124 (Munich). Must be combined with the Latitude field.", "default": null }, "tourIds": { "title": "Tour IDs", "type": "array", "description": "List of specific Komoot tour IDs to fetch. Used when mode is 'tours'. Find the ID in the URL: komoot.com/tour/1234567 → enter 1234567. Multiple IDs can be added.", "default": [], "items": { "type": "string" } }, "sport": { "title": "Sport / Activity", "enum": [ "hike", "mtb", "racebike", "touringbicycle", "jogging", "e_mtb", "e_touringbicycle" ], "type": "string", "description": "Activity type to filter routes by. Applies to all modes. 'hike' returns walking and trekking routes, 'mtb' returns mountain bike trails, 'racebike' returns road cycling routes.", "default": "hike" }, "maxDistance": { "title": "Search Radius (meters)", "minimum": 1000, "type": "integer", "description": "Radius in meters around the location or coordinates to search for routes. Default is 50,000 m (50 km). Larger values produce more grid points and more API requests. Maximum effective value per API call is 30,000 m — the scraper tiles automatically.", "default": 50000 }, "difficulty": { "title": "Difficulty", "enum": [ "", "easy", "moderate", "difficult" ], "type": "string", "description": "Filter routes by difficulty level. Leave empty to return routes of all difficulties. 'easy' suits beginners, 'moderate' requires some fitness, 'difficult' is for experienced athletes.", "default": "" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of routes to save to the dataset. Set to 0 for unlimited. Note: actual results depend on availability in the search area.", "default": 100 } } }, "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 } } } } } } } } } }