Brand List
Request
The Brand List API returns a Brand list based on provided brand rank scope.
GET https://apis.location.studio/geo/v2/brand_list/json
Required Parameters
api_key |
String |
Your Location Studio API Key |
country |
String |
3 letter ISO country code (eg USA, CAN, GBR etc) for country brand list. |
Optional Parameters
brand_rank_max |
Integer |
Filter to request only for brands that have rank brand_rank_max. Rank ranges from 1 to 5 with 1 being the highest and 5 being the lowest. |
brand_rank_min |
Integer |
Filter to request only for brands that have rank >= brand_rank_min. |
Response
Description
Outputs list of brands for the requested country. Results will be sorted by brand rank
-
brand_item
- Represents a brand-
id
- Unique identifier for the brand -
rank
- Rank of the brand -
name
-
text
- Name of the brand (Eg Walmart) -
language
- Language code of the brand name
-
-
alias
-
text
- Name of the brand (Eg Walmart Supercenter) optional -
language
- Language code of the brand alias
-
-
JSON
{
"brand_list" : [ {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Burger King"
},
"id" : "B0010",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Subway"
},
"id" : "B0012",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Dunkin' Donuts"
},
"id" : "B0013",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Taco Bell"
},
"id" : "B0014",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Mobil"
},
"id" : "B0061",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Valero"
},
"id" : "B0060",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Circle K"
},
"id" : "B0063",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "SONIC"
},
"id" : "B0040",
"alias" : [ {
"language" : "en-US",
"text" : "Sonic Drive In"
} ],
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Marathon"
},
"id" : "B0058",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Sunoco"
},
"id" : "B0059",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Citgo"
},
"id" : "B0054",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Chevron"
},
"id" : "B0055",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "7-Eleven"
},
"id" : "B0056",
"alias" : [ {
"language" : "en-US",
"text" : "7 Eleven"
} ],
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Exxon"
},
"id" : "B0057",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Shell"
},
"id" : "B0052",
"alias" : [ {
"language" : "en-US",
"text" : "Shell Rapid Lube"
} ],
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Bp"
},
"id" : "B0053",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Pizza Hut"
},
"id" : "B0020",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Dairy Queen"
},
"id" : "B0023",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Wendy's"
},
"id" : "B0022",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "KFC"
},
"id" : "B0039",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "CVS/pharmacy"
},
"id" : "B0035",
"alias" : [ {
"language" : "en-US",
"text" : "Cvs Pharmacy"
} ],
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Walgreens"
},
"id" : "B0006",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "McDonald's"
},
"id" : "B0003",
"alias" : [ {
"language" : "en-US",
"text" : "Mc Donald's"
} ],
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Starbucks"
},
"id" : "B0002",
"rank" : "1"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Sam's Club"
},
"id" : "B0017",
"alias" : [ {
"language" : "en-US",
"text" : "Sam's Club Pharmacy"
}, {
"language" : "en-US",
"text" : "SAMS CLUB"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Texaco"
},
"id" : "B0065",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Conoco"
},
"id" : "B0064",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Gulf"
},
"id" : "B0067",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Casey's General Store"
},
"id" : "B0066",
"alias" : [ {
"language" : "en-US",
"text" : "CASEYS"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Phillips 66"
},
"id" : "B0062",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "76"
},
"id" : "B0069",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Speedway"
},
"id" : "B0068",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Safeway"
},
"id" : "B0077",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Arco"
},
"id" : "B0074",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Murphy USA"
},
"id" : "B0072",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Kangaroo Express"
},
"id" : "B0073",
"alias" : [ {
"language" : "en-US",
"text" : "KANGAROO"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Sinclair"
},
"id" : "B0070",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Cenex"
},
"id" : "B0071",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Mini Mart"
},
"id" : "B0078",
"alias" : [ {
"language" : "en-US",
"text" : "MINI MART (TX)"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Kroger"
},
"id" : "B0047",
"alias" : [ {
"language" : "en-US",
"text" : "Kroger Pharmacy"
}, {
"language" : "en-US",
"text" : "Kroger Fuel Center"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Waffle House"
},
"id" : "B0044",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Chipotle"
},
"id" : "B0049",
"alias" : [ {
"language" : "en-US",
"text" : "Chipotle Mexican Grill"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Chick-fil-A"
},
"id" : "B0029",
"alias" : [ {
"language" : "en-US",
"text" : "Chick Fil A"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Olive Garden"
},
"id" : "B0025",
"alias" : [ {
"language" : "en-US",
"text" : "Olive Garden Italian Rstrnt"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "IHOP"
},
"id" : "B0024",
"alias" : [ {
"language" : "en-US",
"text" : "Ihop Restaurant"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Denny's"
},
"id" : "B0026",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Panera Bread"
},
"id" : "B0032",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Applebee's"
},
"id" : "B0031",
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Wawa"
},
"id" : "B0034",
"alias" : [ {
"language" : "en-US",
"text" : "Wawa Food Market"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Target"
},
"id" : "B0005",
"alias" : [ {
"language" : "en-US",
"text" : "Target Pharmacy"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Walmart"
},
"id" : "B0001",
"alias" : [ {
"language" : "en-US",
"text" : "WAL-MART"
}, {
"language" : "en-US",
"text" : "Walmart Neighborhood Market"
} ],
"rank" : "2"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Racetrac"
},
"id" : "B0098",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Holiday Stationstores"
},
"id" : "B0090",
"alias" : [ {
"language" : "en-US",
"text" : "HOLIDAY"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Stripes"
},
"id" : "B0091",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Tesoro"
},
"id" : "B0092",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Fina"
},
"id" : "B0094",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Irving"
},
"id" : "B0095",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Turkey Hill"
},
"id" : "B0096",
"alias" : [ {
"language" : "en-US",
"text" : "Turkey Hill Minit Market"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Lukoil"
},
"id" : "B0097",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Lowe's"
},
"id" : "B0011",
"alias" : [ {
"language" : "en-US",
"text" : "Lowe's Home Improvement"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Marriott"
},
"id" : "B0015",
"alias" : [ {
"language" : "en-US",
"text" : "Fairfield Inn"
}, {
"language" : "en-US",
"text" : "Fairfield Inn by Marriott"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Costco"
},
"id" : "B0016",
"alias" : [ {
"language" : "en-US",
"text" : "Costco Pharmacy"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Best Buy"
},
"id" : "B0018",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Wells Fargo"
},
"id" : "B0019",
"alias" : [ {
"language" : "en-US",
"text" : "Wells Fargo Bank"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Hess"
},
"id" : "B0076",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Ampm"
},
"id" : "B0075",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Golden Corral"
},
"id" : "B0043",
"alias" : [ {
"language" : "en-US",
"text" : "Golden Corral Buffet & Grill"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Red Lobster"
},
"id" : "B0042",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Petsmart"
},
"id" : "B0046",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Valero Corner Store"
},
"id" : "B0115",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Stewart's"
},
"id" : "B0114",
"alias" : [ {
"language" : "en-US",
"text" : "Stewart's Shop"
}, {
"language" : "en-US",
"text" : "STEWARTS"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Giant"
},
"id" : "B0117",
"alias" : [ {
"language" : "en-US",
"text" : "Giant Food"
}, {
"language" : "en-US",
"text" : "GIANT FOODS (AHOLD)"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Kwik Fill"
},
"id" : "B0112",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Bed Bath & Beyond"
},
"id" : "B0050",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "E-Z Mart"
},
"id" : "B0106",
"alias" : [ {
"language" : "en-US",
"text" : "E Z Mart"
}, {
"language" : "en-US",
"text" : "E Z STOP FOOD MART"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Meijer"
},
"id" : "B0104",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "One Stop"
},
"id" : "B0102",
"alias" : [ {
"language" : "en-US",
"text" : "ONE STOP FOOD STORE (NC)"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Love's"
},
"id" : "B0101",
"alias" : [ {
"language" : "en-US",
"text" : "Love's Travel Stop"
}, {
"language" : "en-US",
"text" : "LOVES"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "AutoZone"
},
"id" : "B0021",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Courtyard"
},
"id" : "B0027",
"alias" : [ {
"language" : "en-US",
"text" : "COURTYARD by Marriott"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Barnes & Noble Booksellers"
},
"id" : "B0038",
"alias" : [ {
"language" : "en-US",
"text" : "Barnes & Noble"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Staples"
},
"id" : "B0033",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Chase"
},
"id" : "B0030",
"alias" : [ {
"language" : "en-US",
"text" : "Chase Bank"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Cracker Barrel Old Country Store"
},
"id" : "B0036",
"alias" : [ {
"language" : "en-US",
"text" : "Cracker Barrel Old Country Str"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Trader Joe's"
},
"id" : "B0037",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Pilot"
},
"id" : "B0088",
"alias" : [ {
"language" : "en-US",
"text" : "Pilot Flying J"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Getty"
},
"id" : "B0087",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Cumberland Farms"
},
"id" : "B0086",
"alias" : [ {
"language" : "en-US",
"text" : "CUMBERLAND"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Hess Express"
},
"id" : "B0085",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "QuikTrip"
},
"id" : "B0084",
"alias" : [ {
"language" : "en-US",
"text" : "Quik Trip"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Clark"
},
"id" : "B0083",
"alias" : [ {
"language" : "en-US",
"text" : "CLARK OIL (MS/AL)"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Sheetz"
},
"id" : "B0081",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Bank Of America"
},
"id" : "B0007",
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Home Depot"
},
"id" : "B0004",
"alias" : [ {
"language" : "en-US",
"text" : "Home Depot At Home Svc"
}, {
"language" : "en-US",
"text" : "The Home Depot"
} ],
"rank" : "3"
}
}, {
"brand_item" : {
"name" : {
"language" : "en-US",
"text" : "Hampton Inn"
},
"id" : "B0009",
"alias" : [ {
"language" : "en-US",
"text" : "Hampton Inn & Suites"
} ],
"rank" : "3"
}
}, {
"brand_item" : { "name" : {
"language" : "en-US",
"text" : "Holiday Inn"
},
"id" : "B0008",
"alias" : [ {
"language" : "en-US",
"text" : "Holiday Inn Express"
}, {
"language" : "en-US",
"text" : "Holiday Inn Hotel & Suites"
}, {
"language" : "en-US",
"text" : "Holiday Inn Select"
}, {
"language" : "en-US",
"text" : "Holiday Inn Express Hotel & Suites"
} ],
"rank" : "3"
}
} ]
}