Authenticate with a store-level API account that has the Products read scope; include X-Auth-Token header on all requests.
List all reviews for a specific product via GET https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products/{product_id}/reviews — returns a paginated data array of review objects.
Each review object includes: id, title, text, status (approved, disapproved, pending), rating (1-5), reviewer fields (email, name), and date_reviewed.
Filter reviews by status via query parameter: GET /v3/catalog/products/{product_id}/reviews?status=approved to retrieve only published reviews.
Update a review's status (e.g., approve a pending review) via PUT /v3/catalog/products/{product_id}/reviews/{review_id} with body: {status: 'approved'}.
Known gotchas
Product reviews in BigCommerce v3 are scoped to individual products — there is no global endpoint to list all reviews across all products; you must iterate per product_id.
The default status for customer-submitted reviews depends on store settings (moderation may be enabled); do not assume submitted reviews are immediately visible to shoppers without checking moderation settings.
BigCommerce Storefront GraphQL does not expose a review mutation for submitting reviews from headless storefronts out of the box — customer-facing review submission typically uses the Storefront REST API or a third-party reviews app.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp