API de dados do LinkedIn | Documentação de APIs

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

http

Authorization: Bearer YOUR_API_KEY

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.

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

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.

Referência completa

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.

json

{"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.

TikHub · OpenAPI · Preços