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": "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
grpidgo into one product group. If the group doesn’t exist yet, WiserReview creates it and uses thegrpidvalue 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
grpidvalue for every product in a group. Spaces at the start or end are removed, but letter case matters:Plushandplushare 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
grpidvalue 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 IDand 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.