API профиля LinkedIn по имени пользователя: пакетно

Проверяйте публичные профили LinkedIn по имени пользователя или ссылке на профиль и получайте фото, имя, заголовок, местоположение, страну, компанию, число подписчиков, описание, языки, образование и опыт работы. Несуществующие и закрытые профили возвращаются как неактивированные. Задача использует стандартный асинхронный пакетный процесс.

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

Загрузите текстовый файл с одним именем пользователя LinkedIn в строке. Принимаются slug профиля, @slug и полная ссылка linkedin.com/in/<slug>; сопоставление без учёта регистра.

williamhgates
@satyanadella
https://www.linkedin.com/in/john-smith-1a2b3c4/

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

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

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

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

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

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

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

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

curl --location 'https://api.checknumber.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": "2.000000",
    "currency": "USD"
  }
}

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

Поле	Описание	Пример
username	Имя пользователя или ссылка на профиль в том виде, как отправлено.	williamhgates
activated	Найден ли публичный профиль (no также означает закрытый или несуществующий профиль).	yes
avatar	Есть ли у профиля настоящее фото (yes/no).	yes
avatar_url	Ссылка на фото профиля (не истекает).	https://media.licdn.com/dms/image/…
name	Полное имя.	Bill Gates
headline	Заголовок профиля.	Chair, Gates Foundation
location	Местоположение, как показано в профиле.	Seattle, Washington, United States
country	ISO-код страны, выведенный из местоположения.	US
company	Текущая компания.	Gates Foundation
followers	Число подписчиков.	40653538
about	Текст раздела «О себе».	Chair of the Gates Foundation. …
badges	Метки верификации, например Creator, Top Voice.	Creator, Top Voice
languages	Языки через ;.	English;German
current_title	Текущая должность, если владелец её не скрыл.	Co-chair
education	JSON-список {organization,start,end}.	[{“organization”:“Harvard University”,“start”:1973,“end”:1975}]
experience	JSON-список {organization,start,end}.	[{“organization”:“Gates Foundation”,“start”:2000}]
masked	Поля, скрытые настройками видимости, через ;.	jobTitle;worksFor

Обработка файла результата

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

Поля ответа

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

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

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

Рабочие примечания

• Задача выполняется асинхронно; используйте ID задачи для проверки статуса.
• Перед загрузкой проверьте ограничения продукта на входные данные.
• Ошибочные строки указаны в экспортированном результате и отражены в счётчиках задачи.
• Поля выше основаны на текущем live sample и могут измениться при изменении схемы экспорта.