Skip to main content

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

Project description

STCP API

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

Retrieves static data about lines, 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 24 February 2024.

See the file at stcp/api.py for the complete documentation.

Available operations

Function Description
get_lines gets a list of all STCP lines
get_line_directions gets a list of directions (usually 2) of a line.
get_line_stops gets a list of all stops of a line.
get_stop_data gets information about a stop, including a list of all the lines that pass through it.
get_stop_real_times gets a real-time list of buses passing through a stop soon (up to one hour from the current time).

Notes

To be able to get a stop's real-time departures, a "hash" is needed, which can be obtained by scraping STCP's webpage. These hashes are stored in a local CSV cache for efficiency purposes, which is generated on the first execution. However, the cache can be disabled, and the hash request can be made on the fly, by passing use_hash_cache=False to the get_stop_real_times function.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stcp_api-1.1.0.tar.gz (16.7 kB view hashes)

Uploaded Source

Built Distribution

stcp_api-1.1.0-py3-none-any.whl (17.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page