The GumGum Contextual REST API URL is:
GumGum Contextual API processes HTTPS GET requests specifying a properly-formed page URL in the following format:
https://verity-api.gumgum.com/page/classify?pageUrl=<WEBPAGE_URL>
HTTP Request | GET |
Authorization Header |
|
GumGum Contextual Endpoint |
|
URL Param |
|
Callback Param |
|
Classifying the page with the GumGum Contextual 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
Note: This url will be sent to the endpoint on query param ´pageUrl´. |
To start the page analysis, submit a GET request via curl:
curl -H 'x-api-key: <YOUR_API_KEY>' 'https://verity-api.gumgum.com/page/classify?pageUrl=<TEST_URL>&callBackUrl=<YOUR_WEBHOOK_URL>' |
GumGum Contextual API returns a JSON response with Content-Type: application/json; charset=UTF-8 showing the request has the following status:
{ "dataAvailable": false, "status": "INITIATED", "pageUrl": "https://aragonresearch.com/cisco-google-and-zoom-enhance-free-meetings-to-assist-with-coronavirus/", "uuid": "deb59fc2-b8ef-4dbe-ab64-6a1950a45a76" } |
For a list of supported status messages, refer to Application Status Codes.
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:
{ "dataAvailable": true, "status": "PROCESSED", "pageUrl": "https://aragonresearch.com/cisco-google-and-zoom-enhance-free-meetings-to-assist-with-coronavirus", "uuid": "deb59fc2-b8ef-4dbe-ab64-6a1950a45a76", "verityData": {...} } |
Once the status changes to PROCESSED, the JSON page classification results are returned in the response message data payload.
Instead of hitting the endpoint and polling for the results, 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.
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.
{ "dataAvailable": true, "status": "PROCESSED", "pageUrl": "https://aragonresearch.com/cisco-google-and-zoom-enhance-free-meetings-to-assist-with-coronavirus/", "uuid": "5f48fd0e-c352-4b94-802d-fa1d645e3604", "verityData": { "processedAt": "2021-05-28T00:14:48.807Z", "expiresAt": "2021-06-27T00:14:48.807Z", "languageCode": "en", "iab": { "v1": [ { "id": "IAB19", "category": "Technology & Computing", "score": 0.52 }, { "id": "IAB7", "category": "Health & Fitness", "score": 0.13 }, { "id": "IAB19-18", "category": "Internet Technology", "score": 0.11 }, { "id": "IAB19-8", "category": "Computer Networking", "score": 0.1 }, { "id": "IAB7-37", "category": "Psychology/Psychiatry", "score": 0.09 } ], "v2": [ { "id": "596", "category": "Technology & Computing", "score": 0.56 }, { "id": "379", "category": "News and Politics", "score": 0.16 }, { "id": "600", "category": "Computer Networking", "score": 0.08, "parent": { "id": "599", "category": "Computing", "parent": { "id": "596", "category": "Technology & Computing" } } }, { "id": "635", "category": "Smartphones", "score": 0.07, "parent": { "id": "632", "category": "Consumer Electronics", "parent": { "id": "596", "category": "Technology & Computing" } } }, { "id": "388", "category": "Political Issues", "score": 0.07, "parent": { "id": "386", "category": "Politics", "parent": { "id": "379", "category": "News and Politics" } } } ] }, "keywords": [ "coronavirus", "covid-19", "pandemic", "cisco", "zoom", "free meetings", "google", "logmein", "web", "video conferencing market", "collaboration", "companies", "video meetings", "china", "larger organizations", "webex video conferencing technology", "free remote work kits", "countries" ], "safe": false, "threats": [ { "id": "GGT9", "category": "Medical", "confidence": "VERY_HIGH", "risk": "HIGH" } ], "events": [], "sentiments": [ { "sentiment": "neutral", "score": 0.73 }, { "sentiment": "positive", "score": 0.24 }, { "sentiment": "negative", "score": 0.03 } ] } } |