Skip to main content
GET
https://api.peoplecontext.com
/
v1
/
webset
/
linkedin
/
person
LinkedIn Webset
curl --request GET \
  --url https://api.peoplecontext.com/v1/webset/linkedin/person \
  --header 'Authorization: <authorization>'
{
  "first_name": "<string>",
  "middle_name": "<string>",
  "last_name": "<string>",
  "full_name": "<string>",
  "username": "<string>",
  "url": "<string>",
  "photo": "<string>",
  "headline": "<string>",
  "summary": "<string>",
  "location": {},
  "connections": 123,
  "followers": 123,
  "following": 123,
  "current_position": {},
  "experience": [
    {}
  ],
  "education": [
    {}
  ],
  "certifications": [
    {}
  ],
  "languages": [
    {}
  ],
  "skills": [
    {}
  ],
  "personal_email": {},
  "github": {},
  "last_updated": "<string>",
  "400 Bad Request": {},
  "401 Unauthorized": {},
  "429 Too Many Requests": {},
  "500 Internal Server Error": {}
}

​
Endpoint

GET /v1/webset/linkedin/person
POST /v1/webset/linkedin/person
Both GET and POST methods are supported. Use POST for batch requests or when query strings become too long.

​
Authentication

​
Authorization
string
required
Bearer token with your API key: Bearer YOUR_API_KEY
See the Authentication Guide for detailed setup instructions.

​
Request Parameters

​
Identifier (Required)

​
linkedin
string
required
LinkedIn user identifier. Can be:
  • Username/slug (e.g., taylor-jordan-lee)
  • Full profile URL (e.g., https://www.linkedin.com/in/taylor-jordan-lee)

​
Optional Parameters

​
addons
array
Additional data sources to include in the response.Available addons:
  • github - Attach GitHub profile data for users with linked accounts (~5M mappings)
  • personal_email - Attach personal email address when available
Example: addons=github,personal_email
​
must_have
array
Required fields that must be present in the profile. If any specified field is missing, returns an empty object {} and you are not charged.Multiple fields are treated as OR (profile must have at least one).Common fields:
  • experience - Must have work experience
  • education - Must have education history
  • location - Must have location data
  • current_position - Must have current employment
  • personal_email - Must have a personal email (requires addon)
Example: must_have=experience,education

​
Response

​
Success Response (200 OK)

Returns a JSON object containing the enriched LinkedIn profile.
​
first_name
string
User’s first name
​
middle_name
string
User’s middle name
​
last_name
string
User’s last name
​
full_name
string
User’s full name
​
username
string
LinkedIn username/slug
​
url
string
LinkedIn profile URL
​
photo
string
Profile photo URL
​
headline
string
LinkedIn headline/title
​
summary
string
Profile summary/about section
​
location
object
Structured location data with city, state, country, continent
​
connections
integer
Number of LinkedIn connections
​
followers
integer
Number of followers
​
following
integer
Number of people/companies followed
​
current_position
object
Current job position with summary, start date, location, and company details
​
experience
array
Array of work experience entries with role, company, dates, location, and description
​
education
array
Array of education entries with school, degrees, majors, minors, dates, and location
​
certifications
array
Array of certifications with name, issuer, credential ID, and URL
​
languages
array
Array of languages with proficiency levels
​
skills
array
Array of professional skills
​
personal_email
object
Personal email data (when addons=personal_email is specified)
​
github
object
GitHub profile data (when addons=github is specified). Includes repositories, commits, stars, issues, and full GitHub profile information.
​
last_updated
string
When this profile was last enriched (ISO 8601)

​
No Match Response (200 OK)

When no matching profile is found or required fields are missing: 
{}

​
Error Responses

​
400 Bad Request
error
Missing required parameters or invalid parameter values
​
401 Unauthorized
error
Invalid or missing API key
​
429 Too Many Requests
error
Rate limit exceeded
​
500 Internal Server Error
error
Server error occurred

​
Examples

curl -X GET "https://api.peoplecontext.com/v1/webset/linkedin/person?linkedin=taylor-jordan-lee&addons=github,personal_email" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Sample Response

{
  "first_name": "Taylor",
  "middle_name": "Jordan",
  "last_name": "Lee",
  "full_name": "Taylor Jordan Lee",
  "username": "taylor-jordan-lee",
  "url": "https://www.linkedin.com/in/taylor-jordan-lee",
  "photo": "https://images.example.com/linkedin/taylor.jpg",
  "headline": "Senior Product Manager at Nimbus Analytics",
  "summary": "Product manager focused on analytics platforms and data products.",
  "location": {
    "city": "London",
    "state": "England",
    "country": "United Kingdom",
    "continent": "Europe"
  },
  "connections": 1200,
  "followers": 1500,
  "following": 600,
  "current_position": {
    "summary": "Senior Product Manager at Nimbus Analytics",
    "start": "2022-04-01",
    "location": {
      "city": "London",
      "state": "England",
      "country": "United Kingdom",
      "continent": "Europe"
    },
    "company": {
      "name": "Nimbus Analytics",
      "linkedin_url": "https://www.linkedin.com/company/nimbus-analytics"
    }
  },
  "experience": [
    {
      "summary": "Senior Product Manager at Nimbus Analytics",
      "start": "2022-04-01",
      "end": null,
      "current": true,
      "location": {
        "city": "London",
        "state": "England",
        "country": "United Kingdom",
        "continent": "Europe"
      },
      "company": {
        "name": "Nimbus Analytics",
        "linkedin_url": "https://www.linkedin.com/company/nimbus-analytics"
      }
    },
    {
      "summary": "Product Manager at DataFlow Inc",
      "start": "2019-06-01",
      "end": "2022-03-31",
      "current": false,
      "company": {
        "name": "DataFlow Inc"
      }
    }
  ],
  "education": [
    {
      "summary": "MSc in Data Science",
      "start": "2016-09-01",
      "end": "2018-06-01",
      "current": false,
      "location": {
        "city": "Edinburgh",
        "state": "Scotland",
        "country": "United Kingdom",
        "continent": "Europe"
      },
      "degrees": ["MSc"],
      "minors": ["Statistics"],
      "majors": ["Data Science"],
      "school": {
        "name": "University of Edinburgh",
        "linkedin_url": "https://www.linkedin.com/school/the-university-of-edinburgh"
      }
    }
  ],
  "certifications": [
    {
      "credential_id": "CERT-67890",
      "credential_url": "https://certs.example.com/cert/CERT-67890",
      "issuer": "Product Institute",
      "name": "Certified Product Manager"
    }
  ],
  "languages": [
    {
      "proficiency": "Native",
      "language": "English"
    },
    {
      "proficiency": "Professional",
      "language": "French"
    }
  ],
  "skills": [
    { "skill": "Product Management" },
    { "skill": "Analytics" },
    { "skill": "Stakeholder Management" },
    { "skill": "SQL" },
    { "skill": "Python" }
  ],
  "personal_email": {
    "email": "[email protected]"
  },
  "github": {
    "username": "taylor-lee",
    "url": "https://github.com/taylor-lee",
    "bio": "Engineer turned product manager. Still writes code for fun.",
    "public_repos": 24,
    "repos": [
      {
        "full_name": "taylor-lee/feature-flags-service",
        "language": "Go",
        "description": "Simple feature flag service for experiments.",
        "stargazers_count": 5
      }
    ]
  },
  "last_updated": "2025-09-01T00:00:00Z"
}

​
Best Practices

Use must_have to optimize costs: Only pay for profiles that meet your requirements. For example, must_have=experience ensures you only get charged for profiles with work history.
Rate Limits: API requests are subject to rate limits based on your plan. If you need higher limits, contact [email protected].
Data Freshness: LinkedIn data is refreshed as frequently as possible from our data provider. Check the last_updated field to see when a profile was last enriched.