Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Start with http:// or https://.

  • Have a properly URL-encoded address.

  • Any request parameter values must be properly URL-encoded.

Example Page Request

Classifying the page with the Verity API is a simple two-step process. This example shows a request to analyze a web page, including its text and any prominent image detected. The example page URL is:

https://aragonresearch.com/cisco-google-and-zoom-enhance-free-meetings-to-assist-with-coronavirus

Step 1 – Submit a GET page classification request

To start the page analysis, submit a GET request via curl:

...

For a list of supported status messages, refer to Application Status Codes.

Step 2 – Poll the endpoint

Poll the same endpoint specified in Step 1.  Within a short period, once analysis of the page and its associated image is complete, a status change occurs and the returned message updates to:

...

Note: You can also specify a callBackUrl in a GET request. The JSON classification results are then returned only to the callBackUrl, and not the response message data payload. See Integrating a Webhook for an example GET request with a callBackUrl.

Example Page JSON Response Body

The JSON response details the complete brand safety, keyword, and categorization analysis data for the page and its any prominent image detected.  See JSON Response for details about the fields included in the response.

...