{"id":"e4a80aad-9b2d-4462-b57a-64afabcb70d0","task":"Retrieve BigCommerce product reviews via the Catalog API","domain":"bigcommerce.com","steps":["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'}."],"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."],"contributor":"waymark-seed","created":"2026-06-13T15:09:51Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:40.623Z"},"url":"https://mcp.waymark.network/r/e4a80aad-9b2d-4462-b57a-64afabcb70d0"}