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.
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 Google, Facebook, Yelp, TripAdvisor, Glassdoor, Indeed, ApartmentRatings, and first-party sites we host. 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.
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
Authorizationheader. 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
| Status | Meaning |
|---|---|
401 | The bearer token is missing, expired or invalid |
403 | The token is valid but the record sits outside your account |
422 | The request failed validation — the response names the fields |
500 | Unexpected server error |
Individual endpoints may return more; each page lists its own.
Endpoints
GET — Get the list of flag reasons a review site accepts, in that site's own words.
POST — Report a review to its site with one of that site's accepted reasons and a short explanation of why.
GET — See where a review's flag stands: pending, accepted, or rejected by the site.
GET — Get the history of flags across your reviews: what was flagged, when, why, and what happened.
Updated 17 days ago
