---
title: "The API returns a list of strings denoting the key talking points in the input text."
method: POST
path: "/keyPhrases"
tags: ["Key Phrases"]
---

# The API returns a list of strings denoting the key talking points in the input text.

`POST /keyPhrases`

See the <a href="https://docs.microsoft.com/en-us/azure/cognitive-services/text-analytics/overview#supported-languages">Text Analytics Documentation</a> for details about the languages that are supported by key phrase extraction.

## Request body

- MultiLanguageBatchInput
  - `documents` MultiLanguageInput[]
    - `language` string — This is the 2 letter ISO 639-1 representation of a language. For example, use "en" for English; "es" for Spanish etc.,
    - `id` string — Unique, non-empty document identifier.
    - `text` string

## Response `200`

A successful response results in 0 or more key phrases identified in each valid document

- KeyPhraseBatchResult
  - `documents` KeyPhraseBatchResultItem[]
    - `keyPhrases` string[] — A list of representative words or phrases. The number of key phrases returned is proportional to the number of words in the input document.
    - `id` string — Unique document identifier.
  - `errors` ErrorRecord[]
    - `id` string — Input document unique identifier the error refers to.
    - `message` string — Error message.

## Other responses

- `default` — Error Response

---

[API](https://skmtc.dev/azure/apis/text-analytics-client.md) · [All operations](https://skmtc.dev/azure/apis/text-analytics-client/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/text-analytics-client/revisions/d82ca1bb88d0/schema)