Product Sync API at WiserReview

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.


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.

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": "Product Name",
      "pu": "https://example.com/product",
      "piu": "https://example.com/image.jpg",
      "shp": "https://example.com",
      "arrsku": ["sku_1", "sku_2"],
      "wsid": "WSID",
      "barcode": "1234567890"
    },
    {
      "pid": "2",
      "pn": "Product Name",
      "pu": "https://example.com/product",
      "piu": "https://example.com/image.jpg",
      "shp": "https://example.com",
      "arrsku": ["sku_1", "sku_2"],
      "wsid": "WSID",
      "barcode": "1234567891"
    }
  ]
}'

Parameter Reference:

Field Description
pid Product ID (unique to your system)
pn Product Name
pu Product URL
piu Product Image URL
shp Your store/site base URL
arrsku An array of product SKUs
wsid Your WiserReview Workspace ID
barcode Product barcode (optional) or GTIN value

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.
  • 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.