NewAI summaries now on every product pageSee how →
All topics

Integrations

Product Sync API at WiserReview

Published October 11, 2025 · Updated October 14, 2026 · 4 min read

Ask AI about this guideChatGPTClaudePerplexity

WiserReview stores reviews along with their related product details.

To display reviews with product details, you must sync product data (name, URL, image, etc.) with WiserReview

Why product details are needed:

Whenever a new review is submitted through the Product Review Section Widget, the widget already contains the Product ID inside its HTML container (div tag).

  • When a user clicks the Write Review button, WiserReview captures that product ID and uses it to attach the review to the correct product record.

  • If a review form is opened through an email link, the product ID is passed in the query parameter (e.g., ?pid=12345).

  • In both cases, WiserReview uses the product ID to look up the product details that you synced earlier (name, URL, image, SKU, etc.) and saves the review linked with those details.

If product details are not available for the given ID, the system will not be able to associate the review with its product. we will consider that review is written for business, not for specific product/services.

So make sure your product data is synced.

Requirements

You need your Workspace ID (wsid) and API Key to send product data.

Find them here:

1. WSID – in your Workspace Settings → WSID section.
Your WSID is found in your WiserReview Settings.

Click the “Copy” button to copy your WSID to the clipboard.

Requirements
2. API Key
– in your Workspace Settings → API Key section.
Your API key is found in your WiserReview Settings.

Click the “Copy” button to copy your API key to the clipboard.

Requirements

Authentication

This API uses two authentication parameters:

Parameter Type Passed In Required Description
wsid string Query Parameter Yes Your Workspace ID. Pass it in the URL as ?wsid={WSID}
x-wiserrw-api-key string Request Header Yes Your API Key. Pass it as a header: x-wiserrw-api-key: {API_KEY}

Example:

POST https://api.wiserreview.com/api/productWebhook?wsid=YOUR_WORKSPACE_ID

Headers:
  Content-Type: application/json
  x-wiserrw-api-key: YOUR_API_KEY

API Endpoint

POST https://api.wiserreview.com/api/productWebhook?wsid={WSID}

Example Request

curl --location --globoff 'https://api.wiserreview.com/api/productWebhook?wsid={WSID}' 
--header 'Content-Type: application/json' 
--header 'x-wiserrw-api-key: {API_KEY}' 
--data '{
  "products": [
    {
      "pid": "1",
      "pn": "Anime Cartoon Digimon Digital Monsters",
      "pu": "https://wiserpreview.myshopify.com/products/anime-cartoon-digimon-digital-monsters",
      "piu": "https://embed.wiserreview.com/review-media/3v8pgckm96r9k9x/6a69dcd6064d0408a92fa9e6.webp",
      "shp": "https://wiserpreview.myshopify.com/",
      "arrsku": ["sku_1", "sku_2"],
      "wsid": "WSID",
      "barcode": "1234567890",
      "brand": "WiserReview",
      "lang": "EN",
      "grpid": "digimon-plush"
    },
    {
      "pid": "2",
      "pn": "Digimon Adventure Patamon Plush Toy Cute Stuffed Animals Children Soft Dolls",
      "pu": "https://wiserpreview.myshopify.com/products/digimon-adventure-patamon-plush-toy-cute-stuffed-animals-children-soft-dolls",
      "piu": "https://embed.wiserreview.com/review-media/3v8pgckm96r9k9x/6a69dcd2064d0408a92fa7e0.webp",
      "shp": "https://wiserpreview.myshopify.com/",
      "arrsku": ["sku_1", "sku_2"],
      "wsid": "WSID",
      "barcode": "1234567891",
      "brand": "WiserReview",
      "lang": "EN",
      "grpid": "digimon-plush"
    }
  ]
}'

Parameter Reference:

Field Description Required / Optional
wsid Your WiserReview Workspace ID Required
pid Product ID (unique to your system) Required
pn Product Name Required
pu Product URL Required
piu Product Image URL Required
shp Your store/site base URL Optional
arrsku An array of product SKUs Optional
barcode Product barcode or GTIN value Optional
brand Product brand Optional
lang Product language Optional
grpid Group ID. Products sent with the same grpid are put in one product group and share their reviews. See Group products with grpid below. Optional

Group products with grpid

Use grpid when several products should share the same reviews. For example: colour or size versions of one item that you list as separate products, or the same product sold in different bundles.

How WiserReview uses it

  • All products sent with the same grpid go into one product group. If the group doesn’t exist yet, WiserReview creates it and uses the grpid value as the group name. If it already exists, WiserReview updates its product list.
  • A review written for any product in the group is shown on every product in the group, both in your review widgets and in your Google product reviews feed.

Things to know

  • Use the exact same grpid value for every product in a group. Spaces at the start or end are removed, but letter case matters: Plush and plush are two different groups.
  • To move a product to another group, send it again with the new grpid. It’s removed from its old group automatically.
  • If you leave out grpid, the product stays in the group it’s already in.
  • The group name is reset to the grpid value every time products are synced.
  • Grouping runs in the background, so shared reviews can take a few minutes to appear on every product in the group.

Response Codes

Status Code Status Description
200 Success Products synced successfully.
400 WSID is not valid The Workspace ID passed in the query parameter is invalid or missing.
403 Forbidden The API key is invalid or does not match the given workspace.
404 User Not Found No user account found for the provided workspace credentials.
500 Internal Server Error Something went wrong on the server. Try again or contact support.

Tips:

  • Send up to 100 products per request.
  • Use pagination for larger catalogs.
  • If you want to update existing product data, use the same Product ID and send new details. The existing record will be updated automatically.
  • To share reviews between related products, send them with the same grpid.
  • Make sure data is valid JSON.
  • Test using Postman or your preferred HTTP client.
  • Keep product data updated whenever products are added, edited, or removed in your store.

Was this guide helpful?