Retrieve taxonomy

GET

/taxonomy.{content_type}

This method retrieves list of taxonomy available on Semantria side.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.semantria.com//taxonomy.'

Response Example

200 - Example 1

[
    {
        "enforce_parent_matching": true,
        "id": "string",
        "modified": "string",
        "name": "string",
        "nodes": [
            null
        ],
        "topics": [
            {
                "id": "string",
                "type": "string"
            }
        ]
    }
]

Request

Path Params

content_type

string

required

Query Params

config_id

string

optional

Identifier of configuration taxonomy linked to.

Responses

🟢200Client request accepted and queued. Server responds with the taxonomy list.

application/json

Body

array of:

enforce_parent_matching

boolean

optional

Enforces parent nodes to match on a content if the current node matches

string

required

Unique taxonomy node identifier

modified

string

required

The timestamp of the latest update of the record. Creation date of update didn't occur

name

string

required

Taxonomy name

nodes

array

optional

The list of sub-nodes associated with the current taxonomy node

topics

array[object (TaxonomyTopic) {2}]

optional

The list of the topics associated with the current taxonomy node

string

optional

Unique taxonomy topic identifier

type

string

required

Type of the topic (category or query) associated with the certain taxonomy node

🟢202Client request accepted and no taxonomy found. Server responds with empty body.

🟠401Authentication failed.

🟠402Unauthorized. Limit of system calls is reached or subscription is expired.

🔴500Server side issue. Server may respond with the details in response body.

Modified at 2022-09-10 18:38:13

Remove taxonomy nodes

Add taxonomy nodes