Named Entity Recognition API

Named Entity Recognition API extracts the important keywords from natural language texts in your domain.

API Server

nlu-api.allganize.ai is Allganize's NLU API endpoint. If you are using on-prem, please use your API endpoint.

Getting API KEY

The NLU API uses API keys to authenticate requests that you can find in the Allganize NLU API dashboard. Go to Settings > General to find your API key. If you don't have an account yet, you can create one here.

Provide your API KEY in the request header API-KEY.

Error Messages

Please read the error message you get if you don't get the response that you expected. For example, if you don't use the right HTTP method for the API, you'll get this type of error as response:

{“error”: “Method Not Allowed POST: /webapi/faq_feedbacks”}

post
Named Entity Recognition API

https://nlu-api.allganize.ai/api/inference
Request
Response
Request
Headers
API-KEY
required
string
Your API key can be found on your dashboard Settings menu, under the General tab.
Body Parameters
text
required
string
Input text you want to analyze. English, Japanese, Korean, and Chinese are supported.
Response
200: OK
The response has a list of inferred results for the requested text. startIndex: The start location of the word recognized as the named entity. Shown as a number. endIndex: The end location of the word recognized as the named entity. Shown as a number. tag: They type of the named entity. The types are defined in your NLU API dashboard. token: The word recognized as the named entity.
{
"inputText": STRING,
"entities": [
{
"startIndex": NUMBER,
"endIndex": NUMBER,
"tag": STRING,
"token": STRING
}, ...
]
}

Request Example

Please replace YOUR_API_KEY to your one in the example below. Please see getting-api-key section.

curl https://nlu-api.allganize.ai/api/inference \
-d '{"text": "I am traveling from Munich to Paris by Air France business class"}' \
-H "Content-Type: application/json" \
-H "API-KEY: YOUR_API_KEY"

Response Example

{
"inputText": "I am traveling from Munich to Paris by Air France business class",
"entities": [
{"startIndex": 20, "endIndex": 26, "tag": "DEPARTURE", "token": "Munich"},
{"startIndex": 30, "endIndex": 35, "tag": "ARRIVAL", "token": "Paris"},
{"startIndex": 39, "endIndex": 49, "tag": "AIRLINE", "token": "Air France"},
{"startIndex": 50, "endIndex": 64, "tag": "SEAT_CLASS", "token": "business class"}
]
}