Semantria-Powered Text Analysis Features

Request

To include Semantria-powered text analysis in your Article API response, include the following additional arguments:

ArgumentDescription
textAnalysis
Pass either &textAnalysis or request the field textAnalysis to return the Semantria-powered object in your response.
semantriaKey
Include your Semantria API key (available from your Semantria dashboard).
semantriaSecret
Include your Semantria API secret (available from your Semantria dashboard).

Response

When using the above parameters, your Article API response will include a textAnalysis object, including the following Semantria objects: autoCategories, entities, phrases, themes, topics and overall text sentiment. Sample response:

"textAnalysis": {
   "sentiment":{
      "sentiment":"neutral",
      "sentiment_score":0.16984577
   },
   "topics":[
      {
         "sentimentPolarity":"neutral",
         "title":"Business",
         "strengthScore":1.0288622,
         "hitCount":0,
         "sentimentScore":0.16
      },
      {
         "sentimentPolarity":"neutral",
         "title":"Software and Internet",
         "strengthScore":0.66311085,
         "hitCount":0,
         "sentimentScore":0.35878357
      },
      {
         "sentimentPolarity":"neutral",
         "title":"Technology",
         "strengthScore":0.5827793,
         "hitCount":0,
         "sentimentScore":0.14941517
      }
   ],
   "themes":[
      {
         "sentimentPolarity":"positive",
         "concept":"artificial intelligence work",
         "isAbout":false,
         "strengthScore":2.191726,
         "evidence":7,
         "sentimentScore":0.56
      },
      {
         "sentimentPolarity":"positive",
         "concept":"Diffbot knowledge graph",
         "isAbout":true,
         "strengthScore":2.1505294,
         "evidence":7,
         "sentimentScore":3.3855999
      },
      {
         "sentimentPolarity":"positive",
         "concept":"semantic data",
         "isAbout":true,
         "strengthScore":2.138518,
         "evidence":7,
         "sentimentScore":1.6089513
      },
      {
         "sentimentPolarity":"positive",
         "concept":"using machine",
         "isAbout":true,
         "strengthScore":2.138518,
         "evidence":7,
         "sentimentScore":1.7184318
      },
      {
         "sentimentPolarity":"positive",
         "concept":"learning algorithms",
         "isAbout":true,
         "strengthScore":2.138518,
         "evidence":7,
         "sentimentScore":1.7731719
      }
   ],
   "phrases":[
      {
         "sentimentPolarity":"positive",
         "title":"smartphones",
         "isNegated":false,
         "sentimentScore":1.35,
         "type":"detected",
         "negatingPhrase":null
      },
      {
         "sentimentPolarity":"negative",
         "title":"effective",
         "isNegated":true,
         "sentimentScore":-0.6,
         "type":"detected",
         "negatingPhrase":"not"
      },
      {
         "sentimentPolarity":"positive",
         "title":"significantly",
         "isNegated":false,
         "sentimentScore":0.9889138,
         "type":"detected",
         "negatingPhrase":null
      },
      {
         "sentimentPolarity":"negative",
         "title":"artificial",
         "isNegated":false,
         "sentimentScore":-0.48759997,
         "type":"detected",
         "negatingPhrase":null
      },
      {
         "sentimentPolarity":"positive",
         "title":"entire range",
         "isNegated":false,
         "sentimentScore":0.608809,
         "type":"detected",
         "negatingPhrase":null
      },
      {
         "sentimentPolarity":"neutral",
         "title":"Skrillex song",
         "isNegated":null,
         "sentimentScore":null,
         "type":"possible",
         "negatingPhrase":null
      },
      {
         "sentimentPolarity":"neutral",
         "title":"instant reviews",
         "isNegated":null,
         "sentimentScore":null,
         "type":"possible",
         "negatingPhrase":null
      },
      {
         "sentimentPolarity":"neutral",
         "title":"Android smartphone",
         "isNegated":null,
         "sentimentScore":null,
         "type":"possible",
         "negatingPhrase":null
      },
      {
         "sentimentPolarity":"neutral",
         "title":"soon work",
         "isNegated":null,
         "sentimentScore":null,
         "type":"possible",
         "negatingPhrase":null
      },
      {
         "sentimentPolarity":"neutral",
         "title":"semantic data",
         "isNegated":null,
         "sentimentScore":null,
         "type":"possible",
         "negatingPhrase":null
      }
   ],
   "autoCategories":[
      {
         "title":"Internet",
         "strengthScore":1,
         "subCategories": [
            {
               "strengthScore": 0.5909194,
               "title": "Web_syndication"
            },
            {
               "strengthScore": 0.51794964,
               "title": "Web_design"
            }
         ]
      },
      {
         "title":"IT",
         "strengthScore":1,
         "subCategories": [
            {
               "strengthScore": 0.5565067,
               "title": "Cloud_platforms"
            },
            {
               "strengthScore": 0.4739992,
               "title": "Data_warehousing"
            }
         ]
      },
      {
         "title":"Computer_Science",
         "strengthScore":1
      },
      {
         "title":"Mobile_Phones",
         "strengthScore":0.77090555
      },
      {
         "title":"Computers",
         "strengthScore":0.7093105
      }
   ],
   "entities":[
      {
         "sentimentPolarity":"positive",
         "title":"Google",
         "isAbout":true,
         "confident":true,
         "evidence":7,
         "sentimentScore":2.452183,
         "type":"Company"
      },
      {
         "sentimentPolarity":"positive",
         "title":"Microsoft",
         "isAbout":true,
         "confident":true,
         "evidence":7,
         "sentimentScore":0.9013969,
         "type":"Company"
      },
      {
         "sentimentPolarity":"positive",
         "title":"Mike Tung",
         "isAbout":true,
         "confident":true,
         "evidence":7,
         "sentimentScore":2.8511598,
         "type":"Person"
      },
      {
         "sentimentPolarity":"positive",
         "title":"Peter Kerwin",
         "isAbout":false,
         "confident":true,
         "evidence":7,
         "sentimentScore":0.75828093,
         "type":"Person"
      },
      {
         "sentimentPolarity":"neutral",
         "title":"George Clooney",
         "isAbout":false,
         "confident":true,
         "evidence":6,
         "sentimentScore":0.07280645,
         "type":"Person"
      }
   ]
}