Documentação do API Hop
Referência de endpoints do LinkedIn
13 endpoints autenticados do LinkedIn Web V2 oferecem perfis pessoais e empresariais, publicações, vagas, pesquisas e comentários.
13 endpoints autenticados do LinkedIn Web V2 oferecem perfis pessoais e empresariais, publicações, vagas, pesquisas e comentários.
Autenticação
Envie sua chave API API Hop no cabeçalho Authorization. O acesso depende dos gateways habilitados e das permissões da chave; a documentação não confirma disponibilidade em produção.
Requisições
As operações síncronas usam GET com parâmetros de consulta e sem corpo. Campos desconhecidos e campos escalares repetidos são rejeitados. Apenas campos de array aceitam chaves repetidas, como company_ids=1035&company_ids=1441. Mantenha identificadores e cursores como strings; não converta identificadores grandes em números JavaScript. Valores opcionais vazios são omitidos.
Cobrança
Para operações síncronas: Perfis pessoais, perfis empresariais e detalhes de publicações custam $0.008 (8000 credits) por requisição bem-sucedida. As outras cinco operações custam $0.05 (50000 credits). São preços padrão para clientes; preços específicos da conta têm prioridade. Cada página solicitada é cobrada separadamente, não cada item. Falhas do fornecedor liberam a reserva; erros de liquidação não geram outra chamada.
Paginação e limites
Para operações síncronas: Publicações pessoais retornam apenas as 50 mais recentes: start e pagination_token não têm efeito, mesmo que a resposta contenha um token. Publicações empresariais usam start=0, 50, 100, ...; pagination_token não tem efeito. A busca de vagas usa start=0, 25, 50, .... Comentários aceitam page a partir de 1 e pagination_token. Não há paginação nem tentativas automáticas; o tempo limite é de 60 segundos. Recursos limitados do fornecedor podem causar falhas intermitentes.
Escopo
Há oito operações síncronas Web V2 e cinco operações de tarefas assíncronas. Crie tarefas de perfil, empresa ou publicação com POST e um campo JSON url. HTTP 202 retorna um ID decimal de tarefa da plataforma como string. Leituras GET de status e resultado são gratuitas e restritas ao mesmo locatário; tarefas desconhecidas, de outro locatário ou produto retornam 404. O status não inclui result; o resultado é null antes de COMPLETED. O preço é reservado na criação e cobrado uma vez no sucesso ($0.008 / 8000 credits por padrão). Falha ou tempo limite de 30 minutos libera a reserva. A consulta em segundo plano ocorre a cada 5 segundos; respostas pendentes incluem Retry-After: 5. Os resultados ficam na tarefa da plataforma. Não use o ID do fornecedor. Um envio incerto não é repetido automaticamente. Uma tarefa concluída retorna result.records. Inteiros fora do intervalo seguro do JavaScript são armazenados e retornados como strings decimais. Os exemplos são ilustrativos, não resultados de validação real.
Perfil pessoal
web_v2-get_user_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/users/profile
Preço por requisição bem-sucedida: $0.008 (8000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
url | Sim | URL completo do 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/"Publicações pessoais
web_v2-get_user_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/users/posts
Preço por requisição bem-sucedida: $0.05 (50000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
url | Sim | URL completo do LinkedIn; string |
type | Não | Publicações próprias, comentadas ou com reações; string; posts, comments, reactions; Valor padrão: posts |
start | Não | Deslocamento; aplicam-se os limites do endpoint; integer; >= 0 |
pagination_token | Não | Token de paginação; aplicam-se os limites do 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 empresarial
web_v2-get_company_profile
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/profile
Preço por requisição bem-sucedida: $0.008 (8000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
url | Sim | URL completo do 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/"Publicações empresariais
web_v2-get_company_posts
GET https://api.apihop.ai/v1/linkedin/web-v2/companies/posts
Preço por requisição bem-sucedida: $0.05 (50000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
url | Sim | URL completo do LinkedIn; string |
start | Não | Deslocamento; aplicam-se os limites do endpoint; integer; >= 0 |
pagination_token | Não | Token de paginação; aplicam-se os limites do endpoint; string |
sort_by | Não | Ordem de classificação; 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/"Detalhes da vaga
web_v2-get_job_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/detail
Preço por requisição bem-sucedida: $0.05 (50000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
url | Sim | URL completo do LinkedIn; string |
include_skills | Não | Incluir competências exigidas; boolean; Valor padrão: false |
include_hiring_team | Não | Incluir equipe de contratação; boolean; Valor padrão: 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/"Busca de vagas
web_v2-search_jobs
GET https://api.apihop.ai/v1/linkedin/web-v2/jobs/search
Preço por requisição bem-sucedida: $0.05 (50000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
keywords | Não | Palavras-chave; string |
geo_code | Não | ID geográfico; 92000000 significa mundial; integer; Identificador inteiro exato |
date_posted | Não | Filtro por data de publicação; string; Any time, Past month, Past week, Past 24 hours |
experience_levels | Não | Níveis de experiência; string[]; Chave de consulta repetida; Internship, Entry level, Associate, Mid-Senior level, Director, Executive |
company_ids | Não | IDs de empresas; integer[]; Chave de consulta repetida; Identificador inteiro exato |
title_ids | Não | IDs de cargos; integer[]; Chave de consulta repetida; Identificador inteiro exato |
onsite_remotes | Não | Tipos de local de trabalho; string[]; Chave de consulta repetida; On-site, Remote, Hybrid |
functions | Não | Funções profissionais; string[]; Chave de consulta repetida |
industries | Não | Setores; string[]; Chave de consulta repetida |
job_types | Não | Tipos de emprego; string[]; Chave de consulta repetida; Full-time, Part-time, Contract, Temporary, Internship, Volunteer |
sort_by | Não | Ordem de classificação; string; Most relevant, Most recent |
easy_apply | Não | Somente candidatura simplificada; boolean; Valor padrão: false |
under_10_applicants | Não | Somente menos de 10 candidatos; boolean; Valor padrão: false |
start | Não | Deslocamento; aplicam-se os limites do 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"Detalhes da publicação
web_v2-get_post_detail
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/detail
Preço por requisição bem-sucedida: $0.008 (8000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
url | Sim | URL completo do 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"Comentários da publicação
web_v2-get_post_comments
GET https://api.apihop.ai/v1/linkedin/web-v2/posts/comments
Preço por requisição bem-sucedida: $0.05 (50000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
urn | Sim | URN de atividade da publicação; string |
sort_by | Não | Ordem de classificação; string; Most relevant, Most recent |
page | Não | Número da página a partir de 1; integer; >= 1 |
pagination_token | Não | Token de paginação; aplicam-se os limites do endpoint; string |
share_urn | Não | URN de compartilhamento de publicações compartilhadas; string |
curl --get "https://api.apihop.ai/v1/linkedin/web-v2/posts/comments" \
-H "Authorization: Bearer YOUR_API_KEY" \
--data-urlencode "urn=7267273010393358336"Criar tarefa de perfil pessoal
web_v2-create_user_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/users/profile/tasks
Preço por requisição bem-sucedida: $0.008 (8000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
url | Sim | URL completo do 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"}Criar tarefa de perfil empresarial
web_v2-create_company_profile_task
POST https://api.apihop.ai/v1/linkedin/web-v2/companies/profile/tasks
Preço por requisição bem-sucedida: $0.008 (8000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
url | Sim | URL completo do 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"}Criar tarefa de detalhes da publicação
web_v2-create_post_detail_task
POST https://api.apihop.ai/v1/linkedin/web-v2/posts/detail/tasks
Preço por requisição bem-sucedida: $0.008 (8000 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
url | Sim | URL completo do 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"}Status da tarefa
web_v2-get_task_status
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id
Preço por requisição bem-sucedida: $0 (0 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
task_id | Sim | ID de tarefa da plataforma no caminho URL; string decimal, não ID do fornecedor; string; Identificador inteiro exato |
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 da tarefa
web_v2-get_task_result
GET https://api.apihop.ai/v1/linkedin/web-v2/tasks/:task_id/result
Preço por requisição bem-sucedida: $0 (0 credits).
| Campo | Obrigatório | Contrato |
|---|---|---|
task_id | Sim | ID de tarefa da plataforma no caminho URL; string decimal, não ID do fornecedor; string; Identificador inteiro exato |
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"}Respostas
Para operações síncronas: O JSON nativo code/data e a precisão numérica são preservados. A estrutura varia por operação. HTTP 200 não basta: erros de negócio e registros de erro com error/error_code são rejeitados. Resultados vazios bem-sucedidos são cobrados. O exemplo é ilustrativo, não uma validação real.
{"code":200,"data":[]}Erros
HTTP 400: parâmetros inválidos; 401: autenticação inválida; 402: saldo insuficiente; 403: acesso ao gateway negado; 405: método não suportado; 408: cancelamento; 429: limite de frequência; 502/503/504: falha do fornecedor, configuração indisponível ou tempo esgotado. Guarde X-Request-Id para diagnóstico.
Fontes
Verificado em 2026-10-31 com a OpenAPI oficial V5.3.2 e os preços atuais dos endpoints. As fontes descrevem contrato e preços, sem comprovar testes reais bem-sucedidos de todos os endpoints.