Instagram API массовой проверки номеров: быстрая проверка

Проверьте, привязан ли указанный международный номер телефона к учетной записи Instagram.

Пример загрузки файла:

curl --location 'https://api.checknumber.ai/ins/api/simple/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"input.txt"'

Пример проверки статуса задачи:

curl --location 'https://api.checknumber.ai/ins/api/simple/tasks/cs9viu7i61pkfs4oavvg' \
--header 'X-API-Key: API-KEY'

Ответ при успешной загрузке файла:

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Ответ для статуса обработки:

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Ответ при завершении задачи (включает URL скачивания результата):

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

URL запроса загрузки файла

POST https://api.checknumber.ai/ins/api/simple/tasks

Параметры запроса загрузки файла

Параметр	Описание
user_id	string, идентификатор пользователя
file	file, Загрузите файл; каждая строка должна содержать номер в формате E.164

URL запроса проверки статуса

GET https://api.checknumber.ai/ins/api/simple/tasks/{TASK_ID}

Параметры запроса проверки статуса

Параметр	Описание
user_id	string, идентификатор пользователя

Поля результата

Поле	Описание	Пример
Number	Номер телефона в формате E.164	+41798284651
instagram	Есть ли у номера активная учетная запись Instagram	yes, no

Формат ответа

Поле	Описание
created_at	Временная метка создания задачи
updated_at	Временная метка последнего обновления статуса задачи
task_id	Уникальный идентификатор задачи
user_id	ID пользователя
status	Статус задачи: pending: в очереди processing: обрабатывается completed: обработка завершена exported: результаты доступны для скачивания
total	Всего обработано номеров телефонов
success	Номера успешно определены
failure	Номера, которые не удалось обработать
result_url	(Необязательно) URL для скачивания результатов при статусе exported

Коды статуса

Статус	Описание
200	charge, запрос успешно выполнен, задача создана или получен ее статус
400	free, неправильный запрос, недопустимые параметры или формат файла
500	free, внутренняя ошибка сервера, повторите попытку позже