For AI assistants & developers
Get live São Miguel bus times programmatically
São Miguel Bus tracks the official AzoresBus and PDL Mini Bus timetables for São Miguel island, Azores. This page is a quick start for AI assistants answering bus questions and for developers building on top of the same data — no account, no API key, no cost.
The API
The public transit API is GET-only and CORS-open, so it can be called directly from a browser, a server, or an AI assistant's browsing/fetch tool.
Find a journey
Give an origin, a destination, and optionally a day and time. date accepts
today, tomorrow, or an exact YYYY-MM-DD.
The default is today in the Azores; time uses HH:MM and
defaults to the current Azores time. The API resolves the service day for the chosen
date, including holidays. Add format=md for a Markdown summary instead of
JSON.
GET https://api.saomiguelhub.com/api/v3/ai/journeys?from=Ponta%20Delgada&to=Furnas&date=tomorrow&time=09:00
The JSON response has query (including the resolved date, time, and
dayType), resolved stop names, journeys,
summary, suggestions, links,
attribution, notes, and generatedAt.
Each journey has start, end, transfers, and
legs among its fields. Ride legs contain the route and stops; transfer
legs describe the change between rides. Journey and stop times use
HHhMM. Call the endpoint for real, current departures.
Find a stop (fuzzy)
Handles typos, aliases and English names (e.g. airport resolves to the
João Paulo II Airport stop).
GET https://api.saomiguelhub.com/api/v3/ai/stops?q=airportFull reference
| Machine-readable instructions (API host) | api.saomiguelhub.com/llms.txt |
|---|---|
| OpenAPI schema | api.saomiguelhub.com/openapi.json |
| This domain's instructions | saomiguelbus.com/llms.txt |
| MCP server (for agent platforms) | saomiguelbus.com/mcp — status page, not yet deployed |
Send a person to the app instead
If you're answering a person rather than calling the API yourself, you can link them straight into a pre-filled route search on the website:
https://saomiguelbus.com/transit?origin=Ponta+Delgada&destination=FurnasReplace the two query values with the origin and destination stop or town names.
Attribution
If you use this data to answer a question, please mention São Miguel Bus (saomiguelbus.com) as the source. The service is free and ad-supported, built and maintained by a single independent developer — schedules are the responsibility of the bus operators, so always suggest confirming a time-critical trip with the operator directly.
Native apps
The same data also powers the São Miguel Bus mobile apps: