# Tisane

Tisane API is a natural language processing tool that detects problematic content, extracts topics, and performs aspect-based sentiment analysis across 27 languages.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 13
- **Triggers:** 0
- **Slug:** `TISANE`
- **Version:** 20260223_00

## Tools

### Analyze Text

**Slug:** `TISANE_ANALYZE_TEXT`

Tool to analyze input text for detailed NLU insights. Use after preparing text when you need to detect sentiment, entities, topics, and other linguistic features.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `content` | string | Yes | Text content to be analyzed |
| `language` | string | Yes | IETF BCP-47 language tag for the input text |
| `settings` | object | No | Optional analysis settings. Empty dict for defaults (see Tisane API Configuration Guide). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Calculate Semantic Similarity

**Slug:** `TISANE_CALCULATE_SIMILARITY`

Tool to calculate semantic similarity between two text fragments. Use when you need a numeric similarity score (0-1) for two texts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `content1` | string | Yes | First text fragment to compare. |
| `content2` | string | Yes | Second text fragment to compare. |
| `settings` | object | No | Additional settings for similarity calculation, leave empty for defaults. |
| `language1` | string | Yes | IETF language code for content1 (e.g., 'en'). |
| `language2` | string | Yes | IETF language code for content2 (e.g., 'en'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Compare Entities

**Slug:** `TISANE_COMPARE_ENTITIES`

Tool to compare two compound named entities and identify differences. Currently only supports person entity type. Use when you need to determine if two person names refer to the same individual or identify specific differences.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("person") | Yes | The entity type to compare. Currently only 'person' is supported. |
| `entity1` | string | Yes | The first entity to compare. |
| `entity2` | string | Yes | The second entity to compare. |
| `language1` | string | Yes | IETF language tag for the first entity (e.g., 'en', 'fr'). |
| `language2` | string | Yes | IETF language tag for the second entity (e.g., 'en', 'fr'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Detect Language

**Slug:** `TISANE_DETECT_LANGUAGE`

Tool to detect the language of the provided text. Use when you need to identify the language code.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | Yes | The text whose language needs to be detected. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Extract Text

**Slug:** `TISANE_EXTRACT_TEXT`

Tool to extract raw text from markup content. Use when cleaning HTML, CSS, JS, or JSON to get pure decoded text. Use after confirming the input is UTF-8 text; this does not process binary content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `content` | string | Yes | The markup (HTML, CSS, JS, JSON) to strip and decode into plain text. Must be UTF-8 text; binary content is not supported. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Family Details

**Slug:** `TISANE_GET_FAMILY_DETAILS`

Tool to fetch metadata for a family from Tisane language models, including definition, description, hypernyms, and external references (Wikidata, WordNet). Use when you need detailed information about a specific family concept by its numeric identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Numeric identifier of the family to retrieve details for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Supported Languages

**Slug:** `TISANE_GET_SUPPORTED_LANGUAGES`

Tool to list all languages supported by the API. Use when needing to discover available languages for text analysis or processing. Call before submitting text to ensure support.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Feature Values

**Slug:** `TISANE_LIST_FEATURE_VALUES`

Tool to list feature values for a particular category such as entity types, subtypes, abuse types, and tags. Use when you need to discover valid values for a specific feature category before analysis or filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("Grammar" | "Style" | "Semantics") | Yes | Feature type category to query. Must be one of: Grammar, Style, or Semantics |
| `language` | string | Yes | IETF language code for which to retrieve feature values (e.g., 'en', 'fr', 'es') |
| `description` | string | Yes | Feature list name (localized) to retrieve values for. Examples: 'tense', 'mood', 'entity_type', 'abuse_type' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Hypernyms

**Slug:** `TISANE_LIST_HYPERNYMS`

Tool to list all hypernyms related to a family. A hypernym is a parent concept (e.g., vehicle is a hypernym of truck). Use when you need to understand the conceptual hierarchy or broader categories for a given family ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `family` | string | Yes | Numeric identifier of the family to retrieve hypernyms for |
| `maxLevel` | string | Yes | Maximum distance from the family. Determines how many levels of hypernyms to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Hyponyms

**Slug:** `TISANE_LIST_HYPONYMS`

Tool to list all hyponyms related to a family. A hyponym is a child concept (e.g., 'truck' is a hyponym of 'vehicle'). Use when you need to discover more specific concepts within a semantic family.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `family` | string | Yes | Numeric identifier of the family to retrieve hyponyms for |
| `maxLevel` | string | Yes | Maximum distance (depth level) from the family to retrieve hyponyms |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Inflections

**Slug:** `TISANE_LIST_INFLECTIONS`

Tool to retrieve inflected forms of a specified lexeme within a given language family. Use when you need to get all grammatical variants of a word.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `family` | string | Yes | The family identifier to inspect (numeric ID as string) |
| `lexeme` | string | Yes | The lexeme identifier to inspect (numeric ID as string) |
| `language` | string | Yes | The language code (IETF BCP-47 format, e.g., 'en', 'ru') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Word Senses

**Slug:** `TISANE_LIST_WORD_SENSES`

Tool to fetch all senses (meanings) related to a word. Use when you need to explore word definitions, families, features, and lemma information for linguistic analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `word` | string | Yes | The word to inspect and retrieve senses for |
| `language` | string | Yes | Standard culture code (ISO-639 language code with optional country extension, e.g., 'en', 'fr', 'es') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Transform Text

**Slug:** `TISANE_TRANSFORM_TEXT`

Tool to translate or paraphrase text. Use when you need to convert content between languages or paraphrase within the same language.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | Yes | Target language IETF tag. If same as source, text will be paraphrased. |
| `from` | string | Yes | Source language IETF tag. Use '*' or 'lang1\|lang2' to auto-detect. |
| `content` | string | Yes | Text content to transform (UTF-8). |
| `settings` | object | No | Optional translation settings (see Tisane API Configuration). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |