API reference
Reviews
Buyer reviews with unmasked emails. Reviews are never deleted: hide spam instead, or answer in public.
Endpoints
GET/reviewsreviews:read
List reviews.
| Query parameters | Type | Description |
|---|---|---|
| productId | Type: string | Only this product. |
| rating | Type: 1..5 | Only this rating. |
| visible | Type: true | false | Only shown or only hidden reviews. |
| limit | Type: 1..1000 | Page size. Default 50. |
| cursor | Type: string | nextCursor from the previous page. |
curl https://api.sellhidden.com/v1/reviews \
-H "Authorization: Bearer hsk_live_…"GET/reviews/{id}reviews:read
Get a review.
curl https://api.sellhidden.com/v1/reviews/ID \
-H "Authorization: Bearer hsk_live_…"PATCH/reviews/{id}reviews:write
Hide or show a review.
| Body | Type | Description |
|---|---|---|
| visiblerequired | Type: boolean | false hides it from the storefront. |
curl -X PATCH https://api.sellhidden.com/v1/reviews/ID \
-H "Authorization: Bearer hsk_live_…" \
-H "Content-Type: application/json" \
-d '{"visible":false}'PUT/reviews/{id}/replyreviews:writeIdempotency-Key
Reply in public. Writes or edits the store's reply under the review. The buyer is emailed once per review, on the first reply. Automatic ratings cannot be answered (409 review_automatic). POST works the same.
| Body | Type | Description |
|---|---|---|
| replyrequired | Type: string | Up to 1,000 characters. |
curl -X PUT https://api.sellhidden.com/v1/reviews/ID/reply \
-H "Authorization: Bearer hsk_live_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"reply":"Thanks for the kind words!"}'DELETE/reviews/{id}/replyreviews:write
Remove the reply.
curl -X DELETE \
https://api.sellhidden.com/v1/reviews/ID/reply \
-H "Authorization: Bearer hsk_live_…"Get help
Send us the endpoint, the request or delivery id and the response you got. Security findings go through responsible disclosure. Live platform status is on the support page.
See also