PlugShare station search

GET https://api.api.sh/plugshare/v1/search
1 credit / call automotive try it in the playground →

Charging locations whose name or description matches the keywords, nearest the given point first (default: the centre of the US), with the map filters.

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

nametypedescription
queryrequired string Keywords, e.g. a business or network name. Example: Supercharger
latitude number Latitude to rank results from. Example: 37.7749
longitude number Longitude to rank results from. Example: -122.4194
limit integer Locations to return (1-50, default 20). Example: 20
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/search?query=Supercharger" \
  -H "x-api-key: $APISH_KEY"

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)

{"query": "Supercharger","latitude": 39.8283,"longitude": -98.5795,"applied_filters": {"include_restricted": true},"count": 20,"locations": [{"id": 2123039,"name": "Tower Road - Tesla Superchargers (Coming Soon)","url": "https://www.plugshare.com/location/2123039","address": "3450 Tower Road, Aurora, CO 80011","latitude": 39.763759,"longitude": -104.7717393,"distance_meters": 528972.564,"access": "public","plugscore": null,"fast_charger": true,"connector_types": ["CCS1","NACS (Tesla)"],"station_count": 6,"available_station_count": null,"in_use_station_count": null,"coming_soon": true,"under_repair": false,"icon_type": "YR","network_logo": null,"stations": [{"id": 3559632,"network_id": null,"outlets": [{"…": "7 fields"},{"…": "7 fields"}]},{"id": 3559633,"network_id": null,"outlets": [{"…": "7 fields"},{"…": "7 fields"}]},"… 4 more"]},{"id": 2301070,"name": "Billy Birch - Tesla Superchargers (Coming Soon)","url": "https://www.plugshare.com/location/2301070","address": "11915 Holly Street, Thornton, CO 80233","latitude": 39.9123478,"longitude": -104.9237843,"distance_meters": 541400.192,"access": "public","plugscore": null,"fast_charger": true,"connector_types": ["CCS1","NACS (Tesla)"],"station_count": 6,"available_station_count": null,"in_use_station_count": null,"coming_soon": true,"under_repair": false,"icon_type": "YR","network_logo": null,"stations": [{"id": 3777869,"network_id": null,"outlets": [{"…": "7 fields"},{"…": "7 fields"}]},{"id": 3777870,"network_id": null,"outlets": [{"…": "7 fields"},{"…": "7 fields"}]},"… 4 more"]},"… 18 more"],"cached": false,"credits_used": 1}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.