Документация API Hop
Справочник эндпоинтов LinkedIn
13 эндпоинтов LinkedIn Web V2 с авторизацией предоставляют профили участников и компаний, публикации, вакансии, результаты поиска и комментарии.
13 эндпоинтов LinkedIn Web V2 с авторизацией предоставляют профили участников и компаний, публикации, вакансии, результаты поиска и комментарии.
Авторизация
Передавайте ключ API API Hop в заголовке Authorization. Доступ зависит от включённых шлюзов и разрешений ключа; документация не подтверждает доступность в рабочей среде.
Запросы
Синхронные операции используют GET с параметрами запроса без тела. Неизвестные поля и повторяющиеся скалярные поля отклоняются. Повторять ключи можно только для полей-массивов, например company_ids=1035&company_ids=1441. Сохраняйте ID и курсоры как строки; не преобразуйте большие ID в числа JavaScript. Необязательные пустые значения пропускаются.
Оплата
Для синхронных операций: Профили участников, профили компаний и сведения о публикациях стоят $0.008 (8000 credits) за успешный запрос. Остальные пять операций стоят $0.05 (50000 credits). Это стандартные цены для клиентов; индивидуальные тарифы аккаунта имеют приоритет. Каждая запрошенная страница оплачивается отдельно, а не каждый элемент. При сбое поставщика резерв освобождается; ошибка расчёта не вызывает повторный запрос.
Пагинация и ограничения
Для синхронных операций: Публикации участника ограничены последними 50 записями: start и pagination_token не действуют, даже если ответ содержит токен. Публикации компаний используют start=0, 50, 100, ...; pagination_token не действует. Поиск вакансий использует start=0, 25, 50, .... Комментарии поддерживают page начиная с 1 и pagination_token. Автоматической пагинации и повторов нет; тайм-аут составляет 60 секунд. Нехватка ресурсов поставщика может вызывать временные ошибки.
Охват
Доступны восемь синхронных операций Web V2 и пять операций асинхронных задач. Создавайте задачи профиля, компании или публикации через POST с полем url в JSON. HTTP 202 возвращает десятичный ID задачи платформы в виде строки. GET-запросы статуса и результата бесплатны и доступны только тому же арендатору; неизвестные, чужие задачи и задачи другого продукта возвращают 404. Статус не содержит result; до COMPLETED результат равен null. Цена резервируется при создании и списывается один раз при успехе (по умолчанию $0.008 / 8000 credits). Ошибка или тайм-аут 30 минут освобождает резерв. Фоновый опрос выполняется каждые 5 секунд; незавершённые ответы содержат Retry-After: 5. Результаты хранятся в задаче платформы. Не используйте ID поставщика. Отправка с неопределённым результатом автоматически не повторяется. Завершённая задача возвращает result.records. Целые числа вне безопасного диапазона JavaScript хранятся и возвращаются как десятичные строки. Примеры иллюстративные, не результаты реальной проверки.
Профиль участника
web_v2-get_user_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/users/profile
Цена успешного запроса: $0.008 (8000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
url | Да | Полный URL LinkedIn; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/profile" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/in/williamhgates/"Публикации участника
web_v2-get_user_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts
Цена успешного запроса: $0.05 (50000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
url | Да | Полный URL LinkedIn; string |
type | Нет | Свои, прокомментированные публикации или публикации с реакцией; string; posts, comments, reactions; По умолчанию: posts |
start | Нет | Смещение; действуют ограничения эндпоинта; integer; >= 0 |
pagination_token | Нет | Токен пагинации; действуют ограничения эндпоинта; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/users/posts" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/in/williamhgates/"Профиль компании
web_v2-get_company_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile
Цена успешного запроса: $0.008 (8000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
url | Да | Полный URL LinkedIn; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/company/microsoft/"Публикации компании
web_v2-get_company_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts
Цена успешного запроса: $0.05 (50000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
url | Да | Полный URL LinkedIn; string |
start | Нет | Смещение; действуют ограничения эндпоинта; integer; >= 0 |
pagination_token | Нет | Токен пагинации; действуют ограничения эндпоинта; string |
sort_by | Нет | Порядок сортировки; string; top, recent |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/companies/posts" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/company/microsoft/"Сведения о вакансии
web_v2-get_job_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail
Цена успешного запроса: $0.05 (50000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
url | Да | Полный URL LinkedIn; string |
include_skills | Нет | Включить требуемые навыки; boolean; По умолчанию: false |
include_hiring_team | Нет | Включить команду найма; boolean; По умолчанию: false |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/jobs/view/software-engineer-at-pave-4310512612/"Поиск вакансий
web_v2-search_jobs
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search
Цена успешного запроса: $0.05 (50000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
keywords | Нет | Ключевые слова; string |
geo_code | Нет | Географический ID; 92000000 означает весь мир; integer; Точный целочисленный ID |
date_posted | Нет | Фильтр по дате публикации; string; Any time, Past month, Past week, Past 24 hours |
experience_levels | Нет | Уровни опыта; string[]; Повторяющийся ключ запроса; Internship, Entry level, Associate, Mid-Senior level, Director, Executive |
company_ids | Нет | ID компаний; integer[]; Повторяющийся ключ запроса; Точный целочисленный ID |
title_ids | Нет | ID названий должностей; integer[]; Повторяющийся ключ запроса; Точный целочисленный ID |
onsite_remotes | Нет | Типы места работы; string[]; Повторяющийся ключ запроса; On-site, Remote, Hybrid |
functions | Нет | Рабочие функции; string[]; Повторяющийся ключ запроса |
industries | Нет | Отрасли; string[]; Повторяющийся ключ запроса |
job_types | Нет | Типы занятости; string[]; Повторяющийся ключ запроса; Full-time, Part-time, Contract, Temporary, Internship, Volunteer |
sort_by | Нет | Порядок сортировки; string; Most relevant, Most recent |
easy_apply | Нет | Только простой отклик; boolean; По умолчанию: false |
under_10_applicants | Нет | Только менее 10 кандидатов; boolean; По умолчанию: false |
start | Нет | Смещение; действуют ограничения эндпоинта; integer; >= 0 |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/jobs/search" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "keywords=data analyst" \
--data-urlencode "company_ids=1035" \
--data-urlencode "company_ids=1441"Сведения о публикации
web_v2-get_post_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail
Цена успешного запроса: $0.008 (8000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
url | Да | Полный URL LinkedIn; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "url=https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"Комментарии к публикации
web_v2-get_post_comments
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments
Цена успешного запроса: $0.05 (50000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
urn | Да | URN активности публикации; string |
sort_by | Нет | Порядок сортировки; string; Most relevant, Most recent |
page | Нет | Номер страницы начиная с 1; integer; >= 1 |
pagination_token | Нет | Токен пагинации; действуют ограничения эндпоинта; string |
share_urn | Нет | URN репоста для пересланных публикаций; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "urn=7267273010393358336"Создать задачу профиля участника
web_v2-create_user_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks
Цена успешного запроса: $0.008 (8000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
url | Да | Полный URL LinkedIn; string |
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/in/williamhgates/"}'HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}Создать задачу профиля компании
web_v2-create_company_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks
Цена успешного запроса: $0.008 (8000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
url | Да | Полный URL LinkedIn; string |
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/company/microsoft/"}'HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}Создать задачу сведений о публикации
web_v2-create_post_detail_task
POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks
Цена успешного запроса: $0.008 (8000 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
url | Да | Полный URL LinkedIn; string |
curl -X POST "https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN"}'HTTP/1.1 202 Accepted
Location: /v1/linkedin/web-v2/tasks/3850699893338385742
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}Статус задачи
web_v2-get_task_status
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id
Цена успешного запроса: $0 (0 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
task_id | Да | ID задачи платформы в пути URL; десятичная строка, не ID поставщика; string; Точный целочисленный ID |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080" \
-H "Authorization: Bearer YOUR_API_KEY"HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING"},"requestId":"example-request"}Результат задачи
web_v2-get_task_result
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result
Цена успешного запроса: $0 (0 credits).
| Поле | Обязательно | Контракт |
|---|---|---|
task_id | Да | ID задачи платформы в пути URL; десятичная строка, не ID поставщика; string; Точный целочисленный ID |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080/result" \
-H "Authorization: Bearer YOUR_API_KEY"HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json
{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}{"success":true,"data":{"id":"3850699893338385742","status":"COMPLETED","result":{"records":[]}},"requestId":"example-request"}Ответы
Для синхронных операций: Исходная структура JSON code/data и точность чисел сохраняются. Структура ответа зависит от операции. HTTP 200 недостаточно: прикладные ошибки и записи об ошибках с error/error_code отклоняются. Успешные пустые результаты оплачиваются. Пример иллюстративный и не является результатом реальной проверки.
{"code":200,"data":[]}Ошибки
HTTP 400: неверные параметры; 401: неверная авторизация; 402: недостаточный баланс; 403: доступ к шлюзу запрещён; 405: метод не поддерживается; 408: отмена; 429: ограничение частоты; 502/503/504: сбой поставщика, недоступная конфигурация или тайм-аут. Сохраняйте X-Request-Id для диагностики.
Источники
Проверено 2026-10-31 по официальной OpenAPI V5.3.2 и текущим ценам эндпоинтов. Источники описывают контракт и цены, но не подтверждают успешные реальные вызовы всех эндпоинтов.