Judge.me API lets you access your store’s review data programmatically, so you can build custom workflows, sync reviews with other platforms, or generate reports.
Technical resources
API documentation
The Judge.me API follows the OpenAPI specification.
To view the documentation, to go https://judge.me/api.
Original YAML file also available at that link.
Server endpoint
Base URL:
https://judge.me/api/v1Example endpoint:
https://judge.me/api/v1/widgets/product_review
API credentials
To use our API, you'll need 2 credentials: shop_domain and api_token.
To find shop_domain and api_token:
From your Judge.me admin, go to Settings > Integrations.
Click the View API tokens button on the top right.
There you'll find:
Your Public API Token: This public token is suitable for making GET requests to our widget API. It's designed for use in public JavaScript environments.
Your Private API Token: This private token grants read/write access to your data and should be exclusively used on the server-side for enhanced security.
Your Shop domain in myshopify.com format.
Considerations
Review replies are not included in API responses: The Judge.me API currently returns review content and related metadata, but does not include replies to reviews.
Duplicate reviews when using cf_answers: If the
cf_answersarray is included with non-empty values in the API payload, multiple identical reviews may be created—despite sending only one request. This issue has been observed in Make.com and confirmed via Postman testing. To avoid this, omitcf_answersor leave it empty.
Common API use cases
1. Create new reviews
Method: POST
Endpoint: https://judge.me/api/v1/reviews
Parameter | Required | Description |
| Yes | Your Shop domain (e.g. example.myshopify.com) |
| Yes | One of: shopify, woocommerce, bigcommerce |
| Yes | Reviewer display name |
| Yes | Reviewer email |
| Yes | 1–5 |
| Yes | Review body text |
| No | Shopify product ID (external) |
| No | Review title |
| No | One of: '', last_initial, all_initials, anonymous. Default: full name. |
| No | array of { cf_question_id, value }. Answers to shop custom form questions. |
| No | URLs of review images |
| No | Reviewer IP for location |
2. Add manual review requests
Method: POST
Endpoint: https://judge.me/api/orders/send_manual_review_request
Parameter | Required | Description |
| Yes | Your Private API token |
| Yes | Your Shop domain (e.g. example.myshopify.com) |
| Yes | Reviewer name |
| Yes | Reviewer email |
| Yes | Shopify product ID (external) |
| Yes | Product handle |
| Yes | When the order was fulfilled, in dd/mm/yyyy format |
| Yes | quantity of the purchased product, we will set to 1 by default |
| Yes | When the request will be sent, in dd/mm/yyyy format
|
3. Look up internal product ID
In our API, products have two types of IDs:
External ID: The Shopify product ID
ID: The internal Judge.me product ID
To find the external ID of the product: See Finding Product ID and Product Handle.
To find the internal ID of the product, you’ll need to use the Judge.me Product API to convert the external ID into our internal ID:
Method: GET
Endpoint: https://api.judge.me/api/v1/products/-1?shop_domain=SHOP_DOMAIN&api_token=PRIVATE_API_TOKEN&external_id=EXTERNAL_PRODUCT_ID
Parameter | Required | Description |
| Yes | Judge.me internal product ID. Use -1 to look up by external_id or handle instead. |
| Yes | Your Private API token |
| Yes | Your Shop domain (e.g. example.myshopify.com) |
| Conditional | Shopify product ID (external) |
| Conditional | Product handle |
This call will return a product object. Look for the id field inside the product object — that is the internal Judge.me product ID.