Skip to main content

GET ./places/brands

Returns every brand (retail chain, franchise, operator) present in the search area, with a count of its places — and, where the brand is linked to Wikidata, its logo, official website, industry and parent organisation.

Example Request to GET all Brands in the US:

curl -H "x-api-key: DEMO-API-KEY" -X GET -G 'https://api.overturemapsapi.com/places/brands' \
-d 'country=US'

Brand Details from Wikidata​

Brands with a Wikidata QID are automatically enriched — no extra parameters needed:

{
"names": { "primary": "Bank of America" },
"wikidata": "Q487907",
"ext_wikidata_label": "Bank of America",
"ext_logo_url": "http://commons.wikimedia.org/wiki/Special:FilePath/Bank%20of%20America%20logo.svg",
"ext_website": "https://www.bankofamerica.com/",
"ext_industry": "financial sector",
"counts": { "places": 12 }
}
  • ext_logo_url is a Wikimedia Commons link; append ?width=200 for a resized image, ready for an <img> tag
  • ext_parent names the parent organisation where known
  • Wikidata data is CC0 (no attribution required); logo usage is subject to normal trademark law
  • Fields are simply absent for brands without a Wikidata link

To fetch the places of a specific brand, use /places with brand_wikidata (preferred) or brand_name — see Places.

Parameter reference​

Generated from the OpenAPI spec (operation listPlaceBrands). List brands (chains) with how many places each has, for a country or a lat/lng area. Use it to find the exact brand_name or brand_wikidata value to pass to GET /places, for example to map every location of a retail chain.

ParameterTypeDefaultDescription
latnumberLatitude coordinate. Required if country code is not provided.
lngnumberLongitude coordinate. Required if country code is not provided.
radiusinteger1000Search radius in meters, defaulting to 1000 meters if not provided.
limitinteger100Limit on the number of results returned, defaulting to 100 if not provided. Use page to paginate for more.
pageinteger0Page number for pagination (0-indexed), used together with limit as the page size. Responses include Pagination-Count (total matching results), Pagination-Page and Pagination-Limit headers. Defaults to 0.
formatjson, csv, geojsonjsonResponse format, defaulting to JSON. Options are "json", "csv", or "geojson".
includesstringArray of fields to include in the properties field of the response, provided as a comma-separated string. Any fields not in the list will be excluded from the properties object. This is used to make the response lighter so your application is faster.
countrystringISO 3166 country code consisting of 2 characters. Required if lat/lng are not provided.
categoriesstringArray of category names, provided as a comma-separated string.

Python example​

import requests

resp = requests.get(
"https://api.overturemapsapi.com/places/brands",
headers={"x-api-key": "DEMO-API-KEY"}, # use your own key outside the demo cities
params={
"lat": 51.5138,
"lng": -0.0984,
"radius": 1000,
"limit": 20,
},
timeout=30,
)
if resp.status_code == 429:
raise SystemExit(f"Rate limited, retry in {resp.headers['Retry-After']}s")
resp.raise_for_status() # 4xx bodies are {"statusCode", "message"}; the message says how to fix the request

results = resp.json()
print(resp.headers.get("Pagination-Count"), "results in total")
for brand in results:
print((brand.get("names") or {}).get("primary"), brand.get("wikidata"), brand["counts"]["places"])

Results are paginated: pass page (0-indexed) and limit, and read the total from the Pagination-Count header. See Pagination and Usage limits.