# Mapbox API

**Provider:** Mapbox
**Category:** maps
**Base URL:** `https://api.mapbox.com`
**Auth:** bearer — `?access_token=pk.eyJ1...`
**Rate Limit:** 600 requests/min
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://docs.mapbox.com/api

## Description

Mapbox provides a powerful suite of mapping APIs used by Snap, Strava, and Lonely Planet. Style custom maps, geocode addresses, generate turn-by-turn navigation, compute reachability isochrones, run matrix routing for logistics, and build real-time tracking applications.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.mapbox.com/geocoding/v5/mapbox.places/{query}.json` | Forward geocode a search query |
| GET | `https://api.mapbox.com/directions/v5/mapbox/{profile}/{coords}` | Get directions between coordinates |
| GET | `https://api.mapbox.com/isochrone/v1/mapbox/{profile}/{lonlat}` | Compute reachable area (isochrone) |
| GET | `https://api.mapbox.com/directions-matrix/v1/mapbox/{profile}` | Travel time/distance matrix |
| GET | `https://api.mapbox.com/styles/v1/{username}/{style_id}` | Retrieve a custom map style |

## Authentication

Pass your access token as a Bearer header or as the access_token query parameter.

```
?access_token=pk.eyJ1...
```

## Sample Request

```bash
curl "https://api.mapbox.com/geocoding/v5/mapbox.places/coffee.json?proximity=-87.6298,41.8781&access_token=$MAPBOX_TOKEN"
```

## Sample Response

```json
{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "geometry": {"type": "Point", "coordinates": [-87.6305, 41.8784]},
    "properties": {
      "place_name": "Intelligentsia Coffee, 53 E Randolph St, Chicago, IL",
      "relevance": 0.99
    }
  }]
}
```

## Pricing Details

Individual: free (10GB). Business Starter: $15/user/mo (unlimited storage). Business: $20/user/mo. Enterprise: custom.

---

*Source: [API Map](https://apimap.dev/apis/mapbox/) — CC BY 4.0*