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 43,000+ locations across 80+ countries. No pagination, no retries, no second call to count first.

Data formats require an enterprise plan. json / csv / geojson responses are available to enterprise (and internal unlimited) keys only. Standard self-service tiers and trial keys are image-only — and since format defaults to json, an unannotated request like the one above returns 403 DATA_ACCESS_FORBIDDEN on those keys. Set format to png / jpeg, or buy a one-time data export at brandmappr.com (opens in a new tab). See Data Coverage for the full access policy.

What's in the response

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

Every row carries lat/lng plus best-effort address fields — country is always present (backfilled via point-in-polygon where a source tagged it loosely); state, city, postcode, and address are best-effort. Sold data is reconciled from Overture, Foursquare, and All The Places and excludes OpenStreetMap-origin rows; map images include all sources.

Cost

Credits scale with the result count and the format. See Billing & Credits for the tier table — for a 43K-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": 43437 }
  ]
}

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