Get every location for a brand

The default query — one POST, every known location for the brand.

curl -X POST https://api.brandmappr.com/api/v1/location-map \
  -H "x-api-key: bm_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"brand":"Starbucks"}'

You get a JSON array of every Starbucks the API has indexed — typically 18,000+ locations across 80+ countries. No pagination, no retries, no second call to count first.

What's in the response

{
  "brand": "Starbucks",
  "count": 18212,
  "locations": [
    {
      "name": "Starbucks Coffee",
      "lat": 47.6062,
      "lng": -122.3321,
      "country": "US",
      "state": "WA",
      "city": "Seattle",
      "address": "Pike Place Market",
      "postcode": "98101"
    }
    // ... 18,211 more
  ]
}

Every row carries lat/lng plus whatever address fields OpenStreetMap had — country is always present (we backfill it via point-in-polygon for rows OSM tagged loosely); state, city, postcode, and address are best-effort.

Cost

Credits scale with the result count and the format. See Billing & Credits for the tier table — for an 18K-location result in JSON the charge is 8 credits.

When you don't need every location

If you only need one country or one city, filter at query time — it's cheaper and faster. See Filter locations to a region.

Brand not found?

A 404 response includes typo-tolerant suggestions when there's a close match:

{
  "error": "No locations found for brand: Strabucks",
  "code": "NOT_FOUND",
  "suggestions": [
    { "brand": "Starbucks", "location_count": 18212 }
  ]
}

To check first, hit the /api/v1/brands/search autocomplete endpoint, or use a stock ticker if the brand is publicly traded.