# NLU / NLP Methods

These are the methods that actually perform analysis and transformation of input text.

## Analyze text

 - [POST /parse](https://docs.tisane.ai/apis/tisane-api-short/nlu-nlp-methods/parse.md): The method analyzes the input and detects problematic content, sentiment snippets, entities, topics, phrase structure, parts of speech, stopwords, and more.

## List available languages

 - [GET /languages](https://docs.tisane.ai/apis/tisane-api-short/nlu-nlp-methods/languages.md): Retrieve a list of supported languages. 

The response includes the following attributes:
*  - Language ID.
*  - Native name.
*  - English name.
*  - Encoding of the language.
*  - Recommended font for display.
*  - Whether the language uses Latin script.
*  - Whether the language uses right-to-left script (e.g., Arabic, Hebrew, Persian).

## Text clean-up

 - [POST /helper/extract_text](https://docs.tisane.ai/apis/tisane-api-short/nlu-nlp-methods/extract_text.md): A service method to remove JavaScript, CSS tags, JSON, and other markup, returning pure decoded text.
The request body includes the markup content from which text will be extracted.



## Named entity comparison

 - [POST /compare/entities](https://docs.tisane.ai/apis/tisane-api-short/nlu-nlp-methods/compareentities.md): Compares two compound named entities and identifies differences.
The request body should include:
*  (string) - IETF tag for the first entity's language.
*  (string) - The first entity.
*  (string) - IETF tag for the second entity's language.
*  (string) - The second entity.
*  (string) - The entity type (currently only _person_ is supported).

More information: Named Entities in the Tisane API Response Guide
The response contains:
*  (string) - Comparison result:
  *  - One or both entities are invalid.
  *  - Entities are identical (name order might differ).
  *  - Entities differ, with details in .

*  (array of strings) - Lists detected differences:
  * 
  * 
  *  (e.g., Mr., Mrs.)
  *  (e.g., academic degrees)
  * 
  *  (e.g., spelling or style differences)

## Semantic similarity

 - [POST /similarity](https://docs.tisane.ai/apis/tisane-api-short/nlu-nlp-methods/similarity.md): Calculate the semantic similarity between two text fragments, either in the same language or in different languages.

The request body should contain:
*  (string) - The first text fragment.
*  (string) - The IETF language code for .
*  (string) - The second text fragment to compare.
*  (string) - The IETF language code for .
*  (object) - Additional settings as per specifications. More information: Tisane API Configuration And Customization Guide.

The response is a number between 0 and 1, representing the similarity of the submitted text fragments.

## Detect language

 - [POST /detectLanguage](https://docs.tisane.ai/apis/tisane-api-short/nlu-nlp-methods/detectlanguage.md): Detects the languages used in the provided text fragment and returns the breakdown by offsets.

The request body should include:
*  (string) - the text fragment to analyze.
*  (string, optional) - a vertical bar-delimited list of language codes to use as cues.
*  (string, optional) - a regular expression for segmenting the fragment; by default, the fragment is not segmented.
The response is a JSON structure containing , which provides a breakdown of language codes.

## Translate text

 - [POST /transform](https://docs.tisane.ai/apis/tisane-api-short/nlu-nlp-methods/transform.md): This method translates the input text.
The request body should include the following elements:
*  (string) - A standard IETF tag for the source language. Use  or a vertical bar-delimited set of language codes to invoke autodetect.
*  (string) - A standard IETF tag for the target language. If the source and target languages are the same, paraphrasing will be applied.
*  (string) - The text content to translate.
*  (object) - Additional translation settings.

More information: Tisane API Configuration And Customization Guide

The response is the transformed text.