API данных LinkedIn | Документация API

# LinkedIn Data API

Read member and company profiles, posts, job details, job search results, and comments through 13 authenticated LinkedIn Web V2 endpoints.

## Authentication

Send your API Hop API key in the Authorization header. Access depends on enabled gateways and your key permissions; documentation does not confirm production availability.

```http
Authorization: Bearer YOUR_API_KEY
```

## Requests

Synchronous operations use GET query parameters without a body. Unknown fields and duplicate scalar fields are rejected. Only fields marked as arrays accept repeated keys, for example company_ids=1035&company_ids=1441. Preserve IDs and cursors as strings; do not convert large identifiers to JavaScript numbers. Optional empty values are omitted.

```bash
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/"
```

## Billing

For synchronous operations: Member profiles, company profiles, and post details cost $0.008 (8000 credits) per successful request. The other five operations cost $0.05 (50000 credits). These are default customer prices; account-specific prices take precedence. Every requested page is billed separately, not per item. Upstream failures release the reservation. Settlement failures do not trigger another upstream call.

## Pagination and limits

For synchronous operations: Member posts return only the latest 50 items: start and pagination_token have no effect, even when the response contains a token. Company posts use start=0, 50, 100, ...; pagination_token has no effect. Job search uses start=0, 25, 50, .... Comments support page (starting at 1) and pagination_token. There is no automatic pagination. Requests time out after 60 seconds with no automatic retries. The supplier warns that resource constraints can cause intermittent failures.

## Scope

Eight synchronous Web V2 operations and five asynchronous task operations are available. Create profile, company, or post tasks with POST and a JSON url field. Creation returns HTTP 202 and a decimal platform task ID as a string. GET status and result reads require the same tenant and are free; unknown, foreign-tenant, and other-product tasks return 404. Status omits result; result is null before COMPLETED. Each task reserves its price at creation and charges once on success ($0.008 / 8000 credits by default). Failure or a 30-minute timeout releases the reservation. Background polling runs every 5 seconds; pending responses include Retry-After: 5. Results are stored in the platform job. Use the platform ID, never a supplier task ID. An uncertain submission is not automatically repeated. A completed task returns result.records. Integers beyond the JavaScript safe range are stored and returned as decimal strings. Examples are illustrative, not live acceptance results.

[Complete reference](https://apihop.ai/en/docs/api-reference/linkedin/reference)

## Responses

For synchronous operations: The native JSON code/data envelope and numeric precision are preserved. Response shapes vary by operation. HTTP 200 alone is not success: business errors, including error/error_code records, are rejected. A successful empty result is billable. This is an illustrative response, not a live acceptance result.

```json
{"code":200,"data":[]}
```

## Errors

HTTP 400: invalid parameters; 401: invalid authentication; 402: insufficient credit; 403: denied gateway access; 405: unsupported method; 408: cancellation; 429: rate limit; 502/503/504: supplier failure, unavailable configuration, or timeout. Keep X-Request-Id for troubleshooting.

## Sources

Checked on 2026-10-31 against the official OpenAPI V5.3.2 and current endpoint prices. These sources describe the contract and prices, not successful live verification of every endpoint.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

13 эндпоинтов LinkedIn Web V2 с авторизацией предоставляют профили участников и компаний, публикации, вакансии, результаты поиска и комментарии.

Авторизация

Передавайте ключ API API Hop в заголовке Authorization. Доступ зависит от включённых шлюзов и разрешений ключа; документация не подтверждает доступность в рабочей среде.

http

Authorization: Bearer YOUR_API_KEY

Запросы

Синхронные операции используют GET с параметрами запроса без тела. Неизвестные поля и повторяющиеся скалярные поля отклоняются. Повторять ключи можно только для полей-массивов, например company_ids=1035&company_ids=1441. Сохраняйте ID и курсоры как строки; не преобразуйте большие ID в числа JavaScript. Необязательные пустые значения пропускаются.

bash

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/"

Оплата

Для синхронных операций: Профили участников, профили компаний и сведения о публикациях стоят $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 хранятся и возвращаются как десятичные строки. Примеры иллюстративные, не результаты реальной проверки.

Полный справочник

Ответы

Для синхронных операций: Исходная структура JSON code/data и точность чисел сохраняются. Структура ответа зависит от операции. HTTP 200 недостаточно: прикладные ошибки и записи об ошибках с error/error_code отклоняются. Успешные пустые результаты оплачиваются. Пример иллюстративный и не является результатом реальной проверки.

json

{"code":200,"data":[]}

Ошибки

HTTP 400: неверные параметры; 401: неверная авторизация; 402: недостаточный баланс; 403: доступ к шлюзу запрещён; 405: метод не поддерживается; 408: отмена; 429: ограничение частоты; 502/503/504: сбой поставщика, недоступная конфигурация или тайм-аут. Сохраняйте X-Request-Id для диагностики.

Источники

Проверено 2026-10-31 по официальной OpenAPI V5.3.2 и текущим ценам эндпоинтов. Источники описывают контракт и цены, но не подтверждают успешные реальные вызовы всех эндпоинтов.

TikHub · OpenAPI · Цены