Flag a review for removal

Report a review to the site it's on as fake, inappropriate, or against that site's rules, and track what happens to the flag.

Flagging works on the sites that have accepted reasons set up, such as Google, Facebook, Yelp, TripAdvisor, Glassdoor, Indeed and ApartmentRatings. Get the reasons a site accepts lists them all. Each site has its own list of accepted reasons, and your flag has to use one of them, so get the site's reason list first.

A review can be flagged for 14 days from its review date. After that, is_flaggable is false and a flag returns 403. Some partners have a partner-specific window.

The sequence: get the reason list for the site → flag the review with a reason and your explanation → check the status until the site decides. While a flag is still pending you can update it; once the site has acted, you can't.

Good to know: every review from Get reviews includes is_flaggable, so you can show or hide a Flag button without guessing. Flags count against your plan's flagging allowance; when it's used up you get a clear error saying so.

You'll need the review_id from Get reviews.

Prerequisites

• A bearer token in the Authorization header. Any endpoint that needs no token says so on its own page.
• The id of each record the call targets. Every endpoint page lists the ids it needs.

Errors

Individual endpoints may return more; each page lists its own.

Endpoints