Reviews

AllTrails Trails

AllTrails trail data: every trail worldwide with stats, difficulty, ratings, route geometry, reviews and photos, for outdoor apps, tourism research and mapping.

alltrails-trailsalltrailstrailshikingoutdoorsreviewsphotosgps

0 rows in the dataset

Download the dataset

Get the full dataset as one CSV or JSONL file. If the data is older than maxAgeHours, it is refreshed automatically first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/alltrails-trails/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

This is a Enterprise dataset: 4 credits per 100 rows cached and 8 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To get exactly the targets you want, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/alltrails-trails/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "boundingBoxes": [        "24.6",        "55.7",        "25.6",        "56.5"      ],      "trailIds": [        "10703164"      ],      "includeReviews": true,      "maxReviewsPerTrail": 200    }  }'

A run is billed at the live rate once it finishes: 8 credits per 100 rows it collected ($4.8, down to $1.2 in volume per 1,000 rows). A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

boundingBoxes
string[]
Bounding boxes
south,west,north,east in degrees. Every trail in each box is collected. Leave empty to cover the whole world.
Default
none
Example
24.6,55.7,25.6,56.5
trailIds
string[]
Trail ids
Collect exactly these trails and skip the area search. The id is in the trail row.
Default
none
Example
10703164

Content

includeReviews
boolean
Include reviews
Default
true
maxReviewsPerTrail
number
Max reviews per trail
Reviews are stored on the trail row, so this keeps rows compact. review_count always holds the full total.
Default
200
Range
0 to 2000
Only applies when includeReviews is true.
includePhotos
boolean
Include photos
Default
true
maxPhotosPerTrail
number
Max photos per trail
Default
200
Range
0 to 2000
Only applies when includePhotos is true.

Advanced

maxTrails
number
Max trails per run
Caps a single run. Rows are updated in place, so the dataset keeps growing across runs.
Default
10000000
Range
1 to 10000000
requestDelayMs
number
Delay between requests (ms)
Pause between requests. The default is tuned for reliable, complete runs.
Default
1500
Range
0 to 60000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "boundingBoxes": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Bounding boxes",      "description": "south,west,north,east in degrees. Every trail in each box is collected. Leave empty to cover the whole world.",      "default": [],      "examples": [        "24.6,55.7,25.6,56.5"      ]    },    "trailIds": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Trail ids",      "description": "Collect exactly these trails and skip the area search. The id is in the trail row.",      "default": [],      "examples": [        "10703164"      ]    },    "includeReviews": {      "type": "boolean",      "title": "Include reviews",      "default": true    },    "maxReviewsPerTrail": {      "type": "number",      "minimum": 0,      "maximum": 2000,      "title": "Max reviews per trail",      "description": "Reviews are stored on the trail row, so this keeps rows compact. review_count always holds the full total.",      "default": 200    },    "includePhotos": {      "type": "boolean",      "title": "Include photos",      "default": true    },    "maxPhotosPerTrail": {      "type": "number",      "minimum": 0,      "maximum": 2000,      "title": "Max photos per trail",      "default": 200    },    "maxTrails": {      "type": "number",      "minimum": 1,      "maximum": 10000000,      "title": "Max trails per run",      "description": "Caps a single run. Rows are updated in place, so the dataset keeps growing across runs.",      "default": 10000000    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "description": "Pause between requests. The default is tuned for reliable, complete runs.",      "default": 1500    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/alltrails-trails/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "boundingBoxes": [        "24.6",        "55.7",        "25.6",        "56.5"      ],      "trailIds": [        "10703164"      ],      "includeReviews": true,      "maxReviewsPerTrail": 200    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

The fields this scraper delivers. Coverage is the share of rows that include each field.

The output fields appear here after the first run. Start a run to see them.