Use a stock ticker as a brand identifier

Pass a ticker symbol where you'd normally pass a brand name — the API resolves it to the canonical brand automatically.

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

Returns the same response as {"brand":"Starbucks"}. The brand field in the JSON body still echoes the canonical name, not the ticker — useful when you want to confirm the resolution.

Why use tickers

Stable — brands occasionally rename ("Snap Inc." used to be "Snapchat"); tickers don't.
Unambiguous — DPZ is one company; "Domino's" hits both Domino's Pizza and Domino's Sugar.
Programmatic — if your data already keys on tickers (financial dashboards, EDGAR feeds), one less translation step.

Multi-brand tickers

A few tickers map to brand portfolios. The current behaviour: ticker → primary brand. For example, YUM (Yum! Brands) currently maps to Taco Bell as the primary location lookup. To get all three Yum! brands, query each separately:

for brand in "Taco Bell" "KFC" "Pizza Hut"; do
  curl -X POST https://api.brandmappr.com/api/v1/location-map \
    -H "x-api-key: $KEY" -H "Content-Type: application/json" \
    -d "{\"brand\":\"$brand\"}" -o "${brand// /_}.json"
done

Currently mapped

145 tickers map to canonical brands. The list grows over time. To check whether a ticker is mapped, use the autocomplete endpoint:

curl "https://api.brandmappr.com/api/v1/brands/search?q=SBUX"

If the ticker isn't recognised, you'll get a 404 with did you mean suggestions for similar canonical names.

Combining with filters

Tickers work everywhere a brand name does — same country, state, city, format, and focus_country semantics:

-d '{"brand":"MCD","country":"US","state":"TX","format":"png","focus_country":"US"}'

Map several tickers at once

Pass an array of up to five tickers as tickers (instead of brand) to plot multiple companies on one image, each in its own marker color. Great for side-by-side footprint comparisons — add include_legend to label which color is which:

-d '{"tickers":["SBUX","MCD"],"country":"US","format":"png","include_legend":true}'

What gets billed

The ticker lookup itself is free. Credits charge on the result count + format multiplier exactly as if you'd passed the canonical name. See Billing & Credits.

Render a styled map image Billing & Credits