Sign in

v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB
Review analytics

Global reviews statistics

This endpoint let you view the global reviews statistics for all your businesses subscribed to Review Management.

You can use the following filters:

  • by date (statistics before and/or after a date)
  • by businesses (businesses id in list or not in list)
  • by keywords

The response is aggregated according to the previously selected filters.

In order to get analytics evolution overtime returned by specific time range, please refer to Qualitative Evolution and Quantitative Evolution endpoints.

get/reviews/stats

Query parameters

business__inBusinessId[]

Filter by business ids

Return the reviews of the businesses given in list.

[
  "5409c35a97bbc544d8e26737"
]
keywordsstring[]

Filter by keywords

Return all the reviews with not-nullable content, that contain the provided list of keywords.

Note: This is the content of the review and not the content of the reply.

The filter accepts both simple and composed words. To indicate it's a composed keyword, add the + as separator. For example:

  • keywords=bonjour returns all reviews containing the keyword bonjour
  • keywords=good+service returns all reviews containing the combined keyword good service, without splitting the keyword. No reviews containing just good or just service will be returned.
  • keywords=bonjour,good+service: returns all reviews that contain either just bonjour, either just good service or both keywords at the same time.
update_date__gtestring datetime
Example:2017-08-01T00:00:00

Filter by update_date

Return all the reviews whose update_date >= given_date.

For example : update_date__gte=2019-01-01T00:00:00 will return all reviews from the first January of 2019 until today.

Note : The update dates are stored in UTC.

update_date__ltestring datetime
Example:2017-08-02T00:00:00

Filter by update_date

Return all the reviews whose update_date <= given_date.

For example : update_date__lte=2020-01-01T00:00:00 will return all reviews from the date of the first review until the first january of 2020.

Note : The update dates are stored in UTC.

Response

OK

answer_timenumber float

Average reviews answer time in seconds. Only measured for reviews with a comment from Google partner. It returns the time between the update date of a review and the creation date of its comments.

averagenumber float

Average reviews rating.

treatednumber

Total number of treated reviews.

not_treatednumber

Total number of non treated reviews.

answerednumber

Total number of answered reviews (reviews with a comment).

satisfiednumber

Total number of reviews of type satisfied.

Satisfied reviews are defined by a rating of 4 or more for google_my_business and tripadvisor or recommended for facebook.

neutralnumber

Total number of reviews of type neutral.

Neutral reviews are defined by a rating of 3 for google_my_business and tripadvisor.

dissatisfiednumber

Total number of reviews of type dissatisfied.

Dissatisfied reviews are defined by a rating of 2 or less for google_my_business and tripadvisor or not recommended for facebook.

totalnumber

Total number of reviews.

Example response

{
  "answer_time": 10493.90997409,
  "average": 3.0394,
  "treated": 9,
  "not_treated": 10,
  "answered": 8,
  "satisfied": 10,
  "neutral": 6,
  "dissatisfied": 3,
  "total": 19
}