Versions Compared

Key

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

...

https://verity-api.gumgum.com/page/classify?pageUrl=<WEBPAGE_URL>

The URL specified in <WEBPAGE_URL> must meet the following requirements:

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

  • Have a properly URL-encoded address.

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

...

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

...

Code Block
languagejs
curl -H 'x-api-key: <YOUR_API_KEY_HERE>’ `httpsKEY>'  'https://verity-api.gumgum.com/page/classify?pageUrl=https%3A%2F%2Faragonresearch.com%2Fcisco-google-and-zoom-enhance-free-meetings-to-assist-with-coronavirus%2F`=<TEST_URL>&callBackUrl=<YOUR_WEBHOOK_URL>'

Verity API returns a JSON response with Content-Type: application/json; charset=UTF-showing the request has the following status: 

...

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

Step 2 – Poll the endpoint

...

Code Block
languagejson
{
    "dataAvailable": true,
    "status": "PROCESSED",
    "pageUrl": "https://aragonresearch.com/cisco-google-and-zoom-enhance-free-meetings-to-assist-with-coronavirus",
    "uuid": "73146868deb59fc2-8d77b8ef-4bf04dbe-8e89ab64-eeb9d8e04cb26a1950a45a76",
    "verityData": {...}
}

Once the status changes to PROCESSED, the JSON page classification results are returned in the response message data payload.

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.

...

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.

Code Block
languagejson
{
  "dataAvailable": true,
  "status": "PROCESSED",
  "pageUrl": "https://aragonresearch.com/cisco-google-and-zoom-enhance-free-meetings-to-assist-with-coronavirus/",
  "uuid": "731468685f48fd0e-8d77c352-4bf04b94-8e89802d-eeb9d8e04cb2fa1d645e3604",
    "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.6
        },
        {
          52
        },
        {
          "id": "IAB19-8IAB7",
          
          "category": "ComputerHealth & NetworkingFitness",
          
          "score": 0.13
        },
        {
          
        },
        {
          "id": "IAB19-2318",
          
          "category": "NetInternet ConferencingTechnology",
          
          "score": 0.11
        },
        {
          
        },
        {
          "id": "IAB19-188",
          "category": "Internet Technology",
          
          "category": "Computer Networking",
          "score": 0.1
        },
        {
          "id": "IAB7-37",
          "category": "Psychology/Psychiatry",
          "score": 0.11
        }
      ],
      09
        }
      ],
      "v2": [
        {
          
        {
          "id": "596",
          
          "category": "Technology & Computing",
          
          "score": 0.66
        },
        {
          56
        },
        {
          "id": "607379",
          
          "category": "WebNews and ConferencingPolitics",
          
          "score": 0.12,
          "parent": {
            16
        },
        {
          "id": "602600",
            
          "category": "Computer Software and Applications",
             Networking",
          "score": 0.08,
          "parent": {
              
            "id": "599",
              
            "category": "Computing",
              
            "parent": {
                
              "id": "596",
                
              "category": "Technology & Computing"
              }
            }
          }
        },
        {
          
            }
          }
        },
        {
          "id": "600635",
          
          "category": "Computer NetworkingSmartphones",
          
          "score": 0.09,
          07,
          "parent": {
            
            "id": "599632",
            
            "category": "ComputingConsumer Electronics",
            
            "parent": {
              
              "id": "596",
              
              "category": "Technology & Computing"
            }
          }
        },
        {
          
            }
          }
        },
        {
          "id": "602388",
          
          "category": "Political "Computer Software and Applications",
          Issues",
          "score": 0.08,
          07,
          "parent": {
            
            "id": "599386",
            
            "category": "ComputingPolitics",
            
            "parent": {
              
              "id": "596379",
              
              "category": "TechnologyNews &and Computing"
            }
          }
        }
      ]
    },
    Politics"
            }
          }
        }
      ]
    },
    "keywords": [
      
      "coronavirus",
      "covid-19",
      "pandemic",
      "cisco",
            "zoom",
            "googlefree meetings",
            "logmeingoogle",
            "coronaviruslogmein",
            "enhanceweb",
            "meetingsvideo conferencing market",
            "assistcollaboration",
            "freecompanies",
            "andvideo meetings",
            "china",
            "jimlarger lundyorganizations",
            "customerswebex video likeconferencing zoomtechnology",
            "rise in",
      "aragon"
    ],
    free remote work kits",
      "countries"
    ],
    "safe": truefalse,
        "threats": [
      {
        "id": "GGT9",
        "category": "Medical",
        "confidence": "VERY_HIGH",
        "risk": "HIGH"
      }
    ],
        "events": [],
        "sentiments": [
            {
        
        "sentiment": "neutral",
        
        "score": 0.71
      },
      {
        73
      },
      {
        "sentiment": "positive",
        
        "score": 0.26
      },
      {
        24
      },
      {
        "sentiment": "negative",
                "score": 0.03
      }
    ]
  
      }
    ]
  }
}

More Information

Child pages (Children Display)

...