Skip to main content
Rezolve Ai
API ReferenceRatingsIngest

Send customer ratings and reviews

POST
/ratings/ingest

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.

Authorization

headerAuthorizationBearer <API key>

API key in the Authorization header: Authorization: Bearer ace_live_.... Use an ace_test_... key for the free, rate-capped sandbox.

Request Body

application/json
  1. body
projectId?string

Target project. Optional when the API key is scoped to a project.

Formatuuid
products*array<>
Itemsitems <= 200

Response Body

Ingest result

application/json
  1. response
data?
Example Request
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  }}