Поиск лидов

POST

/api/leads/search

Возвращает список лидов для проекта с фильтрацией и пагинацией. Фильтры передаются в JSON body.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/leads/search' \
--header 'Accept-Language;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "project_id": "550e8400-e29b-41d4-a716-446655440000",
    "filters": {
        "channel_ids": [
            "550e8400-e29b-41d4-a716-446655440000"
        ],
        "channel_type": "vk",
        "is_subscribed": true,
        "is_blacklisted": false,
        "search": "Иван"
    },
    "limit": 50,
    "offset": 0
}'

Response Example

{
    "leads": [
        {
            "id": "507f1f77bcf86cd799439011",
            "channel_id": "550e8400-e29b-41d4-a716-446655440001",
            "channel_type": "vk",
            "external_user_id": "12345",
            "first_name": "Иван",
            "last_name": "Иванов",
            "username": "@ivan",
            "avatar_url": "https://vk.com/avatar.jpg",
            "is_subscribed": true,
            "is_blocked": false,
            "is_blacklisted": false,
            "blacklisted_at": "2025-12-14T14:00:00Z",
            "blacklist_reason": "Спам",
            "lead_source": "group_join",
            "lead_type": "user",
            "language_code": "ru",
            "created_at": "2025-12-14T12:00:00Z",
            "updated_at": "2025-12-14T12:30:00Z",
            "last_interaction_at": "2025-12-14T12:25:00Z",
            "unsubscribed_at": "2025-12-14T13:00:00Z",
            "last_profile_sync_at": "2025-12-14T14:00:00Z"
        }
    ],
    "total": 150,
    "limit": 50,
    "offset": 0
}

Modified at 2026-03-16 08:18:51

Получить список доступных платформ

Получить лида по ID