API Hop

Documentación

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).

CampoObligatorioContrato
urlSíURL completa de LinkedIn; string
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/"

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).

CampoObligatorioContrato
urlSíURL completa de LinkedIn; string
typeNoPublicaciones propias, comentadas o con reacciones; string; posts, comments, reactions; Valor predeterminado: posts
startNoDesplazamiento; se aplican los límites del endpoint; integer; >= 0
pagination_tokenNoToken de paginación; se aplican los límites del endpoint; string
bash
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).

CampoObligatorioContrato
urlSíURL completa de LinkedIn; string
bash
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).

CampoObligatorioContrato
urlSíURL completa de LinkedIn; string
startNoDesplazamiento; se aplican los límites del endpoint; integer; >= 0
pagination_tokenNoToken de paginación; se aplican los límites del endpoint; string
sort_byNoOrden de clasificación; string; top, recent
bash
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).

CampoObligatorioContrato
urlSíURL completa de LinkedIn; string
include_skillsNoIncluir aptitudes requeridas; boolean; Valor predeterminado: false
include_hiring_teamNoIncluir equipo de contratación; boolean; Valor predeterminado: false
bash
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

Precio por solicitud correcta: $0.05 (50000 credits).

CampoObligatorioContrato
keywordsNoPalabras clave; string
geo_codeNoIdentificador geográfico; 92000000 indica todo el mundo; integer; Identificador entero exacto
date_postedNoFiltro de fecha de publicación; string; Any time, Past month, Past week, Past 24 hours
experience_levelsNoNiveles de experiencia; string[]; Clave de consulta repetida; Internship, Entry level, Associate, Mid-Senior level, Director, Executive
company_idsNoIdentificadores de empresas; integer[]; Clave de consulta repetida; Identificador entero exacto
title_idsNoIdentificadores de cargos; integer[]; Clave de consulta repetida; Identificador entero exacto
onsite_remotesNoTipos de lugar de trabajo; string[]; Clave de consulta repetida; On-site, Remote, Hybrid
functionsNoFunciones laborales; string[]; Clave de consulta repetida
industriesNoSectores; string[]; Clave de consulta repetida
job_typesNoTipos de empleo; string[]; Clave de consulta repetida; Full-time, Part-time, Contract, Temporary, Internship, Volunteer
sort_byNoOrden de clasificación; string; Most relevant, Most recent
easy_applyNoSolo solicitud sencilla; boolean; Valor predeterminado: false
under_10_applicantsNoSolo menos de 10 candidatos; boolean; Valor predeterminado: false
startNoDesplazamiento; se aplican los límites del endpoint; integer; >= 0
bash
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).

CampoObligatorioContrato
urlSíURL completa de LinkedIn; string
bash
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).

CampoObligatorioContrato
urnSíURN de actividad de la publicación; string
sort_byNoOrden de clasificación; string; Most relevant, Most recent
pageNoNúmero de página desde 1; integer; >= 1
pagination_tokenNoToken de paginación; se aplican los límites del endpoint; string
share_urnNoURN de publicación compartida; string
bash
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).

CampoObligatorioContrato
urlSíURL completa de LinkedIn; string
bash
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
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).

CampoObligatorioContrato
urlSíURL completa de LinkedIn; string
bash
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
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).

CampoObligatorioContrato
urlSíURL completa de LinkedIn; string
bash
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
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).

CampoObligatorioContrato
task_idSíID de tarea de la plataforma en la ruta URL; cadena decimal, no ID del proveedor; string; Identificador entero exacto
bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080" \
  -H "Authorization: Bearer YOUR_API_KEY"
http
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).

CampoObligatorioContrato
task_idSíID de tarea de la plataforma en la ruta URL; cadena decimal, no ID del proveedor; string; Identificador entero exacto
bash
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/tasks/397282151069614080/result" \
  -H "Authorization: Bearer YOUR_API_KEY"
http
HTTP/1.1 200 OK
Retry-After: 5
Content-Type: application/json

{"success":true,"data":{"id":"3850699893338385742","status":"PROCESSING","result":null},"requestId":"example-request"}
json
{"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.

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