Get reviews summary

See the product's average ratings and overall evaluation.

This endpoint is not available by default. Please contact us for this endpoint to be enabled in your account.

Get a review summary for a product

get

https://api-tiqt-test.steq.it/v2https://api.tiqets.com/v2

/products/{productId}/reviews/summary

Retrieves detailed rating information and an AI summary for a specific product.

Path parameters

productIdintegerRequired

The ID of product

Example: 974092

Query parameters

langstringOptional

Language of the content to retrieve (ISO 639-1). Defaults to English if undefined.

Default: enExample: en

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Responses

200

Successful response

application/json

400

Bad Request -- Check your request parameters (typo in parameter or invalid value).

application/json

401

Unauthorized -- Your API key is incorrect.

application/json

403

Forbidden -- The endpoint or parameters are not allowed for the matching API key.

application/json

404

Not Found -- Requested resource/endpoint could not be found.

application/json

405

Method Not Allowed -- Check your request method.

application/json

429

Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.

application/json

500

Internal Server Error -- We had a problem with our server. Try again later.

application/json

501

Not Implemented

503

Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

application/json

get

/products/{productId}/reviews/summary

HTTPcURLJavaScriptPython

GET /v2/products/{productId}/reviews/summary HTTP/1.1
Host: api-tiqt-test.steq.it
Authorization: Token <Partner_API_key>.
Accept: */*

{
  "product_id": 12345,
  "average_rating": 4.3,
  "rating_count": 128,
  "rating_distribution": {
    "1": {
      "count": 2,
      "percentage": 1.6
    },
    "2": {
      "count": 3,
      "percentage": 2.3
    },
    "3": {
      "count": 10,
      "percentage": 7.8
    },
    "4": {
      "count": 35,
      "percentage": 27.3
    },
    "5": {
      "count": 78,
      "percentage": 60.9
    }
  },
  "average_rating_per_category": {
    "value_for_money": 4.8,
    "info_onsite": 3.5
  },
  "average_rating_per_traveler_type": {
    "alone": 5,
    "friends": 5,
    "partner": 5,
    "family": 4.6,
    "colleagues": 4.8
  },
  "reviews_summary": "Customers recommended the Guinness Storehouse for its informative self-guided tour, covering the history and brewing process of Guinness. Many appreciated the panoramic views from the Gravity Bar and the free pint included. However, customers mentioned it can be crowded, especially at the bar, and advised booking tickets in advance.",
  "supplier_average_rating": 4.5
}