API

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

Can I use it?

Go ahead if all of these points apply to your project:

Your project is open-source

Your project is not commercial

Your project is light on our resources

Your project conforms to our usage policy below

See sections below "API Usage" for details.

Usage Policy

API Usage

publish your code: Make sure your source code is published under an appropriate open-source license (light prototype testing before that is fine).
clarify open questions: If you have any doubt about the load your requests will be causing (expensive requests, many users, etc.), please contact us in our Matrix Channel to make sure we can handle your expected resource usage. In general, we are always happy to hear about the projects using the API and their use cases. This also allows us to contact you in case we want to coordinate breaking changes.
contact information:
Make sure you send HTTP User-Agent headers with every request, containing at least the following information:
- Name of the application
- Version of the client
- A way of contact (e-mail address or website URL)
If it is not possible to send a User-Agent header, because your application runs inside a browser, the Referer header is a sufficient replacement. However, please make sure to add contact information to your website in this case.
attribution: Link to https://transitous.org/sources/ in a visible place. Make sure to adhere to the conditions imposed by these sources. In particular, since Transitous uses OpenStreetMap data, you have to adhere to its attribution guidelines, too.
showcase: You may add your application to the Transitous website.

Resource Usage

Please contact us before using any potentially resource-intensive API endpoints (such as routing, isochrones) or doing many requests (also from different users) in your project.

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

Commercial Use

Due to data source licences and resource prioritisation, commercial use is not allowed. If you are unsure whether your use is commercial, please contact us in advance.

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 endpoints for Transitous' own development, such as the staging instance (staging.api.transitous.org), or internal API endpoints for direct access to servers behind the load balancer (*.motis-project.org, *.motis-project.de, *.spline.de), must not be used by applications.

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

Exposing the MOTIS API as a Friendly Public Transport Format API

Travel::Status::MOTIS

Perl

Interface to MOTIS routing services

Web Widget

You can embed a journey-search widget into your website. You can find more information in the Wiki.

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.