LinkedIn Profile Details

Rode como Apify Actor. Envie até 5.000 URLs por run, pague só pelos perfis encontrados.

Início rápido (Apify API)

# Trigger the actor with the Apify API
curl -X POST "https://api.apify.com/v2/acts/atomus~linkedin-profile-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'

O que faz

Mande até 100 URLs públicas de perfil do LinkedIn por chamada. Recebe JSON limpo e normalizado com nome, cargo, headline, summary, empresa, localização e skills. Cada URL custa 1 crédito; erros por URL são estornados automaticamente. Nenhuma conta do LinkedIn no seu lado.

Endpoint

POST https://api.atomusapi.dev/v1/linkedin-profile-enrichment/enrich

Autenticação

Mande sua API key como Bearer token no header Authorization. As chaves são escopadas por tenant.

Authorization: Bearer atm_live_xxxxxxxxxxxxxx

Idempotency

Send Idempotency-Key: <uuid> to make a request safely retryable. Atomus stores the response for 24h and replays it on retries with the same key.

Entrada

Saída

Exemplo de request

curl -X POST "https://api.atomusapi.dev/v1/linkedin-profile-enrichment/enrich" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/in/example-1"
  }'

const res = await fetch(
  "https://api.atomusapi.dev/v1/linkedin-profile-enrichment/enrich",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      url: "https://www.linkedin.com/in/example-1",
    }),
  }
);

if (!res.ok) {
  const { error } = await res.json();
  throw new Error(`${error.code}: ${error.message}`);
}

const { data, meta } = await res.json();
if (data.status === "success") console.log(data.profile.full_name);
else if (data.status === "not_found") console.log("profile not found");
else console.error(data.code, data.message);

import requests

res = requests.post(
    "https://api.atomusapi.dev/v1/linkedin-profile-enrichment/enrich",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={"url": "https://www.linkedin.com/in/example-1"},
    timeout=10,
)

if not res.ok:
    err = res.json()["error"]
    raise RuntimeError(f"{err['code']}: {err['message']}")

data = res.json()["data"]
if data["status"] == "success":
    print(data["profile"]["full_name"])
elif data["status"] == "not_found":
    print("profile not found")
else:
    print(data["code"], data["message"])

Erros e limites

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Human-readable explanation.",
    "retryable": true,
    "request_id": "req_01HXXX..."
  }
}

• unauthenticated HTTP 401 : Header Authorization ausente ou mal formado. (não retente)
• invalid_api_key HTTP 401 : API key não reconhecida ou revogada. (não retente)
• insufficient_credits HTTP 402 : Saldo de créditos do tenant abaixo do custo da chamada. Recarregue e tente de novo. (não retente)
• invalid_input HTTP 400 : Corpo da requisição não é JSON válido ou o campo url está faltando. (não retente)
• validation_failed HTTP 422 : A url não é uma URL válida de perfil linkedin.com/in/<handle>. (não retente)
• rate_limit_exceeded HTTP 429 : Taxa sustentada de requisições excedeu o limite do tenant. (pode retentar)
• upstream_error HTTP 502 : Provedor upstream retornou uma resposta de erro. (pode retentar)
• upstream_timeout HTTP 504 : Provedor upstream não respondeu dentro do tempo limite. (pode retentar)
• internal_error HTTP 500 : Erro inesperado no servidor. (pode retentar)

Limites de taxa

4 requests/segundo por conta (compartilhado entre todas as API keys da mesma conta). Cada chamada enriquece uma URL de perfil do LinkedIn. Para enriquecer várias, paralelize as chamadas no cliente até o limite. Picos acima do limite retornam 429 rate_limit_exceeded; faça backoff usando os response headers. A janela por segundo é enforced no servidor; as linhas por minuto, hora, dia, semana e mês são derivações de throughput sustentado.

• x-ratelimit-limit: máximo de requests por segundo da conta (compartilhado entre todas as keys)
• x-ratelimit-remaining: requests restantes na janela atual
• x-ratelimit-reset: unix epoch (segundos) quando a janela reseta

Cobrança

• 1 crédito por enriquecimento bem-sucedido

Apenas respostas success são cobradas. Respostas not_found (nenhum perfil encontrado na URL) e error não consomem crédito — o crédito é reservado antes da chamada e estornado automaticamente. Cada chamada reporta o gasto em meta.credits_used e o novo saldo em meta.credits_remaining.