Spoken Keywords


The Spoken Keywords insight contains track-level data. track_data is an array containing an object for each track. Each object contains the track_id and track_label of the track, as well as the following:

keywords

Keywords are important terms spoken in the audio.

The keywords list contains objects with:
  • term - the word
  • weight - a score which signifies the term's relevance
  • count - the number of times which the term was spoken

entities (invite only)

Named entities are proper nouns or other entities spoken in the audio. These include people's names, place names, organization names, dates, currency amounts etc.

The entities list contains objects with:
  • term - the entity
  • weight - a score which signifies the term's relevance
  • type - the type of entity
The possible type values are:
  • person - a person's name. This may be full name or just first or last name
  • location - a geographical location such as country, state, city, etc.
  • product - a product or brand name
  • organization - any type of organization or group
  • date - a full date or partial date such as a month, a year, a day of the week etc.
  • money - a monetary value spoken in the audio, for example "100 dollars"
  • percent - a percentage value spoken in the audio

Sample Response

An example insight:spoken_keywords response:
{
    "bundle_id": "abcde12345",
    "created": "2015-05-16T20:39:37.507Z",
    "id": "54321edcba",
    "name": "spoken_keywords",
    "status": "ready",
    "track_data": [
        {
            "track_id": "fff111",
            "track_label": "",
            "keywords": [
                {
                    "count": 11,
                    "term": "horse",
                    "weight": 0.917
                }, {
                    "count": 9,
                    "term": "uncle",
                    "weight": 0.75
                }, {
                    "count": 7,
                    "term": "dorothy",
                    "weight": 0.583
                }, {
                    "count": 5,
                    "term": "little",
                    "weight": 0.417
                }, {
                    "count": 4,
                    "term": "train",
                    "weight": 0.333
                }
            ]
        }
    ],
    "updated": "2015-05-16T20:39:37.508Z",
    "_class": "SpokenKeywordsInsight",
    "_links": {
        "clarify:bundle": {
            "href": "/v1/bundles/abcde12345"
        },
        "curies": [
            {
                "href": "/docs/rels/{rel}",
                "name": "clarify",
                "templated": true
            }
        ],
        "parent": {
            "href": "/v1/bundles/abcde12345/insights"
        },
        "self": {
            "href": "/v1/bundles/abcde12345/insights/54321edcba"
        }
    }
}
Fork me on GitHub