PlugShare stations in a map area
EV charging locations inside a map box (centre plus height and width in degrees), with every filter of the PlugShare map. Each location: id, name, link, address, coordinates, access, PlugScore, fast-charger flag, connector types, station counts (total, available, in use), coming-soon and repair flags, network logo, and each station's outlets (connector, kW, AC/DC, live status). Up to 125 locations per call, the ones the map shows for that box; zoom in (smaller spans) for dense areas. Home chargers shared by private people are never returned.
Every response includes credits_used: the credits this call cost.
Part of the PlugShare API: 10 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
latituderequired | number | Latitude of the point. Example: 37.7749 |
longituderequired | number | Longitude of the point. Example: -122.4194 |
span_lat | number | Box height in degrees of latitude (default 0.1, max 5). Example: 0.05 |
span_lng | number | Box width in degrees of longitude (default 0.1, max 5). Example: 0.05 |
connectors | string | Connector type ids, comma-separated (from /plugshare/v1/filters, e.g. 13 = CCS1, 26 = NACS (Tesla), 2 = J-1772, 3 = CHAdeMO). |
min_power | integer | Minimum charging power in kW. |
max_power | integer | Maximum charging power in kW. |
networks | string | Only these network ids, comma-separated (from /plugshare/v1/networks). |
exclude_networks | string | Leave out these network ids, comma-separated. |
min_stations | integer | At least this many stations at the location. |
free_only | boolean | Only locations that are free to use. |
available_now | boolean | Only locations with a station reported available now. |
min_plugscore | integer | Minimum PlugScore (1-10). |
amenities | string | Amenity ids, comma-separated (1 Lodging, 2 Dining, 3 Restrooms, 4 EV Parking, 5 Valet Parking, 6 Park, 7 WiFi, 8 Shopping, 9 Grocery, 10 Hiking, 11 Camping). |
parking | string | Parking attribute ids, comma-separated (e.g. COVERED, GARAGE, PULL_IN, PULL_THROUGH; see /plugshare/v1/filters). |
places | string | Only these place types, comma-separated (e.g. HOTEL, AIRPORT, GROCERY_STORE; see /plugshare/v1/filters). |
exclude_places | string | Leave out these place types, comma-separated. |
exclude_dealerships | boolean | Leave out car dealerships. |
include_restricted | boolean | false: public locations only (default true: also locations restricted to customers, guests, residents...). |
coming_soon | include | only | exclude | include (default), only, or exclude locations that are not open yet. |
exclude_tesla_only | boolean | Leave out locations only Tesla drivers can use. |
exclude_rivian_only | boolean | Leave out locations only Rivian drivers can use. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/plugshare/v1/map?latitude=37.7749&longitude=-122.4194" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/plugshare/v1/map",
params={"latitude": "37.7749", "longitude": "-122.4194"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/plugshare/v1/map");
url.searchParams.set("latitude", "37.7749");
url.searchParams.set("longitude", "-122.4194");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"latitude": 37.7749,"longitude": -122.4194,"span_lat": 0.1,"span_lng": 0.1,"applied_filters": {"include_restricted": true},"count": 125,"locations": [{"id": 545097,"name": "Safeway","url": "https://www.plugshare.com/location/545097","address": "735 7th Ave, San Francisco, CA 94118, USA","latitude": 37.7750798651636,"longitude": -122.46508948865008,"access": "public","plugscore": 3.7,"fast_charger": true,"connector_types": ["CCS1","CHAdeMO"],"station_count": 4,"available_station_count": 2,"in_use_station_count": 1,"coming_soon": false,"under_repair": false,"icon_type": "Y","network_logo": "https://assets.plugshare.com/network-images/map_card_logos/evgo.png","stations": [{"id": 1441690,"network_id": 19,"outlets": [{"…": "7 fields"},{"…": "7 fields"}]},{"id": 1441691,"network_id": 19,"outlets": [{"…": "7 fields"},{"…": "7 fields"}]},"… 2 more"]},{"id": 300847,"name": "Lucky","url": "https://www.plugshare.com/location/300847","address": "1750 Fulton St, San Francisco, CA 94117, USA","latitude": 37.77604,"longitude": -122.44565,"access": "public","plugscore": 9.6,"fast_charger": true,"connector_types": ["CCS1","CHAdeMO"],"station_count": 2,"available_station_count": 2,"in_use_station_count": 0,"coming_soon": false,"under_repair": false,"icon_type": "Y","network_logo": "https://assets.plugshare.com/network-images/map_card_logos/evgo.png","stations": [{"id": 684607,"network_id": 19,"outlets": [{"…": "7 fields"},{"…": "7 fields"}]},{"id": 684684,"network_id": 19,"outlets": [{"…": "7 fields"},{"…": "7 fields"}]}]},"… 123 more"],"cached": false,"credits_used": 1}