---
updatedAt: 2026-04-24T10:23:33.000Z
agentTools:
  projectIndex: https://developer.reviews.io/llms.txt
---

# Retrieve Product Ratings

Fetches the review counts and ratings for a list of products.  This can be used to add rating stars to product listing and category pages.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "REVIEWS.io API",
    "version": "0.1"
  },
  "servers": [
    {
      "url": "https://api.reviews.io",
      "description": "REVIEWS.io API"
    },
    {
      "url": "https://api.reviews.co.uk",
      "description": "REVIEWS.co.uk API"
    }
  ],
  "paths": {
    "/product/rating-batch": {
      "get": {
        "tags": [
          "Reviews and Questions"
        ],
        "summary": "Retrieve Product Ratings",
        "operationId": "5d09bb17e6720187be9bc35432a5deeb",
        "parameters": [
          {
            "$ref": "#/components/parameters/store"
          },
          {
            "$ref": "#/components/parameters/sku_required"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/product_rating_response"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "product_rating_response": {
        "title": "Product Rating",
        "description": "Product Rating and Review Count",
        "properties": {
          "sku": {
            "title": "SKU",
            "description": "Product Identifier.",
            "type": "string",
            "example": "ABC123"
          },
          "average_rating": {
            "title": "Average Rating",
            "description": "Average Rating.",
            "type": "string",
            "example": "4.8"
          },
          "num_ratings": {
            "title": "Number of Reviews",
            "description": "Number of Reviews",
            "type": "number",
            "example": 7
          }
        },
        "type": "object"
      }
    },
    "parameters": {
      "store": {
        "name": "store",
        "in": "query",
        "description": "Your REVIEWS.io public store key",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "sku_required": {
        "name": "sku",
        "in": "query",
        "description": "Product SKUs, seperated by semi colons",
        "required": true,
        "schema": {
          "type": "string"
        }
      }
    }
  },
  "tags": [
    {
      "name": "Reviews and Questions",
      "description": ""
    }
  ],
  "x-readme": {
    "explorer-enabled": false
  }
}
```