Запрос cURL
POST /api/v1/bulk-taskscurl -X POST "https://api.carrierlookup.online/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=number_activity_batch \
-F country=US \
-F [email protected]Активность номеров
Получайте сигнал активности каждого номера через асинхронное файловое задание. Сопоставляйте true/false со своими данными о взаимодействиях для проверки сегментов и приоритетов контакта.
Этот продукт доступен только как асинхронная обработка файла. Проверка оператора в реальном времени не возвращает признаки валидности или активности.
Два шага: отправьте файл, затем проверьте задачу
При отправке сразу возвращается id задачи; проверяйте задачу по этому id, и после успешного завершения ответ будет содержать ссылку для скачивания файла результата. Каждый запрос показан вместе со своим ответом.
1. Отправьте файл
id задачи возвращается сразу с preparing = true, пока файл подготавливается в фоне: некорректные строки, дубликаты и — для задач с номерами — номера без кода страны или из другой страны удаляются и не оплачиваются. Баланс резервируется за отправленные строки, а расчёт производится по завершении; разница возвращается.
Ответ: задача создана
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_activity_batch",
"status": "processing",
"country": "US",
"submitted_lines": 509,
"total": 509,
"invalid_cnt": 0,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 0,
"preparing": true,
"created_at": "2026-09-08T09:30:00Z"
}
}2. Проверьте задачу
Опрашивайте по id задачи. После завершения подготовки submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, где total — количество проверяемых и оплачиваемых номеров. Успешный ответ содержит количество успешных и неудачных проверок и ссылку для скачивания файла результата; задача, отклонённая при подготовке, получает статус failed с reason_detail, и средства возвращаются полностью.
Запрос cURL
GET /api/v1/bulk-tasks/{id}curl "https://api.carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Ответ: задача завершена
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_activity_batch",
"status": "success",
"country": "US",
"submitted_lines": 509,
"total": 500,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 6,
"preparing": false,
"success_cnt": 495,
"failure_cnt": 5,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}Что происходит с массовой задачей
Массовая проверка — это не увеличенная проверка в реальном времени, а схема «отправили один раз, выполняется в фоне, забрали позже». Держать страницу открытой не нужно: состояние задачи и результаты сохраняются в вашей панели.
01Загрузите файл
Файл .txt или .csv с одним номером на строку. Он передаётся потоком напрямую, ничего не записывается на диск.
02Предпроверка и резервирование
Очевидные проблемы (пустой файл, неверный формат, слишком мало строк) отклоняются при загрузке. Затем резервируется баланс, и файл подготавливается в фоне: удаляются дубликаты и некорректные строки, а также проверяется правило страны. Файл, не прошедший этот этап, завершается как неудавшаяся задача с полным возвратом средств; в противном случае проверяются только оставшиеся строки, а расчёт по задаче производится по её завершении.
03Выполнение в фоне
Задача выполняется самостоятельно — страницу можно закрыть. О сбое сообщается сразу, и средства возвращаются полностью.
04Скачайте результат
Заберите файл на странице массовой проверки. Вы платите только за номера, по которым действительно получен результат; разница возвращается.
Столбцы файла результата
Для скачивания предоставляется один файл CSV с полной таблицей результатов.
Столбцы файла результата
identifier·12345678900— Отправленный номер в виде цифр с кодом страны, без знака плюс и пробелов (например, 12345678900); используется для записи результата активности обратно в список, запись клиента или лида. Служит только для сопоставления и отслеживания; не содержит времени активности, частоты или сведений о взаимодействиях.activated·true— Решение об активности данного сервиса: true — совпадение, false — явный отрицательный результат. Нет даты, количества или периода активности. Сопоставляйте со своими данными; это не прогноз ответа.
Когда выбирать этот продукт
Сегментация по активности
Записывайте полученный сигнал в теги аудитории и рассматривайте его вместе с данными о недавних входах, покупках или статусе согласия, чтобы сформировать группы, готовые к проверке перед дальнейшими контактами.
Свяжите identifier с исходной записью и сохраните источник для ручной проверки.
Ключ сопоставления: identifier
Реактивация
Перед планированием реактивации используйте сигнал и имеющиеся записи о взаимодействиях, чтобы задать приоритеты проверки; отсутствие сигнала не означает, что человек никогда не ответит.
Разделяйте true, false и отсутствующие результаты; оставляйте последние в очереди проверки.
Поле сегментации: activated
Планирование аудитории
Разделяйте списки по сигналу, региону или этапу жизненного цикла клиента, прежде чем задавать для каждой группы свой контент, частоту и ритм контактов, и продолжайте измерять собственные бизнес-результаты.
Сохраните результат с датой задания, записанной вашей командой. Для обновления отправьте новое задание.
Поля обновления: identifier · activated
Что такое «Проверка активности» в массовом режиме?
Загрузите список одной страны и после завершения скачайте identifier и activated. Сигнал помогает сегментации, но не содержит периода наблюдения, даты последней активности или количества действий. Один отрицательный результат не доказывает неактивность клиента.
Ограничения этого продукта
- Интерпретируйте activated в зависимости от выбранного продукта: валидность/активация или активность. Даты и частота активности не возвращаются.
- Результат не подтверждает личность или согласие и не гарантирует соединение звонка или доставку сообщения.
- Результаты не обновляются автоматически. Для повторной проверки отправьте новую задачу.
О продукте «Проверка активности»
Что означают true, false и отсутствие результата?
True — совпадение в этой проверке, false — явный отрицательный результат. Оба являются полученными решениями; false не означает ошибку выполнения или бесплатную строку. Обрабатывайте отсутствующие, неопределённые и ошибочные результаты отдельно по статистике задания и итоговому расчёту; не заполняйте их значением false.
Показывает ли это активность за последние дни или гарантирует доставку?
Нет. Результаты не содержат периода наблюдения, даты последней активности, частоты или истории взаимодействий и не гарантируют звонок или доставку сообщения. Используйте со своими данными и разрешением на контакт.
Доступна ли эта проверка в реальном времени?
Этот продукт доступен только как асинхронная обработка файла. Проверка оператора в реальном времени не возвращает признаки валидности или активности.
Что происходит с некорректными номерами в файле?
Предпроверка отбрасывает некорректные строки, поэтому они не попадают в оплачиваемое количество. Из оставшихся номеров те, которые вышестоящий сервис не смог определить, тоже не оплачиваются. Вы платите только за номера, по которым действительно получен результат.
Сколько времени занимает задача?
Это зависит от количества номеров и продукта. После отправки страницу можно закрыть: задача выполняется в фоне, а результат будет ждать вас на странице массовой проверки.
Вернутся ли средства, если задача не удалась?
Да. За неудавшуюся задачу средства возвращаются полностью. Если задача выполнена, но по части номеров нет результата, эта часть возвращается автоматически. Разница между зарезервированной и фактически списанной суммой всегда возвращается.
Другие массовые продукты
Глобальное определение оператораЗагрузите целый файл с номерами: оператор, базовый оператор, тип линии, страна, регион и город для каждого — те же поля, что и при определении оператора в реальном времени.Валидация номеровПолучайте сигнал валидности или активации каждого номера через асинхронное файловое задание. Результаты true/false помогают проверять импортированные списки, очищать данные и обновлять CRM.Создайте аккаунт, чтобы отправить массовую задачу
Массовые проверки и проверки в реальном времени расходуют один баланс — ничего дополнительно включать не нужно. Зарегистрируйтесь и загрузите первый файл на странице массовой проверки.