Export to CSV or GeoJSON

Set format to get the same data in spreadsheet-friendly CSV or GIS-ready GeoJSON instead of JSON. Same query shape, same filters, same credit cost — only the wire format changes.

CSV

curl -X POST https://api.brandmappr.com/api/v1/location-map \
  -H "x-api-key: $KEY" -H "Content-Type: application/json" \
  -d '{"brand":"Starbucks","country":"US","state":"CA","format":"csv"}' \
  -o starbucks-ca.csv

You get a header row plus one row per location:

brand,name,lat,lng,country,state,city,postcode,address
Starbucks,Starbucks Coffee,37.7749,-122.4194,US,CA,San Francisco,94102,123 Market St
...

Open directly in Excel, Numbers, Google Sheets, or pipe to awk/csvkit.

GeoJSON

-d '{"brand":"Starbucks","country":"US","state":"CA","format":"geojson"}' \
  -o starbucks-ca.geojson

Standard FeatureCollection with one Point feature per location. The address fields are in properties:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [-122.4194, 37.7749] },
      "properties": {
        "brand": "Starbucks",
        "name": "Starbucks Coffee",
        "address": "123 Market St",
        "city": "San Francisco",
        "state": "CA",
        "country": "US",
        "postcode": "94102",
        "phone": "+1-415-555-0100",
        "last_updated": "2026-04-03T17:23:28.022+00:00"
      }
    }
  ]
}

Drop straight into QGIS, ArcGIS, Mapbox Studio, Leaflet, or ogr2ogr for format conversion.

Format choice

Format	Best for	Credit multiplier
`json`	Programmatic consumption	1×
`csv`	Spreadsheets, data pipelines	1×
`geojson`	GIS tools, web maps	1×
`png` / `jpeg`	Reports, decks	2×

Data formats (json/csv/geojson) all charge 1× the base tier; image formats charge 2×. See Billing & Credits for tier breakpoints.

Coordinate order gotcha

GeoJSON is [lng, lat]. JSON and CSV are lat, lng. This is a longstanding GeoJSON convention — every GIS tool expects it that way. If you're round-tripping through your own code, watch for swapped coordinates.

Filter locations to a region Render a styled map image