Showrev

Widget Integration Guide

Follow these steps to seamlessly embed the Showrev Google Reviews widget on your website.

Step 1: Obtain Your API Key

The API key authenticates your widget and links it to your Showrev account and selected Google Business Profile.

  1. Sign up for a Showrev account or Log in.
  2. Navigate to your Dashboard.
  3. Use the "Connect Your Business" section to search for and select your business profile via Google Maps.
  4. Once connected, your unique API key will appear in the "Account Information" and "Embed Widget" sections.

Important: A business profile must be connected before an API key can be generated and the widget embedded.

Step 2: Configure Your Widget

Customize the widget's appearance and behavior using the interactive Widget Configuration section in your dashboard. Available options include:

  • Theme (Light/Dark)
  • Auto Show on Load (Yes/No)
  • Reviews Displayed per Page
  • Widget Position (e.g., Bottom Right, Inline)
  • Content Filters (Good Reviews Only, Text Reviews Only)
  • Visibility Toggles (Date, Images, Translations, 'View on Google' Link)
  • Sorting Order
  • Custom Colors (Primary, Secondary, Stars, Border)
  • Custom Title & Icon

The embed code provided in Step 3 updates automatically as you adjust these settings.

Step 3: Copy the Embed Code

After configuring the widget, find the Embed Widget card on your dashboard.

Copy the generated script tag. It will resemble this example:

<script src="https://www.showrev.io/js/widget.js?apikey=YOUR_API_KEY&theme=light&autoShow=false&perPage=3&position=bottom-right" defer></script>

Use the copy button provided on the dashboard for accuracy.

Step 4: Add the Code to Your Website

Paste the copied script tag into your website's HTML source code.

For optimal performance, place it just before the closing </body> tag:

<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
    <!-- Other head elements -->
</head>
<body>

    <h1>Welcome!</h1>
    <!-- Your page content -->

    <!-- Showrev Widget Script (Paste Here) -->
    <script src="https://www.showrev.io/js/widget.js?apikey=YOUR_API_KEY&theme=light&autoShow=false&perPage=3&position=bottom-right" defer></script>

</body>
</html>

Save the changes to your HTML file. The Showrev widget should now appear on your website according to your configuration.

Widget Parameters Reference

The embed script uses URL query parameters for configuration. While the dashboard is recommended, here is a detailed list:

apikey (string, required): Your unique API key.

theme (string): 'light' (default) or 'dark'.

autoShow (boolean): 'true' or 'false' (default). Determines initial visibility.

perPage (number): Reviews per page (e.g., '3', default).

position (string): Positioning (e.g., 'bottom-right', default). Omit for inline placement.

onlyGood (boolean): 'true' (default) or 'false'. Filter reviews >= 4 stars.

onlyText (boolean): 'true' (default) or 'false'. Show only reviews with comments.

showDate (boolean): 'false' (default) or 'true'. Display review dates.

sortBy (string): Sort order ('newest' (default), 'relevant', 'highest', 'lowest').

showImages (boolean): 'true' (default) or 'false'. Display review images.

showTranslation (boolean): 'true' (default) or 'false'. Enable translation links.

showReviewLink (boolean): 'false' (default) or 'true'. Display 'View on Google' links.

primaryColor (hex): URL-encoded hex color (e.g., '%23000000') for primary button backgrounds. Default: black.

primaryTextColor (hex): URL-encoded hex color (e.g., '%23ffffff') for primary button text. Default: white.

starColor (hex): URL-encoded hex color (e.g., '%23ffc107') for rating stars. Default: gold.

reviewBorderColor (hex): URL-encoded hex color (e.g., '%234285F4') for review card left border. Default: Google Blue.

widgetTitle (string): URL-encoded custom title for the widget header (e.g., 'Our%20Reviews'). Default: Google Reviews.

widgetIconUrl (url): URL-encoded path to a custom icon for the widget header. Leave blank for default Google logo.

Public API Reference

Fetch reviews programmatically using your API key via the following endpoint.

GET /api/business/v1/reviews

Retrieves Google reviews associated with the provided API key.

Query Parameters:

  • apikey (string, required): Your Showrev API key (JWT).
  • sort (string, optional, default: 'newest'): Sorting order for reviews (e.g., 'newest', 'relevant', 'rating_high', 'rating_low').
  • nextpage (string, optional): Pagination token from a previous response's nextPage field. Omit or leave empty for the first page.

Example Request (cURL):

curl "https://www.showrev.io/api/business/v1/reviews?apikey=YOUR_API_KEY&sort=rating_high"

Example Success Response (200 OK):

{
   "placeId": "0x132f602ee6d38e13:0x84ab054009b12086",
   "averageRating": 4.3,
   "totalReviews": "227 reviews",
   "reviews": [
     {
       "author": "betül sayın",
       "authorId": "105069022519472022610",
       "authorUrl": "https://www.google.com/maps/contrib/105069022519472022610?hl=en",
       "authorImage": "https://lh3.googleusercontent.com/a-/ALV-UjXT_rfIdH_pHCXNdgkktfqavKbaOE1j_Ht6RWIyDj4EMJxwiGBaxw=w1080-h1080",
       "reviewImages": [
         "https://lh3.googleusercontent.com/geougc-cs/AIHozJJ8YovBJUnYgG_85VbPQCmiQhpAqhUKsiM95XviadjlSm3Ls6W6CXurIH7x7aSLOyKsY-sfx8hrTj6lslciB35Nc0pfYpRnxwNdbYVw8JA-tjzEJEbQiwH2Vhjn-0TsfwOujrXRiA=w1080-h1080"
       ],
       "reviewId": "ChZDSUhNMG9nS0VJQ0FnTURROGQyM0FREAE",
       "reviewUrl": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnTURROGQyM0FREAE!2m1!1s0x132f602ee6d38e13:0x84ab054009b12086!3m1!1s2",
       "comment": "I think this neighborhood is like a glimpse into the lives of people living in Rome. I loved it because it was like really getting to know the locals.",
       "translatedComment": null,
       "commentLang": "English",
       "date": "a month ago",
       "dateExact": "2025-03-11 21:00:42",
       "rating": "Rated 5 out of 5,",
       "ratingValue": 5,
       "stars": "⭐⭐⭐⭐⭐",
       "sentimentAi": "POSITIVE",
       "sentimentSymbol": "😃✨",
       "ownerResponseText": null,
       "ownerResponseDate": null,
       "ownerDateExact": null,
       "translatedOwnerText": null,
       "ownerTextLang": null
     }
     // ... more reviews
   ],
   "nextPage": "TOKEN_FOR_NEXT_PAGE"
 }

Potential Error Responses:

  • 401 Unauthorized: API key missing or invalid format.
  • 403 Forbidden: Invalid/expired API key, banned user, or inactive subscription/trial.
  • 500 Internal Server Error: Backend error fetching reviews.