Judge.me

Judge.me is a product reviews platform for Shopify and other e-commerce storefronts, collecting photo and video reviews, star ratings, site reviews, and Q&A. The Judge.me REST API at https://judge.me/api/v1 lets developers list and import reviews, fetch ready-to-render widget HTML, resolve products, send review requests, and build OAuth apps authenticated with a shop_domain plus public or private api_token.

6 APIs 0 Features

ReviewsE-commerceShopifyRatingsSocial Proof

APIs

Judge.me Reviews API

List published reviews with pagination and filtering for bulk export, and programmatically create reviews with a reviewer name, email, rating, title, and body against a product ...

Judge.me Reviewers API

Reviewer data - the customers who have left reviews, including name, email, and external id - is returned inline on review records and gated by the read_reviewers and write_revi...

Judge.me Products API

Resolve products by converting an external (platform) product handle or id into an internal Judge.me product id via the /products/-1 lookup, the same id used to scope review que...

Judge.me Widgets API

Return sanitized, XSS-safe, ready-to-render review widget HTML - such as the product review widget and the preview badge showing average star rating and review count - usable fr...

Judge.me OAuth API

Standard OAuth 2.0 authorization-code flow at app.judge.me/oauth/authorize and judge.me/oauth/token letting third-party apps request scoped access (read/write shops, widgets, or...

Judge.me Webhooks API

Subscribe to events so Judge.me POSTs to your URL on review lifecycle events - review/created, review/updated, review/published, review/unpublished - and widget settings updates...

Collections

Judge.me API

OPEN

Pricing Plans

Judge Me Plans Pricing

2 plans

PLANS

Rate Limits

Judge Me Rate Limits

2 limits

RATE LIMITS

FinOps

Judge Me Finops

FINOPS

Resources

Sources

opencollection: 1.0.0
info:
  name: Judge.me API
  version: '1.0'
request:
  auth:
    type: apikey
    apikey:
      in: query
      key: api_token
      value: '{{apiToken}}'
items:
- info:
    name: Reviews
    type: folder
  items:
  - info:
      name: List reviews
      type: http
    http:
      method: GET
      url: https://judge.me/api/v1/reviews?shop_domain={{shopDomain}}&api_token={{apiToken}}
    docs: Retrieve published reviews for the store, optionally filtered by product_id, rating, and paginated with page and
      per_page.
  - info:
      name: Create a review
      type: http
    http:
      method: POST
      url: https://judge.me/api/v1/reviews?shop_domain={{shopDomain}}&api_token={{apiToken}}
      body:
        type: json
        data: "{\n  \"name\": \"Jane Doe\",\n  \"email\": \"jane@example.com\",\n  \"rating\": 5,\n  \"title\": \"Great product\"\
          ,\n  \"body\": \"Highly recommend.\",\n  \"platform\": \"shopify\",\n  \"id\": \"123456789\"\n}"
    docs: Programmatically create or import a review for a product or the store. Requires a private api_token.
- info:
    name: Products
    type: folder
  items:
  - info:
      name: Look up internal product id
      type: http
    http:
      method: GET
      url: https://judge.me/api/v1/products/-1?shop_domain={{shopDomain}}&api_token={{apiToken}}&handle=my-product
    docs: Resolve an external product id or handle into the internal Judge.me product id used by the reviews endpoints.
- info:
    name: Widgets
    type: folder
  items:
  - info:
      name: Get product review widget HTML
      type: http
    http:
      method: GET
      url: https://judge.me/api/v1/widgets/product_review?shop_domain={{shopDomain}}&api_token={{apiToken}}&product_id=1
    docs: Return sanitized, ready-to-render product review widget HTML. Use a public api_token.
  - info:
      name: Get preview badge widget HTML
      type: http
    http:
      method: GET
      url: https://judge.me/api/v1/widgets/preview_badge?shop_domain={{shopDomain}}&api_token={{apiToken}}&product_id=1
    docs: Return preview badge HTML showing a product's average star rating and review count. Use a public api_token.
- info:
    name: Review Requests
    type: folder
  items:
  - info:
      name: Send a manual review request
      type: http
    http:
      method: POST
      url: https://judge.me/api/v1/orders/send_manual_review_request?shop_domain={{shopDomain}}&api_token={{apiToken}}
      body:
        type: json
        data: "{\n  \"id\": \"order_123\",\n  \"email\": \"jane@example.com\",\n  \"name\": \"Jane Doe\",\n  \"platform\"\
          : \"shopify\"\n}"
    docs: Trigger a review request email to a customer for a given order. Requires a private api_token.