LinkedIn Profile Details

Run as an Apify Actor. Submit up to 5,000 URLs per run, pay only for profiles found.

Quickstart (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 '{ }'

What it does

Send up to 100 public LinkedIn profile URLs per call. Get back clean, normalized JSON with name, title, headline, summary, company, location, and skills. Each URL is billed at one credit; per-URL errors are refunded automatically. No LinkedIn account required on your end.

Endpoint

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

Authentication

Send your API key as a Bearer token in the Authorization header. Keys are scoped to a single 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.

Input

Output

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

Errors & limits

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

• unauthenticated HTTP 401 : Missing or malformed Authorization header. (do not retry)
• invalid_api_key HTTP 401 : API key is not recognized or has been revoked. (do not retry)
• insufficient_credits HTTP 402 : Tenant credit balance is below the request cost. Top up and resend. (do not retry)
• invalid_input HTTP 400 : Request body is not valid JSON, or the url field is missing. (do not retry)
• validation_failed HTTP 422 : The url is not a valid linkedin.com/in/<handle> profile URL. (do not retry)
• rate_limit_exceeded HTTP 429 : Sustained request rate exceeded the tenant limit. (retryable)
• upstream_error HTTP 502 : Upstream provider returned a non-success response. (retryable)
• upstream_timeout HTTP 504 : Upstream provider did not respond within the time budget. (retryable)
• internal_error HTTP 500 : Unexpected server error. (retryable)

Rate limits

4 requests/second per account (shared across all API keys on the same account). Each request enriches one LinkedIn profile URL. To enrich many, parallelize requests on the client side up to the rate limit. Bursts above the limit return 429 rate_limit_exceeded; back off using the response headers. The per-second window is enforced server-side; the per-minute, per-hour, per-day, per-week, and per-month rows are sustained-throughput derivations.

• x-ratelimit-limit: max requests per second for the account (shared across all keys)
• x-ratelimit-remaining: requests remaining in the current window
• x-ratelimit-reset: unix epoch (seconds) when the window resets

Billing

• 1 credit per successful enrichment

Only success responses are billed. not_found (no profile found at the URL) and error responses are not charged — the credit is reserved up front and automatically refunded after the call. Each request reports the spend in meta.credits_used and the new balance in meta.credits_remaining.