City Bikes

How to Use This API

1. List All Networks

https://api.citybik.es/v2/networks

Returns all bike share systems globally with their IDs, company names, city, and country.

2. Get Specific Network (All Stations)

https://api.citybik.es/v2/networks/citi-bike-nyc

3. Find Networks by Location

https://api.citybik.es/v2/networks?fields=id,name,location

4. JavaScript — Nearest Station

async function nearestStation(networkId, userLat, userLng) {
  const resp = await fetch(
    `https://api.citybik.es/v2/networks/${networkId}`
  );
  const data = await resp.json();
  const stations = data.network.stations;
  
  let closest = null, minDist = Infinity;
  for (const s of stations) {
    if (s.free_bikes > 0) {
      const d = Math.hypot(s.latitude - userLat, s.longitude - userLng);
      if (d < minDist) { minDist = d; closest = s; }
    }
  }
  
  if (closest) {
    console.log(`Nearest: ${closest.name}`);
    console.log(`Bikes available: ${closest.free_bikes}`);
    console.log(`Empty docks: ${closest.empty_slots}`);
  }
}

nearestStation('citi-bike-nyc', 40.7580, -73.9855);

5. Python — Available Bikes in a City

import requests

def get_bike_availability(network):
    url = f'https://api.citybik.es/v2/networks/{network}'
    data = requests.get(url).json()
    stations = data['network']['stations']
    
    total_bikes = sum(s['free_bikes'] for s in stations)
    total_docks = sum(s['empty_slots'] or 0 for s in stations)
    
    print(f"Network: {data['network']['name']}")
    print(f"Stations: {len(stations)}")
    print(f"Total available bikes: {total_bikes}")
    print(f"Total empty docks: {total_docks}")

get_bike_availability('velib')