Extract relationships | Babel Street

1 curl -X POST https://analytics.babelstreet.com/rest/v1/relationships \ 2 -H "X-RosetteAPI-Key: <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "content": "FLIR Systems is headquartered in Oregon and produces thermal imaging, night vision, and infrared cameras and sensor systems. According to the SEC’s order instituting a settled administrative proceeding, FLIR entered into a multi-million dollar contract to provide thermal binoculars to the Saudi government in November 2008. Timms and Ramahi were the primary sales employees responsible for the contract, and also were involved in negotiations to sell FLIR’s security cameras to the same government officials. At the time, Timms was the head of FLIR’s Middle East office in Dubai." 6 }'

1 { 2 "relationships": [ 3 { 4 "arg1": "foo", 5 "arg1id": "foo", 6 "arg2": "foo", 7 "arg2id": "foo", 8 "confidence": 42, 9 "predicate": "foo" 10 } 11 ] 12 }

Returns the relationships between entities in the input text.

The response is a list of extracted relationships. A relationship contains

predicate - usually the main verb, property or action that is expressed by the text
arg1 - usually the subject, agent or main actor of the relationship
arg1Id [optional] - the entity ID to link an entity to a knowledgebase
arg2 [optional] - complements the predicate and is usually the object, theme or patient of the relationship
arg2Id [optional] - the entity ID to link an entity to a knowledgebase
confidence - a measure of quality of relationship extraction, between 0 - 1

Headers

X-RosetteAPI-KeystringRequired

Request

This endpoint expects an object.

contentstringRequired

The text to be analyzed.

languagestringOptional

Three-letter ISO 693-3 language code.

Response

relationshipslist of objects or null