API

Usage Policy

Transitous is provided by a community of volunteers to fulfill the needs of Free and Open Source applications and other non-profit activities. We provide the service on a best-effort basis and reserve the right to stop providing it to any consumer at any time.

Resource Usage

Our hosting resources are limited. Please contact us before doing any potentially resource-intensive operations, such as many requests (also from different users) or primarily difficult to calculate requests (such as routing, isochrones). Generally, if your requests take long, they are difficult to calculate.

We'll try to find ways to accommodate your use. Should we hit the limits of what we can handle with our current resources, there's also the option to self-host your own instance of Transitous.

There is no need to scrape data using the API, you may download our entire source dataset here.

API Usage

If you want to use the API for your free and open-source application, please:

  • Contact us in our Matrix Channel to make sure we can handle your expected resource usage and so we are aware of your usecases. This also allows us to contact you in case we want to coordinate breaking changes.
  • Make sure your send HTTP User-Agent or X-Client-Identification headers with every request, at least containing the following information:
    • Name of the application
    • Version of the client implementation
    • A way of contact (e-mail address or website URL)
  • You may add your application to the Transitous website

Commercial Use

Transitous is not intended for commercial or for-profit purposes. If you are not sure whether your use qualifies, please contact us. We will make a decision on a case-by-case basis.

MOTIS 2 API

Transitous provides the MOTIS 2 API. It is the first stable and versioned MOTIS API, and is incompatible with previous development versions of the API.

Our API endpoint is located at https://api.transitous.org/api/.

API Documentation

Client Libraries

KPublicTransport
C++ Qt LGPL

A library for accessing realtime public transport data and for performing public transport journey queries.

motis-client
JS TS

Pre-generated JS client for MOTIS based on the OpenAPI definition

motis-fptf-client
JS

Exposing the MOTIS API as a Friendly Public Transport Format API

Travel::Status::MOTIS
Perl

Interface to MOTIS routing services

Staging API

MOTIS releases are tested with our data before deploying them to the main API endpoint.

You can test the almost-latest MOTIS release on https://staging.api.transitous.org/api/.

Please note that full planet-wide OpenStreetMap data is not available there. The web interface is currently shared between stable and the staging instance, and does not represent the featureset available in the MOTIS version.