TRtripadvisor
Review

Report Review

Changed on

Reports an existing review as inappropriate.

<p>The report goes to moderation. This endpoint returns without waiting for the outcome. Reporting the same review twice files two reports. <p><code>404</code> means you are not licensed to access the Location. If the review does not belong to the Location, does not exist, or cannot be reported, the call returns <code>400 Bad Request</code> and <code>detail</code> says why.
post/locations/{id}/reviews/{reviewId}/report

Request

  • Base URL
    https://terra.tripadvisor.com/api
  • URL
    https://terra.tripadvisor.com/api/locations/{id}/reviews/{reviewId}/report
  • 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 report

Headers

x-oauth-tokenstring required

The listing owner's OAuth access token, sent as a bare JWT. Its sub claim names the member who files the report. The token must grant the owner-property:review:report scope.

Request body

commentstring

Free-text detail for the moderators who review the report. Optional for every reason, <code>OTHER</code> included.

reason'DUPLICATE_REVIEW' | 'WRONG_LOCATION' | 'OTHER' | 'WRITTEN_BY_COMPETITOR' | 'INAPPROPRIATE' | 'NOT_ORIGINAL_REVIEW' | 'NOT_TRAVELERS_OWN' | 'PROMOTIONAL' | 'REVIEW_NOT_CONSISTENT_WITH_RATING' | 'MORE_THAN_1_YEAR_AGO' | 'CONTAINS_PRIVATE_INFO' | 'PROMOTES_ILLEGAL_ACTIVITY' required

Why a listing owner is reporting a review as inappropriate.

suggested_location_idinteger

The ID of the Location the owner believes the review belongs to. The API reads it only when the reason is <code>WRONG_LOCATION</code> and ignores it otherwise.

Example request

{
  "reason": "WRITTEN_BY_COMPETITOR"
}

Response

Report filed for moderation

location_idinteger required
report_idinteger required

The Tripadvisor ID of the filed report. Quote it if you contact Tripadvisor about the report. The API has no endpoint to read back or withdraw a report.

review_idinteger required

Changes