Documentación de API Hop
Referencia de endpoints de LinkedIn
13 endpoints autenticados de LinkedIn Web V2 ofrecen perfiles personales y empresariales, publicaciones, ofertas de empleo, búsquedas y comentarios.
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.
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.
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.
Perfil personal
web_v2-get_user_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/users/profile
Precio por solicitud correcta: $0.008 (8000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
url | Sí | URL completa de 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/"Publicaciones personales
web_v2-get_user_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts
Precio por solicitud correcta: $0.05 (50000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
url | Sí | URL completa de LinkedIn; string |
type | No | Publicaciones propias, comentadas o con reacciones; string; posts, comments, reactions; Valor predeterminado: posts |
start | No | Desplazamiento; se aplican los límites del endpoint; integer; >= 0 |
pagination_token | No | Token de paginación; se aplican los límites del endpoint; 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/"Perfil de empresa
web_v2-get_company_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile
Precio por solicitud correcta: $0.008 (8000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
url | Sí | URL completa de 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/"Publicaciones de empresa
web_v2-get_company_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts
Precio por solicitud correcta: $0.05 (50000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
url | Sí | URL completa de LinkedIn; string |
start | No | Desplazamiento; se aplican los límites del endpoint; integer; >= 0 |
pagination_token | No | Token de paginación; se aplican los límites del endpoint; string |
sort_by | No | Orden de clasificación; 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/"Detalles de la oferta
web_v2-get_job_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail
Precio por solicitud correcta: $0.05 (50000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
url | Sí | URL completa de LinkedIn; string |
include_skills | No | Incluir aptitudes requeridas; boolean; Valor predeterminado: false |
include_hiring_team | No | Incluir equipo de contratación; boolean; Valor predeterminado: 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/"Búsqueda de empleo
web_v2-search_jobs
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search
Precio por solicitud correcta: $0.05 (50000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
keywords | No | Palabras clave; string |
geo_code | No | Identificador geográfico; 92000000 indica todo el mundo; integer; Identificador entero exacto |
date_posted | No | Filtro de fecha de publicación; string; Any time, Past month, Past week, Past 24 hours |
experience_levels | No | Niveles de experiencia; string[]; Clave de consulta repetida; Internship, Entry level, Associate, Mid-Senior level, Director, Executive |
company_ids | No | Identificadores de empresas; integer[]; Clave de consulta repetida; Identificador entero exacto |
title_ids | No | Identificadores de cargos; integer[]; Clave de consulta repetida; Identificador entero exacto |
onsite_remotes | No | Tipos de lugar de trabajo; string[]; Clave de consulta repetida; On-site, Remote, Hybrid |
functions | No | Funciones laborales; string[]; Clave de consulta repetida |
industries | No | Sectores; string[]; Clave de consulta repetida |
job_types | No | Tipos de empleo; string[]; Clave de consulta repetida; Full-time, Part-time, Contract, Temporary, Internship, Volunteer |
sort_by | No | Orden de clasificación; string; Most relevant, Most recent |
easy_apply | No | Solo solicitud sencilla; boolean; Valor predeterminado: false |
under_10_applicants | No | Solo menos de 10 candidatos; boolean; Valor predeterminado: false |
start | No | Desplazamiento; se aplican los límites del endpoint; 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"Detalles de la publicación
web_v2-get_post_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail
Precio por solicitud correcta: $0.008 (8000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
url | Sí | URL completa de 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"Comentarios de la publicación
web_v2-get_post_comments
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments
Precio por solicitud correcta: $0.05 (50000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
urn | Sí | URN de actividad de la publicación; string |
sort_by | No | Orden de clasificación; string; Most relevant, Most recent |
page | No | Número de página desde 1; integer; >= 1 |
pagination_token | No | Token de paginación; se aplican los límites del endpoint; string |
share_urn | No | URN de publicación compartida; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "urn=7267273010393358336"Crear tarea de perfil personal
web_v2-create_user_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks
Precio por solicitud correcta: $0.008 (8000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
url | Sí | URL completa de 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"}Crear tarea de perfil empresarial
web_v2-create_company_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks
Precio por solicitud correcta: $0.008 (8000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
url | Sí | URL completa de 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"}Crear tarea de detalles de publicación
web_v2-create_post_detail_task
POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks
Precio por solicitud correcta: $0.008 (8000 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
url | Sí | URL completa de 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"}Estado de la tarea
web_v2-get_task_status
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id
Precio por solicitud correcta: $0 (0 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
task_id | Sí | ID de tarea de la plataforma en la ruta URL; cadena decimal, no ID del proveedor; string; Identificador entero exacto |
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"}Resultado de la tarea
web_v2-get_task_result
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result
Precio por solicitud correcta: $0 (0 credits).
| Campo | Obligatorio | Contrato |
|---|---|---|
task_id | Sí | ID de tarea de la plataforma en la ruta URL; cadena decimal, no ID del proveedor; string; Identificador entero exacto |
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"}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.
{"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.