Moderation Results

Now that you have submitted an image to be moderated, how do you get the result?

Image moderation results can be returned using one of the following methods:

  1. Callback URL
  2. AWS Simple Notification Service
  3. Polling

Callback URL

After each moderation, our service makes a GET request to a callback URL you provide.

You can set your callback URL by logging in to your WebPurify account and selecting your image filter license.

Optionally you can set your callback URL when you submit the image for moderation using the “callback” agrument.

The callback request is always sent with at least two arguments: imgid and status. If the image was submitted with the optional “customimgid” value set, that will also be sent.


If you set your callback URL to:

A sample response after an image has been moderated would be

Possible image statuses are:

- status=1 (approved)
- status=2 (declined)

If you opted in to have images checked for matches against known child exploitation hash datasets, a match would result in:

- status=3 (match)

AWS Simple Notification Service

WebPurify can publish a JSON response for each moderated image to the SNS topic associated with the image.

To associate a SNS topic to an image, use the “snstopic” parameter when submitting an image to our service.

Please email to coordinate authentication.


You can make regular requests to the WebPurify API Method until the the status has changed from “pending”.