What it returns
Live availability for public bike share systems that publish the open GBFS standard: Citi Bike, Divvy, Bluebikes, Capital Bikeshare, Vélib' and 1,200+ more systems listed in the MobilityData catalog. Systems that require a key are skipped.
Systems mode: system ID, name, city, country, website, GBFS feed and versions. Stations mode: system, station ID, name, address, latitude and longitude, capacity, bikes, e-bikes and disabled bikes, open and disabled docks, installed, renting and returning flags, last reported time, region, the operator's data licence link, and distance when you give a point.
Common uses
"Nearest bike" and "nearest open dock" features in apps, station rebalancing and outage alerts, mobility research and city dashboards, and comparing bike share coverage across cities.
Request
POST https://api.pushbuild.com/bike-share-stations/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
mode | string: systems, stations | systems lists bike share systems; stations returns live station availability for the chosen systems. Default: "stations". |
systemIds | list of strings | GBFS system IDs from systems mode, e.g. lyft_nyc (Citi Bike), bluebikes, lyft_chi (Divvy). Up to 10. |
search | string | Find systems by name or city, e.g. velib, Montreal. |
country | string | Two-letter country code, e.g. US, FR, DE. |
latitude | number | With longitude: only stations within the radius, nearest first. |
longitude | number | With latitude: only stations within the radius, nearest first. |
radiusKm | number | Search radius around the point. Default: 1. |
availableOnly | boolean | Skip stations with no bikes right now. Default: false. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/bike-share-stations/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"systemIds": ["lyft_nyc"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.08 per 1,000 stations · $0.08 per 1,000 systems. No charge for errors or empty searches.
Related APIs
Air Quality API
Official US air quality from EPA AirNow: current AQI and next-day forecasts for every US reporting area (plus US embassy cities abroad), and hourly readings from about 2,000 monitors: AQI, PM2.5, PM10, ozone, NO2, CO and SO2.
Airport Database API
80,000+ airports, heliports and seaplane bases worldwide: IATA and ICAO codes, name, type, city, region, country, latitude, longitude, elevation, scheduled service flag, website and Wikipedia link..
Baltic Ship Tracking API
Live AIS vessel positions in the Baltic Sea and Finnish waters: MMSI, IMO, ship name, call sign, ship type, destination, draught, latitude, longitude, speed, course, heading and navigation status..
Boston MBTA API
Live Boston MBTA data for subway, commuter rail, bus and ferry: real-time arrival and departure predictions by stop or route, service alerts with cause and effect, and stop locations..
Canada Travel Advisories API
Government of Canada travel advisories for every country: advisory level from normal precautions to avoid all travel, regional warnings flag, last published date and link..
EV Charging Station API
EV charging and alternative fuel stations in the US and Canada from the Department of Energy AFDC: network, Level 2 and DC fast ports, connector types, pricing, hours, access and location, by state, ZIP or distance from a point..
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com