---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/reference/GetKeywordsSuggestion.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetKeywordsSuggestion.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# GetKeywordsSuggestion
Возвращает подсказки к ключевым словам.
## Ограничения

При вызове метода расходуются баллы. Если баллов недостаточно, возвращается сообщение об ошибке [152](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#ErrorCode152).


## Входные данные {#input}

Ниже показана структура входных данных в формате JSON.

```javascript
{
   "method": "GetKeywordsSuggestion",
   "param": {
      /* KeywordsSuggestionInfo */
      "Keywords": [
         (string)
         ...
      ]
   }
}
```

Ниже приведено описание параметров.


#|
||
**<sup >Параметр</sup>**
|
**<sup >Описание</sup>**
|
**<sup >Требуется</sup>**
||

||
**<sub >Объект KeywordsSuggestionInfo</sub>**
||
||
`Keywords`
|
Массив фраз, для которых требуется получить подсказки (кодировка UTF-8).

Фразы могут состоять из нескольких ключевых слов. Метод не возвращает подсказки, если слова относятся к предметным областям, которые не связаны друг с другом, например [холодильник учебник].
|
Да
||
|#


## Результирующие данные {#output}

Метод возвращает подсказки к ключевым словам (до 20 фраз). Ниже показана структура результирующих данных в формате JSON.

```javascript
{
   "data": [
      (string)
      ...
   ]
}
```


## Примеры входных данных {#example}

## Python

```python
{
   'Keywords': [u'холодильник',u'камера']
}
```

## PHP

```php
array(
   'Keywords' => array('холодильник','камера')
)
```

## Perl

```perl
{
   'Keywords' => ['холодильник','камера']
}
```