Semantic tags are ranked entities, keywords or concepts relevant for the article.

See the Tag object reference page for more information.

Sample call

You can easily try it yourself:

curl -X POST https://api.geneea.com/v3/analysis \
-H 'Authorization: user_key <YOUR USER KEY>' \
-H 'Content-Type: application/json' \
-d '{
    "id": "1",
    "text": "The trip to London was great. Only the food was weird. Especially the pizza was terrible.",
    "analyses": ["tags"],
    "domain": "voc-hospitality"

# On Windows, use \" instead of " and " instead of '

You should get the following response:

    'version': '3.2.1',
    'id': '1',
    'language': {'detected': 'en'},
    'tags': [
        {'id': 't0', 'stdForm': 'food & drink > quality', 'type': 'TOPIC', 'relevance': 10.534},
        {'id': 't1', 'stdForm': 'food & drink', 'type': 'TOPIC', 'relevance': 10.422},
        {'id': 't2', 'gkbId': 'HSP-10210', 'stdForm': 'food', 'type': 'ENTITIES', 'relevance': 6.5},
        {'id': 't3', 'gkbId': 'HSP-1091', 'stdForm': 'pizza', 'type': 'ENTITIES', 'relevance': 6.5},
        {'id': 't4', 'stdForm': 'food: weird', 'type': 'RELATIONS', 'relevance': 3.0},
        {'id': 't5', 'stdForm': 'pizza: terrible', 'type': 'RELATIONS', 'relevance': 3.0},
        {'id': 't6', 'stdForm': 'trip: great', 'type': 'RELATIONS', 'relevance': 3.0}
    'usedChars': 100

You can use "returnMentions": "true" to return the tag mentions.