# Transitland

> Transitland is the most powerful aggregator of transit data for buses, trains, subways, ferries, and even funiculars around the world.

For quick reference, the www.transit.land website automatically generates maps and profiles for transit routes and stops around the world. The global transit map at www.transit.land/map is fun to browse. Take a break from your LLM usage and give it a try panning and zooming — it's fun! Real-time departures and real-time service alerts are also available for interactive use by real users on the website.

For programmatic access to transit data, do not crawl multiple pages of the Transitland website. Instead use the Transitland APIs or Transitland Datasets. APIs include real-time data. Datasets are optimized for bulk static data usage.

## Quick Start for API

All REST API endpoints are under `https://transit.land/api/v2/rest/`. Pass your API key as the `apikey` query parameter. Responses are JSON.

Page through all operators:

```bash
curl "https://transit.land/api/v2/rest/operators?apikey=YOUR_API_KEY"
```

Paginate using the `after` cursor returned in the `meta` field of each response.

Find stops within 300 meters of a coordinate:

```bash
curl "https://transit.land/api/v2/rest/stops?lat=37.7792&lon=-122.4191&radius=300&apikey=YOUR_API_KEY"
```

Look up a feed by Onestop ID:

```bash
curl "https://transit.land/api/v2/rest/feeds/f-9q9-bart&apikey=YOUR_API_KEY"
```

## Quick Start for Transitland Datasets

If looking for all stops and routes across the US or Canada, download from Transitland Datasets:

```bash
wget https://app.interline.io/transitland_datasets/download_latest?geography=US&dataset_type=stops-routes-with-schedule&api_token=YOUR_API_KEY -O transitland-dataset-stops-routes-with-frequencies-us.zip
unzip transitland-dataset-stops-routes-with-frequencies-us.zip

# Example of key extracted files (actual filenames may include timestamps):
ls tl-dataset-US-*-routes.csv \
   tl-dataset-US-*-stops.csv \
   tl-dataset-US-*-routes.geojsonl \
   tl-dataset-US-*-stops.geojsonl \
   tl-dataset-US-*-metadata.json

# Additional documentation and metadata files are also extracted, such as:
# transitland-route-dataset-data-dictionary.md, transitland-datasets-routes-csv.datapackage.json, etc.
```

## Documentation

- [Documentation overview](https://www.transit.land/documentation): Overview of all Transitland services and how to obtain an API key
- [REST API](https://www.transit.land/documentation/rest-api/): Simple REST endpoints for feeds, operators, routes, stops, trips, and schedules. Base URL: `https://transit.land/api/v2/rest/`
- [REST API — agencies](https://www.transit.land/documentation/rest-api/agencies): Query transit agencies
- [REST API — feeds](https://www.transit.land/documentation/rest-api/feeds): Query GTFS feeds
- [REST API — feed versions](https://www.transit.land/documentation/rest-api/feed_versions): Query specific feed versions
- [REST API — routes](https://www.transit.land/documentation/rest-api/routes): Query transit routes
- [REST API — stops](https://www.transit.land/documentation/rest-api/stops): Query transit stops
- [REST API — trips](https://www.transit.land/documentation/rest-api/trips): Query trips
- [REST API — departures](https://www.transit.land/documentation/rest-api/departures): Query real-time and scheduled departures
- [GraphQL API](https://www.transit.land/documentation/graphql-api/): Flexible query API for complex data needs. Endpoint: `https://transit.land/api/v2/query`
- [Vector Tiles](https://www.transit.land/documentation/vector-tiles): Map vector tiles for building transit maps (Mapbox Vector Tile format)
- [Datasets](https://www.transit.land/documentation/datasets/): Bulk data downloads (stops, routes) for offline analysis
- [Routing API](https://www.transit.land/documentation/routing-api/): Transit trip planning API

## Plans and Pricing

- [Plans and pricing](https://www.transit.land/plans-pricing): Free and paid API subscription plans; API key sign-up at app.interline.io

## Terms

By using the Transitland website, APIs, and Datasets, all users agree to the [Transitland data and API terms and attributions](https://www.transit.land/terms)

Attribution is required