/similar

This endpoint returns a list of term that are similar to specific keywords about a skill, occupation or domain of knowledge.

Request

GET https://api.inokufu.com/domcomp/v1/similar

Headers

The API key must be included in the header.

"x-api-key": "SAY-FRIEND-AND-ENTER"

Make sure to replace SAY-FRIEND-AND-ENTER with the demo key or your own Developer API key.

Query Parameters

Query parameters must be included in the URL.

Parameter	Type	Default	Required	Description
keywords	string		Yes	Keywords describing a skill, occupation or domain of knowledge for which you want to find similar terms in other taxonomies or frameworks.
lang	string	en	Yes	Language of the query such as en (english) or fr (french).

Code examples

curl "https://api.inokufu.com/domcomp/v1/similar?keywords=weld&lang=en"
-H "x-api-key: SAY-FRIEND-AND-ENTER"

Response

Response parameters

Parameter	Required	Description
label	Yes	The title of the term according to the source (see below)
source	Yes	The name or the corresponding taxonomy or framework
score	No	This number is an indication of the confidence of the match between the keywords and the label. The higher the score, the better.

Response example

Here is an example of the JSON structured response provided by this endpoint.

{
    "statusCode": 200,
    "request": {
        "keywords": "weld",
        "lang": "en"
    },
    "response": [
        {
            "label": "welder",
            "score": 1.0,
            "source": "Inokufu DomComp index"
        },
        {
            "label": "welding",
            "source": "Inokufu DomComp synonym"
        },
        {
            "label": "operate welding equipment",
            "source": "ESCO classification"
        },
        {
            "label": "weld underwater",
            "source": "ESCO classification"
        },
        {
            "label": "weld in hyperbaric conditions",
            "source": "ESCO classification"
        },
        {
            "label": "weld mining machinery",
            "source": "ESCO classification"
        },
        {
            "label": "apply thermite welding techniques",
            "source": "ESCO classification"
        },
        {
            "label": "join metals",
            "source": "ESCO classification"
        },
        {
            "label": "perform tungsten inert gas welding",
            "source": "ESCO classification"
        },
        {
            "label": "welding coordinator",
            "source": "ESCO classification"
        },
        {
            "label": "perform metal active gas welding",
            "source": "ESCO classification"
        },
        {
            "label": "perform metal inert gas welding",
            "source": "ESCO classification"
        }
    ]
}