The article on using the PHP command line client shows how to make a request and get an XML response back.
Here are some quick xml tag definitions for your reference:
- catid: category id. Calls to /rest/uris/{URL} will return the id of the category rather than the name.
- catname: category name. ie. catid 50 maps to Search Engines.
- catgroup: category group. Are categories are divided into 4 groups: Security, Legal Liability, IT Resources, and Productivity.
- conf: confidence. From 1-100, how confident BrightCloud is with the classification.
- bcri: BrightCloud Reputation Index. A security related score based on BrightCloud's knowledge on the URL. 80-100 is trustworthy, 60-79 is low risk, 40-59 is moderate risk, 20-39 is suspicious, and 0-19 is high risk.
- a1cat: all 1 cat. The subdomains of the url are all of the same category.