Skip to content

Retailer Links by Market/Product

This function will retrieve a list of retailers, links, and associated metadata by passing in a "Market Product Code".

Path

1
https://epremise-api.b-fonline.com/product/{market_product_code}

Method

1
GET

Required Parameters

Responses

There are 2 possible formats of responses depending on if the retailers are being broken out by subgeo or not.

  • 200 (no subgeo search criteria) 
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
    {
  "market_product_code": "Australia_000000000002732035",
  "market_name": "Australia",
  "country": null,
  "country_iso2": "AU",
  "brand_name": "Jack Daniel's",
  "product_name": "JACK DANIELS 700 ML",
  "search_subcriteria": null,
  "retailers_by_geo": {
    "all": [
      {
        "account_name": "DAN MURPHY'S",
        "account_usp": null,
        "can_sell_across_country": true,
        "logo_url": "https://ecommerce-static.brown-forman.com/Retailer_Logos/Dan_s_256x256_T.png",
        "url": "https://www.danmurphys.com.au/product/DM_73587/jack-daniel-s-old-no-7-tennessee-whiskey-700ml",
        "sort_weight": "7"
      },
      {
        "account_name": "www.Mybottleshop.com",
        "account_usp": null,
        "can_sell_across_country": true,
        "logo_url": "https://ecommerce-static.brown-forman.com/Retailer_Logos/MyBottleShop_256x256_transparent.png",
        "url": "https://www.mybottleshop.com.au/jack-daniels-700ml-gift-box",
        "sort_weight": "1"
      },
      {
        "account_name": BWS,
        "account_usp": "1 HOUR PICK UP & EXPRESS DELIVERY AVAILABLE NOW",
        "can_sell_across_country": true,
        "logo_url": "https://ecommerce-static.brown-forman.com/Retailer_Logos/BWS_256x256.png",
        "url": "https://bws.com.au/product/73587/jack-daniel's-old-no-7-tennessee-whiskey-700ml",
        "sort_weight": "3"
      },
      {...}
    ]
  }
}

  • 200 (with subgeo search criteria) 

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
    {
  "market_product_code": "United_States_1000000000000050145000",
  "market_name": "United States",
  "country": "United States",
  "country_iso2": "US",
  "brand_name": "JD Single Barrel",
  "product_name": "Jack Daniels Single 750mL",
  "search_subcriteria": "State",
  "retailers_by_geo": {
    "Alabama": [
      {
        "account_name": "Drizly",
        "account_usp": null,
        "can_sell_across_country": true,
        "logo_url": "https://ecommerce-static.brown-forman.com/Retailer_Logos/drizly_400x400.jpg",
        "url": "http://example.com",
        "sort_weight": "0"
      },
      {
        "account_name": "Reserve Bar",
        "account_usp": null,
        "can_sell_across_country": true,
        "logo_url": "https://ecommerce-static.brown-forman.com/Retailer_Logos/ReserveBar_400x400.jpg",
        "url": "http://example.com",
        "sort_weight": "0"
      }
    ],
    "Kentucky": [
      {
        "account_name": "Drizly",
        "account_usp": null,
        "can_sell_across_country": true,
        "logo_url": "https://ecommerce-static.brown-forman.com/Retailer_Logos/drizly_400x400.jpg",
        "url": "http://example.com",
        "sort_weight": "0"
      },
      {
        "account_name": "Reserve Bar",
        "account_usp": null,
        "can_sell_across_country": true,
        "logo_url": "https://ecommerce-static.brown-forman.com/Retailer_Logos/ReserveBar_400x400.jpg",
        "url": "http://example.com",
        "sort_weight": "0"
      }
    ]
  }
}

  • 422 (Unprocessable Entity)

    • Error message in JSON response
  • 500
    • Something has gone horribly wrong, please let us know.

Code Examples

1
2
3
curl -X GET \
https://epremise-api.b-fonline.com/product/Australia_000000000002732035 \
-H 'cache-control: no-cache'