TRtripadvisor
Review

Submit Owner Response

Changed on

Submits an owner response to an existing review.

<p>Tripadvisor moderates the response and publishes it beneath the review once it is approved. Sending the same response again returns <code>409 Conflict</code> and does not create a duplicate. If moderation rejects the response straight away, the call returns <code>400 Bad Request</code> and <code>detail</code> says why. A review that does not belong to the Location also returns <code>400 Bad Request</code>. <p><code>404</code> means you are not licensed to access the Location.
post/locations/{id}/reviews/{reviewId}/owner-responses

Request

  • Base URL
    https://terra.tripadvisor.com/api
  • URL
    https://terra.tripadvisor.com/api/locations/{id}/reviews/{reviewId}/owner-responses
  • Auth
    API key in header X-API-Key

Path parameters

idinteger required

the Tripadvisor Location ID the review belongs to

reviewIdinteger required

the Tripadvisor ID of the review to respond to

Headers

x-oauth-tokenstring required

The listing owner's OAuth access token, sent as a bare JWT. Its sub claim names the member who writes the response. The token must grant the owner-responses:write scope.

Request body

author_connectionstring required

The responder's role at the reviewed business, such as <code>General Manager</code> or <code>Owner</code>. Free text, not an enum. It comes back exactly as sent, untranslated, as <code>author_connection</code> on the owner response.

languagestring required

The BCP-47 language tag of the response's text. The API does not infer it from the member's locale.

textstring required

The text of the response.

Example request

{
  "author_connection": "General Manager",
  "language": "en"
}

Response

Owner response accepted for moderation

idinteger required

The Tripadvisor ID of the owner response. Pass it to the read and remove endpoints. It matches the <code>id</code> on the review read endpoints.

location_idinteger required

The Location the review is about.

owner_response_uidstring required

A second identifier for the owner response. The read and remove endpoints take <code>id</code>, not this one.

review_idinteger required

The review this response was submitted for.

status'PENDING_MODERATION' | 'PUBLISHED' | 'REJECTED' | 'REMOVED' required

The moderation status of an owner response.

Changes