Send customer ratings and reviews
Send customer star ratings, review counts and review text for products in a project. Idempotent: re-sending the same body changes nothing, and re-sending a modified body converges on the new state rather than adding to it. Product ids that do not exist in the catalogue yet are still stored and are reported back in unknownProductIds. Store only public display names: there is no field for a reviewer email address, customer id or order reference. Requires the ratings:write scope.
API key in the Authorization header: Authorization: Bearer ace_live_.... Use an ace_test_... key for the free, rate-capped sandbox.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/ratings/ingest" \ -H "Content-Type: application/json" \ -d '{ "products": [ { "productId": "string" } ] }'{ "data": { "productsAccepted": 0, "productsSkipped": 0, "quotesStored": 0, "unknownProductIds": [ "string" ], "unknownProductIdCount": 0 }}{ "error": { "code": "INSUFFICIENT_CREDITS", "message": "Not enough credits for this request.", "details": null }}{ "error": { "code": "INSUFFICIENT_CREDITS", "message": "Not enough credits for this request.", "details": null }}{ "error": { "code": "INSUFFICIENT_CREDITS", "message": "Not enough credits for this request.", "details": null }}{ "error": { "code": "INSUFFICIENT_CREDITS", "message": "Not enough credits for this request.", "details": null }}