Skip to main content
PUT
/
reviews
/
{review_id}
Update a review
curl --request PUT \
  --url https://api.partoo.co/v2/reviews/{review_id} \
  --header 'Content-Type: application/json' \
  --header 'x-APIKey: <api-key>' \
  --data '
{
  "state": "treated"
}
'
{
  "key": "<string>",
  "org_id": 42,
  "id": 34,
  "business_id": "5409c35a97bbc544d8e26737",
  "partner": "google_my_business",
  "partner_id": "accounts/114063712393225091258/locations/74805271119400652054",
  "author_name": "Castorche",
  "date": "2017-07-01T16:10:23.156000+02:00",
  "update_date": "2017-08-01T19:15:54.256000+02:00",
  "delete_date": "<string>",
  "rating": 3,
  "recommended": true,
  "title": "<string>",
  "content": "Magasin un peu vieillot , mais personnel très sympathique, nombreuses références en rayons , un très bon choix côté vin...",
  "state": "treated",
  "link": "<string>",
  "comments": {
    "id": 82938,
    "partner_id": "accounts/114063712393225091258/locations/74805271119400652054",
    "created": "2019-08-01T19:15:54.256000+02:00",
    "author_name": "Castorche",
    "content": "Merci ❤️",
    "date": "2017-08-01T19:15:54.256000+02:00",
    "update_date": "2017-08-01T19:15:54.256000+02:00",
    "can_edit": true,
    "review_id": 34,
    "parent_id": 123,
    "user_id": "123456789abcdef2f60c42ff",
    "is_reply_suggestion": true,
    "replies": "<array>"
  },
  "tags": [
    {
      "id": 25,
      "label": "food",
      "color": "#808080"
    }
  ],
  "media_links": [
    "https://lh3.googleusercontent.com/gpms...",
    "https://lh3.googleusercontent.com/gpms-cs-s/AB8u6HYwO..."
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.partoo.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-APIKey
string
header
required

The authentication system on Partoo API is using API Key that should be put in the header of the request (the name of the header is x-APIKey). An api_key is linked to a user. This user's role will give you different access level to the API features.

Path Parameters

​
review_id
integer
required

Review id

Example:

34

Body

application/json

Request body to post a reply

​
state
enum<string>
required

Reply state

Available options:
treated,
not_treated

Response

OK

Business Review on partner

​
key
string
​
org_id
integer

Unique identifier of an organization in Partoo.

Example:

42

​
id
integer

Review id

Example:

34

​
business_id
string

Business id

Example:

"5409c35a97bbc544d8e26737"

​
partner
enum<string>

Publisher label

Available options:
google_my_business,
facebook,
tripadvisor
​
partner_id
string

Review id on publisher

Example:

"accounts/114063712393225091258/locations/74805271119400652054"

​
author_name
string

The author name of the review.

Note: Replies don't have an author.

Example:

"Castorche"

​
date
string<datetime>

Review creation date

Example:

"2017-07-01T16:10:23.156000+02:00"

​
update_date
string<datetime>

Review update date

Example:

"2017-08-01T19:15:54.256000+02:00"

​
delete_date
string<datetime>

Review deletion date (only specified if the review has been deleted)

​
rating
integer

Review rating (can be null)

Required range: 0 <= x <= 5
Example:

3

​
recommended
boolean

Review recommended (can be null)

​
title
string

Review title

​
content
string

Review body content

Example:

"Magasin un peu vieillot , mais personnel très sympathique, nombreuses références en rayons , un très bon choix côté vin..."

​
state
enum<string>

Reply state

Available options:
treated,
not_treated,
deleted
Example:

"treated"

​
link
string<uri>

Link to review on publisher platform

​
comments
object

Reply to a review

​
tags
object[]

Tags associated to the review

​
media_links
string<uri>[]

Array of Google photo URLs associated with the review.

Populated when with_media_links=true query parameter is used. Empty array if no associated media found or if with_media_links=false.

Example:
[
  "https://lh3.googleusercontent.com/gpms...",
  "https://lh3.googleusercontent.com/gpms-cs-s/AB8u6HYwO..."
]