Skip to content

Profile

GET/v1/linkedin/profile1 credit

Returns a person's public LinkedIn profile: name, photo, location, follower and connection counts, about text, experience, education, articles, recent posts, recommendations and similar profiles.

01Query parameters

NameTypeDescription
urlrequiredstringThe profile URL, e.g. `https://www.linkedin.com/in/williamhgates/`.

02Request

curl "https://api.scrapesocial.ai/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates%2F" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates%2F

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "name": "Bill Gates",
  "image": "https://media.licdn.com/dms/image/v2/D5603AQF-RYZP55jmXA/profile-displayphoto-shrink_200_200/B56ZRi8g.aGsAY-/0/1736826818802?e=2147483647&v=beta&t=bKWfN6UwwtiCqFWsG7rBELbd48qJOAMLdxhBzzkJV0k",
  "location": "Seattle, Washington, United States",
  "followers": 40751930,
  "connections": "8",
  "about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
  "recentPosts": [
    {
      "link": "https://www.linkedin.com/posts/williamhgates_bill-gates-says-to-prepare-for-20-years-of-activity-7519483868391956480-KCgz",
      "id": "7519483868391956480",
      "title": "AI is the most profound technology I’ve seen, both in its ability to help people and to disrupt their lives. I’m optimistic about the good it can do, but we need to take its risks seriously. The level of action we are seeing doesn’t yet match what’s at stake.",
      "datePublished": "2026-10-23T19:44:19.477Z",
      "activityType": "Post"
    },
    {
      "link": "https://www.linkedin.com/posts/williamhgates_in-1988-polio-paralyzed-350000-children-activity-7519169780654714880-taX5",
      "id": "7519169780654714880",
      "title": "In 1988, polio paralyzed 350,000 children a year and was endemic in 125 countries. Because of partnerships like the Global Polio Eradication Initiative (GPEI), we’re down to two polio endemic countries. But RAMESH FERRIS isnt satisfied—and he won’t stop fighting and advocating until he sees the end of polio in his lifetime.",
      "datePublished": "2026-10-22T22:56:15.126Z",
      "activityType": "Post"
    }
  ],
  "experience": [
    {
      "@type": "Organization",
      "name": "Gates Foundation",
      "url": "https://www.linkedin.com/company/gates-foundation",
      "member": {
        "@type": "OrganizationRole",
        "startDate": 2000
      }
    },
    {
      "@type": "Organization",
      "name": "Breakthrough Energy ",
      "url": "https://www.linkedin.com/company/breakthrough-energy",
      "member": {
        "@type": "OrganizationRole",
        "startDate": 2015
      }
    }
  ],
  "articles": [
    {
      "headline": "6 things you should know on World Polio Day",
      "author": "Bill Gates",
      "datePublished": "2026-10-24T15:54:10.000+00:00",
      "url": "https://www.linkedin.com/pulse/6-things-you-should-know-world-polio-day-bill-gates-ycree",
      "image": "https://media.licdn.com/dms/image/v2/D4E12AQGy6pQI3vMmVQ/article-cover_image-shrink_720_1280/B4EaFumG73HoAQ-/0/1792856849611?e=2147483647&v=beta&t=2QmmumsGYgIaGVcztnLlWnXPZtyFMqHl9yIm81SSYrg",
      "articleBody": ""
    },
    {
      "headline": "For an affordable climate win, look to the sky",
      "author": "Bill Gates",
      "datePublished": "2026-10-12T20:10:59.000+00:00",
      "url": "https://www.linkedin.com/pulse/affordable-climate-win-look-sky-bill-gates-eoj7e",
      "articleBody": ""
    }
  ],
  "activity": [],
  "education": [
    {
      "@type": "EducationalOrganization",
      "name": "Harvard University",
      "url": "https://www.linkedin.com/school/harvard-university/",
      "member": {
        "@type": "OrganizationRole",
        "startDate": 1973,
        "endDate": 1975
      }
    }
  ],
  "publications": [],
  "projects": [],
  "recommendations": [],
  "similarProfiles": [
    {
      "link": "https://www.linkedin.com/in/melindagates",
      "name": "Melinda French Gates",
      "image": "https://media.licdn.com/dms/image/v2/D5603AQEnhirBBhb5kg/profile-displayphoto-shrink_400_400/B56ZSvzPngHQAo-/0/1738116234633?e=2147483647&v=beta&t=CJsw_1nBY752oUvhnHiyi_9w1PlcCFX57XArUwG-UTQ"
    },
    {
      "link": "https://www.linkedin.com/in/tyleralterman",
      "name": "Tyler Alterman",
      "image": "https://media.licdn.com/dms/image/v2/D4D03AQHicg8rnDPxbQ/profile-displayphoto-shrink_400_400/profile-displayphoto-shrink_400_400/0/1697125959281?e=2147483647&v=beta&t=koiklkCOBUyMZu-fLcEnUBpGJe982FNl1vKIXsYrang"
    }
  ]
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Only what the public profile page shows is returned. `activity`, `publications` and `projects` are always empty lists, and `recentPosts[].activityType` is always `Post`. LinkedIn hides some members' profiles from the public and answers them exactly like a profile that does not exist, so both are a free 404 (`Profile not found or not publicly available`). A URL that is not a profile URL is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

  • 400missing_parameter

    A required parameter is missing or invalid.

  • 403private_account

    The account is private or age-restricted.

  • 404not_found

    No such account.

  • 503upstream_error

    The platform did not answer; retry shortly.