Flag a review

Report a review to its site with one of that site's accepted reasons and a short explanation of why. If a flag is already pending on the review, this updates it. Use this when a review is fake, abusive, about the wrong business, or otherwise breaks the site's rules. Check is_flaggable on the review first; some reviews can't be flagged: the review is more than 14 days old, its site doesn't accept flags, the flag was already decided, or the review site isn't connected. Indeed requires several extra fields about your business. The flag is submitted with status pending and appears in the review's history. If the review was already flagged and decided, you get a 400 telling you to check the site. If the review is past its flagging window, you get a 403. If your plan's flagging allowance is used up, you get a 402 saying so.

Prerequisites: a bearer token, the review's id (reviewId) and a reason for the review's site from Get the reasons a site accepts. The review must be on a site that accepts flags (one with reasons in Get the reasons a site accepts) and no more than 14 days old, counted from its review date; some partners have a partner-specific window. For sites other than Google and Facebook, the review site must be connected for the location.

Authentication: Partner or Account token. The review must be on one of the locations your token can reach (a Partner token reaches every location under the partner, an Account token its own locations); otherwise 403.

Rate limit: none.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
Defaults to 279309

Required. The review to flag. Digits only. Must exist.

Body Params
string
required
Defaults to google

The review's site name in lowercase, for example google. Must be a site that accepts flags (one with reasons in Get the reasons a site accepts), otherwise 422.

string
required
Defaults to Review is off-topic, contains ads, or is gibberish or repetitive

The site's full description of the reason (reason from Get the reasons a site accepts).

string
required
length ≤ 255
Defaults to Low quality information

The reason's short name (reason_identifier). At most 255 characters. Must be one of the reasons for the review's site, otherwise 422.

string
required
length ≤ 500
Defaults to This reviewer was never a customer and the claims are fabricated.

Your explanation of why the review breaks the site's rules. At most 500 characters.

integer | null
Defaults to 3011

The user to record as the flagger. Must exist.

string | null
enum

Not used here. Only standalone is accepted.

Allowed:
string | null

Indeed only: your response to the review, sent with the flag.

string
Defaults to Jane

Your first name. Required when review_site is indeed.

string
Defaults to Smith

Your last name. Required when review_site is indeed.

string
Defaults to Acme Plumbing

Your company's name. Required when review_site is indeed.

string
Defaults to https://www.example.com

Your company's website. Required when review_site is indeed.

string
Defaults to +15555550100

Your phone number. Required when review_site is indeed.

string
Defaults to US

Your country code. Required when review_site is indeed.

string
Defaults to United States

Your country's name. Required when review_site is indeed.

string
Defaults to 10-49

Your company's size. Required when review_site is indeed.

string
Defaults to [email protected]

Your email address. The format isn't checked. Required when review_site is indeed.

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json