Product Reviews

Get Item Reviews

Retrieve reviews for a specific item using its item ID.

Parameters

• limit (Integer, optional): Maximum number of reviews to return. Default: 5. Must be a positive integer less than 10000.
• offset (Integer, optional): Number of reviews to skip for pagination. Default: 0. Must be a positive integer less than 1000000.
• catalog_product_id (String, optional): Catalog product ID to filter reviews for catalog items.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reviews/item/$ITEM_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reviews/item/MLM15482175

Response:

{
  "paging": {
    "total": 3,
    "limit": 5,
    "offset": 0,
    "kvs_total": 3,
    "reviews_with_comment": 3
  },
  "reviews": [
    {
      "id": 60934080,
      "reviewable_object": {
        "id": "MLM769281453",
        "type": "product"
      },
      "date_created": "2020-05-02T13:18:21Z",
      "status": "published",
      "title": "Es un excelente teléfono muy recomendable...!!!",
      "content": "Buen producto excelente calidad. Trabaja correctamente y sus actualizaciones bien.",
      "rate": 5,
      "valorization": 0,
      "likes": 0,
      "dislikes": 0,
      "reviewer_id": 0,
      "buying_date": "2020-04-16T04:00:00Z",
      "relevance": 10,
      "forbidden_words": 0
    },
    {
      "id": 61913880,
      "reviewable_object": {
        "id": "MLM771812030",
        "type": "product"
      },
      "date_created": "2020-05-13T11:08:42Z",
      "status": "published",
      "title": "Excelente",
      "content": "Excelente compra! todo nuevo como lo comenta la publicación.",
      "rate": 5,
      "valorization": 0,
      "likes": 0,
      "dislikes": 0,
      "reviewer_id": 0,
      "buying_date": "2020-04-27T04:00:00Z",
      "relevance": 9,
      "forbidden_words": 20
    },
    {
      "id": 60318050,
      "reviewable_object": {
        "id": "MLM769281453",
        "type": "product"
      },
      "date_created": "2020-04-24T21:31:55Z",
      "status": "published",
      "title": "perfecto",
      "content": "Muy bien ekipo sellado nuevo conforme.",
      "rate": 5,
      "valorization": 0,
      "likes": 0,
      "dislikes": 0,
      "reviewer_id": 0,
      "buying_date": "2020-04-20T04:00:00Z",
      "relevance": 6,
      "forbidden_words": 0
    }
  ],
  "rating_average": 5,
  "stars": 5,
  "rating_levels": {
    "one_star": 0,
    "two_star": 0,
    "three_star": 0,
    "four_star": 0,
    "five_star": 3
  },
  "helpful_reviews": {
    "best_max_stars": null,
    "best_min_stars": null
  },
  "attributes": [],
  "quanti_attributes": [],
  "quali_attributes": [],
  "metadata": {}
}

Response Fields

paging: Pagination information for the results.

• total: Total number of reviews available.
• limit: Maximum number of reviews returned per request.
• offset: Number of reviews skipped.
• kvs_total: Total count from key-value store.
• reviews_with_comment: Number of reviews that include a written comment.

reviews: Array of product reviews.

• id: Unique identifier of the review.
• reviewable_object: Object containing information about the reviewed item.
  • id: Item ID being reviewed.
  • type: Type of reviewable object (e.g., "product").
• date_created: Date and time when the review was created (ISO 8601 format).
• status: Review status (e.g., "published", "pending").
• title: Review title provided by the buyer.
• content: Full text content of the review.
• rate: Star rating given by the buyer (1 to 5).
• valorization: Numeric value indicating the review's quality score.
• likes: Number of users who found this review helpful.
• dislikes: Number of users who found this review unhelpful.
• reviewer_id: Reviewer's user ID (obfuscated, always returns 0).
• buying_date: Date when the product was purchased (ISO 8601 format).
• relevance: Numeric score indicating the review's relevance ranking.
• forbidden_words: Numeric indicator for content moderation flags.

rating_average: Average star rating across all reviews (decimal value from 1.0 to 5.0).

stars: Overall star rating displayed for the item.

rating_levels: Breakdown of reviews by star rating.

• one_star: Count of 1-star reviews.
• two_star: Count of 2-star reviews.
• three_star: Count of 3-star reviews.
• four_star: Count of 4-star reviews.
• five_star: Count of 5-star reviews.

helpful_reviews: Information about the most helpful reviews.

• best_max_stars: Most helpful positive review (null if none available).
• best_min_stars: Most helpful critical review (null if none available).

attributes: Array of product attributes mentioned in reviews.

quanti_attributes: Array of quantitative attributes from reviews.

quali_attributes: Array of qualitative attributes from reviews.

metadata: Additional metadata about the reviews response.

Catalog Item Reviews

To retrieve reviews for catalog items, use the catalog_product_id query parameter along with the item ID. This allows you to access aggregated reviews from all items linked to the same catalog product.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reviews/item/$ITEM_ID?catalog_product_id=$CATALOG_PRODUCT_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reviews/item/MLB1632704547?catalog_product_id=MLB14186226

Response:

{
  "paging": {
    "total": 55,
    "limit": 5,
    "offset": 0,
    "kvs_total": 55,
    "reviews_with_comment": 50
  },
  "reviews": [
    {
      "id": 90579197,
      "reviewable_object": {
        "id": "MLB14186226",
        "type": "product"
      },
      "date_created": "2020-12-29T12:06:45Z",
      "status": "published",
      "title": "Excelente custo beneficio",
      "content": "Excelente custo beneficio com recursos de celulares top (carregamento sem fio, carrega outros devices como proprio fone, boa capacidade de memoria, rapido, acabamento bonito, tela plana). Como pequena desvantagem: o tamanho da tela poderia ser um pouquiho maior, o que para alguns pode ser uma vantagem.",
      "rate": 5,
      "valorization": 1,
      "likes": 1,
      "dislikes": 0,
      "reviewer_id": 0,
      "buying_date": "2020-11-24T04:00:00Z",
      "relevance": 46,
      "forbidden_words": 50
    }
  ],
  "rating_average": 4.6,
  "stars": 5,
  "rating_levels": {
    "one_star": 3,
    "two_star": 0,
    "three_star": 3,
    "four_star": 5,
    "five_star": 44
  },
  "helpful_reviews": {
    "best_max_stars": null,
    "best_min_stars": null
  },
  "attributes": [],
  "quanti_attributes": [],
  "quali_attributes": [],
  "metadata": {}
}

Errors

The following table lists the possible errors returned by the Product Reviews API: