API de datos de LinkedIn | Documentación de 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 endpoints autenticados de LinkedIn Web V2 ofrecen perfiles personales y empresariales, publicaciones, ofertas de empleo, búsquedas y comentarios.

Autenticación

Envía tu clave API de API Hop en la cabecera Authorization. El acceso depende de las pasarelas habilitadas y los permisos de la clave; la documentación no confirma disponibilidad en producción.

http

Authorization: Bearer YOUR_API_KEY

Solicitudes

Las operaciones síncronas usan GET con parámetros de consulta y sin cuerpo. Se rechazan los campos desconocidos y los escalares repetidos. Solo los campos de tipo matriz permiten claves repetidas, como company_ids=1035&company_ids=1441. Conserva identificadores y cursores como cadenas; no conviertas identificadores grandes en números JavaScript. Se omiten los valores opcionales vacíos.

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

Facturación

Para operaciones síncronas: Los perfiles personales, perfiles de empresa y detalles de publicaciones cuestan $0.008 (8000 credits) por solicitud correcta. Las otras cinco operaciones cuestan $0.05 (50000 credits). Son precios predeterminados para clientes; prevalecen las tarifas de cada cuenta. Cada página solicitada se factura por separado, no cada elemento. Los fallos del proveedor liberan la reserva; un error de liquidación no provoca otra llamada.

Paginación y límites

Para operaciones síncronas: Las publicaciones personales solo devuelven las 50 más recientes: start y pagination_token no tienen efecto, aunque la respuesta incluya un token. Las publicaciones de empresa usan start=0, 50, 100, ...; pagination_token no tiene efecto. La búsqueda de empleo usa start=0, 25, 50, .... Los comentarios aceptan page desde 1 y pagination_token. No hay paginación ni reintentos automáticos; el tiempo máximo es de 60 segundos. La escasez de recursos del proveedor puede causar fallos intermitentes.

Alcance

Hay ocho operaciones síncronas Web V2 y cinco operaciones de tareas asíncronas. Crea tareas de perfil, empresa o publicación con POST y un campo JSON url. HTTP 202 devuelve un ID decimal de tarea de la plataforma como cadena. Las lecturas GET de estado y resultado son gratuitas y exclusivas del mismo inquilino; tareas desconocidas, ajenas o de otro producto devuelven 404. El estado omite result; el resultado es null antes de COMPLETED. El precio se reserva al crear y se cobra una sola vez al completar ($0.008 / 8000 credits por defecto). Un fallo o un tiempo de espera de 30 minutos libera la reserva. El seguimiento en segundo plano ocurre cada 5 segundos; las respuestas pendientes incluyen Retry-After: 5. Los resultados se guardan en la tarea de la plataforma. No uses el ID del proveedor. Una solicitud de creación incierta no se repite automáticamente. Una tarea completada devuelve result.records. Los enteros fuera del rango seguro de JavaScript se guardan y devuelven como cadenas decimales. Los ejemplos son ilustrativos, no resultados de validación real.

Referencia completa

Respuestas

Para operaciones síncronas: Se conservan la estructura JSON nativa code/data y la precisión numérica. La estructura varía según la operación. HTTP 200 no basta: se rechazan los errores de negocio y los registros de error con error/error_code. Los resultados vacíos correctos se cobran. El ejemplo es ilustrativo, no una validación real.

json

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

Errores

HTTP 400: parámetros inválidos; 401: autenticación inválida; 402: saldo insuficiente; 403: acceso a la pasarela denegado; 405: método no admitido; 408: cancelación; 429: límite de frecuencia; 502/503/504: fallo del proveedor, configuración no disponible o tiempo agotado. Conserva X-Request-Id para el diagnóstico.

Fuentes

Comprobado el 2026-10-31 con la OpenAPI oficial V5.3.2 y los precios actuales. Estas fuentes describen el contrato y las tarifas, pero no acreditan pruebas reales satisfactorias de todos los endpoints.

TikHub · OpenAPI · Precios