Get a LinkedIn profile

/api/v1/linkedin/profile

Get one public LinkedIn profile by profile URL, with normalized profile data and optional raw provider data.

Endpoint

  • Path: /api/v1/linkedin/profile
  • Cost: 2 credits per successful request

Query parameters

NameRequiredDescriptionExample
profile_urlYesThe full LinkedIn profile URL.https://www.linkedin.com/in/williamhgates
rawNoInclude the unchanged provider response in the raw field. Defaults to false.true
curl --get 'https://api.sociallisteningapi.com/api/v1/linkedin/profile' \
  --data-urlencode 'profile_url=https://www.linkedin.com/in/williamhgates' \
  --data-urlencode 'raw=true' \
  --header 'x-api-key: YOUR_API_KEY'

GET request using cURL.

Responses

{
  "success": true,
  "platform": "linkedin",
  "endpoint": "/api/v1/linkedin/profile",
  "data": {
    "id": "ACoAAABexample",
    "platform": "linkedin",
    "username": "alexmorgan",
    "display_name": "Alex Morgan",
    "avatar_url": "https://example.com/linkedin-avatar.jpg",
    "bio": "Building useful software for developers.",
    "verified": true,
    "followers": 25000,
    "following": null,
    "posts_count": null,
    "likes_count": null,
    "url": "https://www.linkedin.com/in/alexmorgan",
    "location": "Melbourne, Victoria, Australia",
    "external_url": "https://example.com",
    "private": null,
    "joined_at": "2023-11-07T05:31:56Z",
    "ext": {
      "headline": "Founder and software developer",
      "connections_count": 500,
      "open_to_work": false,
      "hiring": true,
      "premium": true,
      "influencer": false,
      "creator": true,
      "cover_picture_url": "https://example.com/linkedin-cover.jpg",
      "top_skills": [
        "JavaScript",
        "APIs"
      ],
      "current_positions": [],
      "education": []
    }
  },
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 1
  },
  "raw": {
    "element": {
      "id": "ACoAAABexample",
      "publicIdentifier": "alexmorgan",
      "firstName": "Alex",
      "lastName": "Morgan"
    },
    "status": "OK"
  },
  "request_id": "req_example123",
  "credits_used": 2,
  "credits_remaining": 98
}

Request completed successfully.