---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/leads/get.md
  - https://yandex.com/dev/direct/doc/ru/leads/get.md
  - href: ru/leads/get.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/ref-v5/leads/get.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt

# get

Возвращает данные, введенные пользователями в формы на Турбо-страницах и лендингах Директа. 


## Узнайте больше

- [Как работает метод get](https://yandex.ru/dev/direct/doc/ru/best-practice/get)

## Ограничения {#restrictions}

Метод возвращает не более 10 000 объектов. 

## Запрос {#input}

Структура запроса в формате JSON:

```javascript translate=no
{
  "method": "get",
  "params": { /* params */
    "SelectionCriteria": { /* LeadsSelectionCriteria */
      "TurboPageIds": [(long), ... ], /* required */
      "DateTimeFrom": (string),
      "DateTimeTo": (string)
    }, /* required */
    "FieldNames": [( "SubmittedAt" | "TurboPageId" | "TurboPageName" | "Id" | "Data" ), ... ], /* required */
    "Page": {  /* LimitOffset */
      "Limit": (long),
      "Offset": (long)
    }
  }
}
```

#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||

||
**Структура params (для JSON) / GetRequest (для SOAP)**
||
||
`SelectionCriteria`
|
LeadsSelectionCriteria
|
Критерии отбора данных, введенных пользователями в формы на Турбо-страницах.
|
Да
||
||
`FieldNames`
|
array of LeadFieldEnum
|
Имена параметров верхнего уровня, которые требуется получить.
|
Да
||
||
`Page`
|
LimitOffset
|
Структура, задающая страницу при [постраничной выборке](https://yandex.ru/dev/direct/doc/ru/best-practice/get#page) данных.
|
Нет
||

||
**Структура LeadsSelectionCriteria**
||
||
`TurboPageIds`
|
array of long
|
Отбирать данные, введенные пользователями в формы на Турбо-страницах и лендингах Директа, с указанными идентификаторами. От 1 до 1000 элементов в массиве.
|
Да
||
||
`DateTimeFrom`
|
string
|
Начало периода, за который требуется получить данные. Указывается в формате YYYY-MM-DDThh:mm:ssZ (согласно ISO 8601).
|
Нет
||
||
`DateTimeTo`
|
string
|
Окончание периода, за который требуется получить данные. Указывается в формате YYYY-MM-DDThh:mm:ssZ (согласно ISO 8601).
|
Нет
||
|# 

## Ответ {#output}

Структура ответа в формате JSON:

```javascript translate=no
{
  "result": { /* result */
    "Leads": [{ /* LeadGetItem */
      "Id": (string), /* required */
      "SubmittedAt": (string), /* required */
      "TurboPageId": (string), /* required */
      "TurboPageName": (string), /* required */
      "Data": [{ /* LeadDataItem */
        "Name": (string), /* required */
        "Value": (string) /* required */
      }, ... ] /* required */
    }, ... ],
    "LimitedBy": (long)
  }
}
```

#|
||
**Параметр**
|
**Тип**
|
**Описание**
||

||
**Структура result (для JSON) / GetResponse (для SOAP)**
||
||
`Leads`
|
array of LeadGetItem
|
Данные, введенные пользователями в формы на Турбо-страницах.
||
||
`LimitedBy`
|
long
|
Порядковый номер последнего возвращенного объекта. Передается в случае, если количество объектов в ответе было ограничено лимитом. См. раздел [Постраничная выборка](https://yandex.ru/dev/direct/doc/ru/best-practice/get#page).
||

||
**Структура LeadGetItem**
||
||
`Id`
|
string
|
Идентификатор данных, введенных пользователем в форму.
||
||
`SubmittedAt`
|
string
|
Дата и время заполнения формы. Выводится в формате YYYY-MM-DDThh:mm:ssZ (согласно ISO 8601).
||
||
`TurboPageId`
|
string
|
Идентификатор Турбо-страницы или лендинга, на которых заполнена форма.
||
||
`TurboPageName`
|
string
|
Название Турбо-страницы или лендинга, на которых заполнена форма.
||
||
`Data`
|
array of LeadDataItem
|
Данные, введенные пользователем.
||

||
**Структура LeadDataItem**
||
||
`Name`
|
string
|
Название поля формы.
||
||
`Value`
|
string
|
Значение, введенное пользователем.
||
|#