Untappd Api in Shopify einbinden

Technical Q&A
, , ,
1

Hallo,

ich betreibe einen Craft Beer Online-Shop und möchte für jedes angebotene Bier die Bewertung von Untappd anzeigen lassen. Untappd ist eine Art Bierbewertungsportal und hat eine API. Wie kann ich diese Api nun nutzen, um jede Bierbewertung anzeigen zu lassen?

Vielen Dank.

2

How to use the Untappd API

  1. Register / get credentials
  • Sign up for an Untappd developer account — you’ll receive a Client ID and Client Secret. Untappd+1
  • In your app, always send a custom User-Agent (e.g. your shop name + client id), not a standard UA. Untappd
  1. Find the correct beer in Untappd (get its BID)
  • Use the “beer search” endpoint: /v4/search/beer?q=<brewery name + beer name>&client_id=..&client_secret=.. to search for each beer. Untappd+1
  • Extract from the JSON response the correct “beer id” (BID) that matches your beer.
  1. Fetch beer info (including rating)
  • Then call endpoint /v4/beer/info/BID?client_id=..&client_secret=.. (optionally with compact=true) to get details. Untappd
  • The response JSON includes the global rating (average score), rating count, maybe media — use those to show “Untappd-Rating: X / 5 (Y ratings)”.
  1. Cache the result — don’t call on every page load
  • The public API is rate-limited (e.g. ~100 calls/hour per key) Untappd+1
  • So: for your online shop, fetch and store (cache) the rating data periodically (e.g. once per day or per few hours) instead of on each user request.
  1. Respect the Terms of Use
  • You must display attribution to Untappd when showing their data. Untappd+1
  • You should not use the data to build a separate “beer-database” or analytics for third parties; only show the rating as part of a beer listing. Untappd

Example (in pseudocode, e.g. NodeJS / JavaScript)

const CLIENT_ID = '...';
const CLIENT_SECRET = '...';

async function getBeerRating(breweryName, beerName) {
  // 1. Search beer to get BID
  const searchRes = await fetch(`https://api.untappd.com/v4/search/beer?q=${encodeURIComponent(breweryName + ' ' + beerName)}&client_id=${CLIENT_ID}&client_secret=${CLIENT_SECRET}`, {
    headers: { 'User-Agent': 'MyCraftBeerShop ('+CLIENT_ID+')' }
  });
  const searchJson = await searchRes.json();
  if (!searchJson.response.beers.items.length) return null;
  const BID = searchJson.response.beers.items[0].beer.bid;

  // 2. Fetch beer info
  const infoRes = await fetch(`https://api.untappd.com/v4/beer/info/${BID}?client_id=${CLIENT_ID}&client_secret=${CLIENT_SECRET}`, {
    headers: { 'User-Agent': 'MyCraftBeerShop ('+CLIENT_ID+')' }
  });
  const infoJson = await infoRes.json();
  const rating = infoJson.response.beer.rating_score;
  const count  = infoJson.response.beer.rating_count;
  return { rating, count };
}

You could store the result in your database (e.g. MySQL) and refresh maybe every 12–24 hours.

3

Hi @BeerBellyCologn :waving_hand: implementing third party apis is waaay beyond the scope of the forums and will just get a ton of bot “AI” posts that can be misleading.

Unless the api can do authenticated public requests you will need to either make a custom app to fetch the data and put in shopify, such as in product metafields.
Or if the api does basic-auth REST possibly it could be done with shopify-flow to get and set the data; or more advanced app like mechanic.

https://help.shopify.com/en/manual/shopify-flow/reference/actions/send-http-request

If you need consulting or to build this you can reach out to me for services in custom apps and automations.
CLICK my profile-pic or visit my profile on the forums
ALWAYS include context in new communications, e.g. reference urls, posts urls, etc