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.