stcp-api 2.0.0

Unofficial API to retrieve STCP information for public transit buses in Porto, Portugal

STCP API

Unofficial API to retrieve STCP information for public transit buses in Porto, Portugal.

Retrieves static data about routes, stops, locations, and real-time estimates of bus arrivals.

Since it's based on a non-official API, it may stop working in the future. Confirmed working as of 1 December 2025.

See the files at stcp/routes.py, stcp/stops.py and stcp/util.py for the complete documentation, and examples.md for usage examples.

Available operations

Routes

Function	Description
get_routes	list of all STCP routes.
get_route_directions	list of directions (usually 2) of a route.
get_route_stops	list of all stops of a route in a direction.
get_route_services	the service days of a route.
get_route_schedule	schedule of a route in a direction.
get_route_real_time	all buses running on a given route and their next stop.

Stops

Function	Description
get_stops	list of all stops.
get_stop_data	data about a stop and its routes
get_stop_schedule	schedule of stop
get_stop_real_time	real-time list of buses passing through a stop soon (up to one hour from the current time).

Utilities

Function	Description
get_route_data	combines route_directions, route_stops in all directions, and route_services .
get_stop_route_departures	gets a map of upcoming departures of a stop, grouped by route.
get_full_route_times	gets the current times for a given route.