When an article is published (or prior to publishing) –
Call the Mantis ‘classifyArticle’ api endpoint for the publisher’s Mantis account (to be provided) e.g.
https://<publisher-mantis-url>/classifyArticle
- POST article data in the call to this URL, as a JSON object in the request body including:
- HTML content (just send the article body content itself, not a whole page with headers/footers/links and teasers for other articles/commercial and other embedded components) – or plain text of the article content.
- Public Page URL (currently live or what the URL will be for unpublished articles)
- CMS id (publisher specific unique article reference id)
- Author(s)
- Title
- Published/last modified timestamps
- Pass publisher authentication credentials (to be provided) using an HTTP Basic authentication header
The article will be processed and Brand Safety ratings will be generated – and returned from the Mantis API in the response body as JSON data.
The publisher could choose to store Brand Safety ratings in their CMS or own database
– However be aware any changes to the ratings models won’t be reflected in this
locally stored data unless the publisher implements a process to refresh the stored data