LinkedIn Profile Details

Ejecuta como Apify Actor. Envía hasta 5.000 URLs por ejecución, paga solo por los perfiles encontrados.

Inicio 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 '{ }'

Qué hace

Manda hasta 100 URLs públicas de perfil de LinkedIn por llamada. Devuelve JSON limpio y normalizado con nombre, cargo, headline, summary, empresa, ubicación y skills. Cada URL cuesta 1 crédito; los errores por URL se reembolsan automáticamente. Sin cuenta de LinkedIn de tu lado.

Endpoint

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

Autenticación

Envía tu API key como Bearer token en el header Authorization. Las claves están limitadas a un solo 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

Salida

Ejemplo 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"])

Errores y límites

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

• unauthenticated HTTP 401 : Falta el header Authorization o está mal formado. (no reintentar)
• invalid_api_key HTTP 401 : La API key no es reconocida o ha sido revocada. (no reintentar)
• insufficient_credits HTTP 402 : El saldo de créditos del tenant está por debajo del costo de la solicitud. Recarga y reintenta. (no reintentar)
• invalid_input HTTP 400 : El cuerpo de la solicitud no es JSON válido o falta el campo url. (no reintentar)
• validation_failed HTTP 422 : La url no es una URL válida de perfil linkedin.com/in/<handle>. (no reintentar)
• rate_limit_exceeded HTTP 429 : La tasa sostenida de solicitudes superó el límite del tenant. (reintentable)
• upstream_error HTTP 502 : El proveedor upstream devolvió una respuesta de error. (reintentable)
• upstream_timeout HTTP 504 : El proveedor upstream no respondió dentro del tiempo límite. (reintentable)
• internal_error HTTP 500 : Error inesperado del servidor. (reintentable)

Límites de tasa

4 requests/segundo por cuenta (compartido entre todas las API keys de la misma cuenta). Cada llamada enriquece una URL de perfil de LinkedIn. Para enriquecer varias, paraleliza las llamadas en el cliente hasta el límite. Picos por encima del límite devuelven 429 rate_limit_exceeded; haz backoff usando los response headers. La ventana por segundo se aplica en el servidor; las filas por minuto, hora, día, semana y mes son derivaciones de throughput sostenido.

• x-ratelimit-limit: máximo de requests por segundo de la cuenta (compartido entre todas las keys)
• x-ratelimit-remaining: requests restantes en la ventana actual
• x-ratelimit-reset: unix epoch (segundos) cuando la ventana se reinicia

Facturación

• 1 crédito por enriquecimiento exitoso

Solo las respuestas success se cobran. Las respuestas not_found (no se encontró perfil en la URL) y error no consumen crédito — el crédito se reserva antes de la llamada y se reembolsa automáticamente. Cada llamada reporta el gasto en meta.credits_used y el nuevo saldo en meta.credits_remaining.