# API Поиска активных перевозчиков

### Описание

Поможет найти наиболее активных и заинтересованных Перевозчиков по заданному направлению.

Подходит вам, если:

- Хотите найти надежных партнеров для долгосрочного сотрудничества;
- Находитесь в поиске перевозчиков для нового или непопулярного направления;
- Не хотите размещать грузы в общем доступе и самостоятельно ищете перевозчиков, которые стабильно работают по нужному направлению.

Воспользовавшись поиском Вы увидите, как часто участники ищут грузы в заданном направлении. А также сколько объявлений о свободных ТС, потенциально интересных вам, они добавляли на сайт за указанный вами период.

Подробнее об информации, возвращаемой API, смотрите в описании метода.

### Доступ к API

Подключить API можно как и любую другую лицензию [на странице оплаты](https://billing.ati.su/addinvoice?option=1&services=566&currencyId=1).

Если у вас остались вопросы — напишите в техническую поддержку на api@ati.su.

### Метод поиска по направлению с количеством актуальных машин

Получение списка самых активных перевозчиков и количество их актуальных машин для заданного направления.

Для проверки корректности интеграции с данным API в запросе можно указать необязательный параметр, позволяющий получить демо-данные:

- `demo` - Флаг демо-режима (Boolean)

При указании этого параметра сервером будет возвращен тестовый набор данных с тем же контрактом ответа, что и в полноценном API.

<a id="post-vandamus-v2-dstats-active_firms-search"></a>

Получение активных перевозчиков по заданным параметрам

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v2/dstats/active_firms/search?demo=false' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "begin_date": "1970-01-01T00:00:00.000Z",
  "from": {
    "id": 0,
    "type": 0
  },
  "to": {
    "id": 0,
    "type": 0
  },
  "truck_type": 0,
  "truck_volume": {
    "from": 0,
    "to": 0
  },
  "truck_weight": {
    "from": 0,
    "to": 0
  },
  "volume": 0,
  "weight": 0,
  "trucks_date_from": "1970-01-01T00:00:00.000Z",
  "trucks_date_to": "1970-01-01T00:00:00.000Z"
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/paid-api/activetruckers.openapi.json)

**Описание полей запроса**
- `begin_date` — Дата, от которой ведется поиск активных фирм в формате ISO-8601
- `from` — Локация: откуда
- `from.id` — Id локации\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `from.type` — Тип локации * `0` - страна * `1` - регион * `2` - город
- `to` — Локация: куда
- `to.id` — Id локации\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `to.type` — Тип локации * `0` - страна * `1` - регион * `2` - город
- `truck_type` — Маска типа кузова\ Значение из [словаря кузовов ATI.SU](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `truck_volume` — Диапазон объёма кузова в метрах кубических
- `truck_volume.from` — Значение от
- `truck_volume.to` — Значение до
- `truck_weight` — Диапазон грузоподъёмности в тоннах
- `truck_weight.from` — Значение от
- `truck_weight.to` — Значение до
- `volume` — Объём в метрах кубических
- `weight` — Вес в тоннах
- `trucks_date_from` — Дата, от которой ведется поиск актуальных машин в формате ISO-8601. Если отсутствует в запросе, то используется значение `begin_date`
- `trucks_date_to` — Дата, до которой ведется поиск актуальных машин в формате ISO-8601. Должна быть больше даты начала поиска машин. Если отсутствует в запросе, то результат поиска не ограничивается сверху

**Пример ответа (200)**

```json
{
  "is_demo": false,
  "ok": false,
  "result": [
    {
      "actual_trucks_count": 0,
      "id": "string",
      "inn": "string",
      "search_count": 0,
      "sum_count": 0,
      "trucks_count": 0
    }
  ]
}
```

**Описание полей ответа**
- `is_demo` — Это демо-данные?
- `ok` — Успешно?
- `result` — Список активных фирм
- `result[].actual_trucks_count` — Сколько в данный момент у пользователя есть машин по этому направлению
- `result[].id` — ID фирмы
- `result[].inn` — ИНН фирмы, если указан
- `result[].search_count` — Сколько за период представители этой фирмы искали грузы по выбранному направлению
- `result[].sum_count` — Сумма search_count и trucks_count
- `result[].trucks_count` — Сколько за период представители этой фирмы размещали машин по выбранному направлению на вкладке "Транспорт"

**Пример ответа (400)**

```json
{
  "details": "?",
  "error_code": "string",
  "error_list": [
    {}
  ],
  "reason": "string"
}
```

**Описание полей ответа**
- `details` — Детали ошибки
- `error_code` — Код ошибки
- `error_list` — Список вложенных ошибок
- `reason` — Причина ошибки
---

## llms.txt

Индекс ключевых страниц документации для LLM и AI-агентов доступен в [основном llms.txt](https://ati.su/developers/llms.txt).