Get a LinkedIn profile

Try in Playground

Public profile as LinkedIn publishes it: name, photo, location, follower count, connection bucket, about text, recent posts, experience, articles, education, publications, projects, recommendations and similar profiles. Job titles and descriptions are returned exactly as the public page shows them.

GET/v1/linkedin/profilex-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

urlstringrequiredquery

Public profile URL such as https://www.linkedin.com/in/handle. Regional hosts and trailing slashes are accepted; query strings are dropped.

min 1 chars · max 500 chars

Examplehttps://www.linkedin.com/in/parrsam

Response fields

requestIdstring

Operational correlation UUID.

Upstream attempts (including proxy retries), decoded success-body bytes and duration.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable data is returned.

statusenum

success or partial; failed/challenged on errors.

one of: success, partial

sourceUrlstring

Canonical www.linkedin.com page read.

absolute HTTPS URL

fetchedAtstring

UTC retrieval time.

Source is always public_page. Warnings list bounded or unavailable sections.

coverage.sourceenum

Always included.

one of: public_page, web_search

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

namestring

Display name.

imagestringnullable

Profile photo URL or null.

locationstringnullable

Locality string from the structured address, or null.

followersnumbernullable

Follower count from structured data, or null.

connectionsstring

Connection bucket shown on the page, e.g. 500+; empty when absent.

aboutstringnullable

About/summary text or null.

recentPostsobject[]

Posts LinkedIn embeds as structured data: link, id, title (post text), datePublished and activityType.

up to 100 items

experienceobject[]

Structured worksFor entries exactly as published.

up to 100 items

articlesobject[]

Published articles with headline, author, datePublished, url and cover image; articleBody is empty on profile pages.

up to 100 items

activityobject[]

Always empty on current public profiles; kept for shape stability.

up to 100 items

educationobject[]

Structured alumniOf entries exactly as published.

up to 100 items

publicationsobject[]

Publication name and destination URL decoded from the LinkedIn redirect.

up to 100 items

projectsobject[]

Projects with name, first link, date range, description and contributors.

up to 100 items

recommendationsobject[]

Recommendations received with name, profile link and quoted text.

up to 100 items

similarProfilesobject[]

Other similar profiles listed on the page with link, name and image.

up to 100 items

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
400	`invalid_request`	Not a public LinkedIn profile, company or post URL, or invalid parameters.
401	`unauthorized`	Invalid worker key.
403	`restricted`	LinkedIn redirected to a login page for this resource.
404	`not_found`	The page does not exist or the search returned no posts.
429	`upstream_rate_limited`	LinkedIn or the search index throttled retrieval.
502	`upstream_challenged`	LinkedIn answered with a challenge (HTTP 999/403 or an auth wall), including through the proxy.
502	`upstream_error` `unsupported_page` `unsafe_redirect` `search_failed`	Source or search index did not return a usable page.
503	`search_unavailable` `busy`	No search key configured, or all retrieval slots are busy.
504	`timeout`	The operation exceeded its deadline.

Code example

curl "https://api.scrapeatlas.com/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fparrsam" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fparrsam",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fparrsam",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`LinkedIn request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/linkedin/profile",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://www.linkedin.com/in/parrsam"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fparrsam", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fparrsam"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://www.linkedin.com/in/example-person",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 550000,
    "durationMs": 1800
  },
  "name": "Example Person",
  "image": "https://media.licdn.com/dms/image/v2/example/profile-displayphoto-shrink_200_200",
  "location": "New York City Metropolitan Area",
  "followers": 90898,
  "connections": "500+",
  "about": "Founder of things.",
  "recentPosts": [
    {
      "link": "https://www.linkedin.com/posts/example-person_first-post-activity-7503877944663068672-jGYW",
      "id": "7503877944663068672",
      "title": "First post text.",
      "datePublished": "2026-09-10T18:11:57.261Z",
      "activityType": "Post"
    }
  ],
  "experience": [
    {
      "@type": "Organization",
      "name": "Example Co",
      "url": "https://www.linkedin.com/company/example-co",
      "location": "Example City",
      "member": {
        "@type": "OrganizationRole",
        "description": "******* ** * ******"
      }
    }
  ],
  "articles": [
    {
      "headline": "Notes on building",
      "author": "Example Person",
      "datePublished": "2026-06-04T15:47:48.000+00:00",
      "url": "https://www.linkedin.com/pulse/notes-on-building-example-person",
      "image": "https://media.licdn.com/dms/image/v2/example/article-cover_image-shrink_720_1280",
      "articleBody": ""
    }
  ],
  "activity": [],
  "education": [
    {
      "@type": "EducationalOrganization",
      "name": "Example University",
      "url": "https://www.linkedin.com/school/example-university/",
      "member": {
        "@type": "OrganizationRole",
        "startDate": 2008,
        "endDate": 2012
      }
    }
  ],
  "publications": [
    {
      "name": "A press mention",
      "url": "http://press.example.test/story.html&urlhash=AbCd"
    }
  ],
  "projects": [
    {
      "name": "Example Project",
      "url": "http://project.example.test/",
      "dateRange": "Mar 2013 - Present",
      "description": "A project description.",
      "contributors": [
        {
          "name": "Contributor One",
          "link": "https://www.linkedin.com/in/contributor-one"
        }
      ]
    }
  ],
  "recommendations": [
    {
      "name": "Recommender Name",
      "link": "https://www.linkedin.com/in/recommender",
      "text": "“A glowing recommendation.”"
    }
  ],
  "similarProfiles": [
    {
      "link": "https://ca.linkedin.com/in/similar-person",
      "name": "Similar Person",
      "image": "https://media.licdn.com/dms/image/v2/example/profile-displayphoto-scale_400_400"
    }
  ]
}

Not a public LinkedIn profile, company or post URL, or invalid parameters.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}