API ReferenceRatingsIngest
Send customer ratings and reviews
POST
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.
header
AuthorizationBearer <API key>API key in the Authorization header: Authorization: Bearer ace_live_.... Use an ace_test_... key for the free, rate-capped sandbox.
application/json- body
projectId?stringTarget project. Optional when the API key is scoped to a project.
Format
uuidproducts*array<>Items
items <= 200Ingest result
application/json- response
data?curl -X POST 'https://example.com/api/v1/ratings/ingest' \ -H 'Content-Type: application/json' \ -d '{ "products": [ { "productId": "string" } ]}'Example Response
{ "data": { "productsAccepted": 0, "productsSkipped": 0, "quotesStored": 0, "unknownProductIds": [ "string" ], "unknownProductIdCount": 0 }}