API профиля Instagram по ID/имени: массовая проверка

Проверяйте аккаунты Instagram по имени пользователя (ID) или ссылке на профиль и получайте полное изображение последней публикации с лицом, размещённое без обрезки, полное имя, число публикаций, подписчиков и подписок, а также признаки приватности и верификации. Несуществующие аккаунты возвращаются как неактивные; приватные — как активные с данными профиля, но без фото. Задача использует стандартный асинхронный пакетный процесс.

Формат входных данных

Загрузите текстовый файл с одним именем пользователя (ID) Instagram в строке. Принимаются username, @username и полные ссылки instagram.com/<username>; регистр не учитывается.

Числовые ID Instagram (pk) также принимаются и преобразуются в имя пользователя.

cristiano
@zuck
https://www.instagram.com/natgeo/
1367088262

Создание задачи

POST https://api.numberchecker.ai/v1/tasks

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="instagram_profile"'

API возвращает ID задачи. Сохраните его для опроса статуса.

Ответ при загрузке

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "1.100000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

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

POST https://api.numberchecker.ai/v1/gettasks

curl --location 'https://api.numberchecker.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Опрашивайте, пока status не станет exported. Не считайте pending или processing завершённым результатом.

Ответ в обработке

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Ответ после экспорта

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "1.100000",
    "currency": "USD"
  }
}

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

Поле	Описание	Пример
username	Отправленное имя пользователя или ссылка, без изменений.	cristiano
activated	Получено ли изображение аватара для этого ID (yes/no). Существующие аккаунты без пригодного изображения (приватные, без публикаций, без лица, слишком маленькое изображение) и несуществующие ID — no. Оплачиваются только строки yes.	yes
avatar	Публичная ссылка на последнюю публикацию с лицом, размещённую без обрезки на ins.waavatar.xyz (бессрочно). Выдаются только изображения больше 500 px по стороне; фото профиля не используются. Пусто, если такого изображения нет (приватный аккаунт, нет публикаций, нет лица).	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
visibility	Приватный ли аккаунт Instagram: private или public; пусто для несуществующих аккаунтов.	public
ig_username	Определённое имя пользователя Instagram (заполняется и когда отправлен числовой ID); пусто для несуществующих аккаунтов.	villavicenciopaul
full_name	Имя, показанное в профиле.	Cristiano Ronaldo
posts	Число публикаций.	4138
followers	Число подписчиков.	679725371
following	Число подписок.	636
verified	Есть ли значок верификации (yes/no).	yes

Работа с файлом результата

Скачивайте файл по result_url только после экспорта. Сохраняйте имена столбцов при дальнейшей обработке.

Поля ответа

Поле	Описание
created_at	Время создания задачи.
updated_at	Время последнего обновления статуса.
task_id	Уникальный идентификатор задачи.
status	pending, processing, exported или failed.
total	Всего обработано значений.
success	Успешно обработано.
failure	Обработано с ошибкой.
result_url	Ссылка для скачивания после экспорта.
actual_amount	Итоговая списанная сумма, если доступна.
estimated_amount	Оценочная сумма при создании задачи.

Коды состояния

Статус	Описание
200	Запрос выполнен.
202	Задача создана, оценочная сумма списана.
400	Неверный файл, неподдерживаемый тип задачи или слишком мало корректных строк.
401	Отсутствует или неверный ключ API.
402	Недостаточно средств.
403	Продукт недоступен для вашего аккаунта (снят или только по белому списку); обратитесь в поддержку.
404	Задача не найдена.
413	Загруженный файл слишком большой.
500	Внутренняя ошибка сервера; повторите позже.
503	Продукт временно недоступен (пауза на обслуживание); средства не списываются, повторите позже.

Примечания

• Задача асинхронная; используйте ID для опроса статуса.
• Перед загрузкой проверьте лимиты входных данных продукта.
• Строки с ошибками отражаются в экспортированном результате и счётчиках.
• Выдаётся полное изображение публикации (без обрезки) в разрешении, которое Instagram отдаёт без входа (640 px по длинной стороне); только если обнаруженная область лица больше 250 px.
• Поля основаны на текущей выборке и могут измениться при изменении схемы экспорта.