Get Profile - Fetchin API

Get LinkedIn profile information

curl --request GET \
  --url https://api.fetchin.io/api/v1/profile \
  --header 'X-API-Key: <api-key>'

{
  "id": "urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "firstName": "Bill",
  "lastName": "Gates",
  "title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
  "description": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
  "location": "Seattle, Washington, United States",
  "profilePictureUrl": "https://media.licdn.com/dms/image/...",
  "coverImageUrl": "https://media.licdn.com/dms/image/...",
  "publicIdentifier": "williamhgates",
  "profileId": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "countryCode": "US",
  "geoLocationName": "Seattle, Washington, United States",
  "geoCountryName": "United States",
  "geoUrn": "urn:li:fsd_geo:104116203",
  "connectionType": "OUT_OF_NETWORK",
  "creatorInfo": {
    "hashTags": ["#books", "#climatechange", "#healthcare", "#innovation", "#sustainability"],
    "website": "https://gatesnot.es/tgn"
  },
  "jobTitle": "Co-chair",
  "companyName": "Gates Foundation",
  "companyPublicId": "gates-foundation",
  "companyLinkedinUrl": "https://www.linkedin.com/company/gates-foundation/",
  "followerCount": 40076104,
  "connectionsCount": 8,
  "creator": true,
  "influencer": true,
  "premium": true,
  "isVerified": false,
  "experiences": [
    {
      "name": "Gates Foundation",
      "jobTitle": "Co-chair",
      "description": "",
      "dateRange": "2000 - Present",
      "timePeriod": {
        "startDate": { "year": 2000 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/gates-foundation/",
        "name": "Gates Foundation",
        "logo": "https://media.licdn.com/dms/image/..."
      }
    },
    {
      "name": "Microsoft",
      "jobTitle": "Co-founder",
      "description": "",
      "dateRange": "1975 - Present",
      "timePeriod": {
        "startDate": { "year": 1975 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/microsoft/",
        "name": "Microsoft",
        "logo": "https://media.licdn.com/dms/image/..."
      }
    }
  ],
  "educations": [
    {
      "name": "Harvard University",
      "description": "",
      "dateRange": "1973 - 1975",
      "schoolLogo": "https://media.licdn.com/dms/image/...",
      "schoolUrl": "https://www.linkedin.com/school/harvard-university/",
      "timePeriod": {
        "startDate": { "year": 1973 },
        "endDate": { "year": 1975 }
      }
    }
  ],
  "skills": [],
  "languages": [],
  "certifications": [],
  "volunteerCauses": []
}

GET

api

profile

Get LinkedIn profile information

curl --request GET \
  --url https://api.fetchin.io/api/v1/profile \
  --header 'X-API-Key: <api-key>'

{
  "id": "urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "firstName": "Bill",
  "lastName": "Gates",
  "title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
  "description": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
  "location": "Seattle, Washington, United States",
  "profilePictureUrl": "https://media.licdn.com/dms/image/...",
  "coverImageUrl": "https://media.licdn.com/dms/image/...",
  "publicIdentifier": "williamhgates",
  "profileId": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "countryCode": "US",
  "geoLocationName": "Seattle, Washington, United States",
  "geoCountryName": "United States",
  "geoUrn": "urn:li:fsd_geo:104116203",
  "connectionType": "OUT_OF_NETWORK",
  "creatorInfo": {
    "hashTags": ["#books", "#climatechange", "#healthcare", "#innovation", "#sustainability"],
    "website": "https://gatesnot.es/tgn"
  },
  "jobTitle": "Co-chair",
  "companyName": "Gates Foundation",
  "companyPublicId": "gates-foundation",
  "companyLinkedinUrl": "https://www.linkedin.com/company/gates-foundation/",
  "followerCount": 40076104,
  "connectionsCount": 8,
  "creator": true,
  "influencer": true,
  "premium": true,
  "isVerified": false,
  "experiences": [
    {
      "name": "Gates Foundation",
      "jobTitle": "Co-chair",
      "description": "",
      "dateRange": "2000 - Present",
      "timePeriod": {
        "startDate": { "year": 2000 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/gates-foundation/",
        "name": "Gates Foundation",
        "logo": "https://media.licdn.com/dms/image/..."
      }
    },
    {
      "name": "Microsoft",
      "jobTitle": "Co-founder",
      "description": "",
      "dateRange": "1975 - Present",
      "timePeriod": {
        "startDate": { "year": 1975 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/microsoft/",
        "name": "Microsoft",
        "logo": "https://media.licdn.com/dms/image/..."
      }
    }
  ],
  "educations": [
    {
      "name": "Harvard University",
      "description": "",
      "dateRange": "1973 - 1975",
      "schoolLogo": "https://media.licdn.com/dms/image/...",
      "schoolUrl": "https://www.linkedin.com/school/harvard-university/",
      "timePeriod": {
        "startDate": { "year": 1973 },
        "endDate": { "year": 1975 }
      }
    }
  ],
  "skills": [],
  "languages": [],
  "certifications": [],
  "volunteerCauses": []
}

Endpoint

GET /api/v1/profile

Authentication

Include your API key in the request header:

X-API-Key: your-api-key-here

Parameters

profileUrlOrUrn

string

required

The LinkedIn profile to fetch. Accepts any of:

Profile URN, recommended for consistency: a profile’s public identifier (slug) can change over time, the URN does not. Example: urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc
Public identifier (slug), also fine. Example: williamhgates
Profile URL. Example: https://www.linkedin.com/in/williamhgates (a trailing slash makes no difference)

The slug is the last path segment of a profile URL (linkedin.com/in/<slug>). Pass just the slug, not the /in/ prefix.

Response

profile

object

LinkedIn profile information

Show Profile object

string

LinkedIn profile URN (unique identifier)

firstName

string

Profile first name

lastName

string

Profile last name

title

string

Professional headline

description

string

About/summary section

location

string

Geographic location

profilePictureUrl

string

Profile picture URL

coverImageUrl

string

Profile banner/background image URL (optional, not all profiles have one)

publicIdentifier

string

LinkedIn public identifier (slug), e.g. “williamhgates”

profileId

string

LinkedIn member identifier, e.g. “ACoAAA8BYqEBCGLg_vT…”

countryCode

string

ISO country code, e.g. “US”, “FR”

geoLocationName

string

Full geographic location string, e.g. “Paris, Île-de-France, France”

geoCountryName

string

Country name, e.g. “United States”, “France”

geoUrn

string

LinkedIn geo URN, e.g. “urn:li:fsd_geo:104116203”

connectionType

string

Relationship to the authenticated account, e.g. “OUT_OF_NETWORK”, “CONNECTED”

jobTitle

string

Current job title, e.g. “Co-chair”, “CEO”

companyName

string

Current company name, e.g. “Gates Foundation”

companyPublicId

string

Current company LinkedIn slug, e.g. “gates-foundation”

companyLinkedinUrl

string

Current company LinkedIn URL

followerCount

number

Number of followers

connectionsCount

number

Number of connections

creator

boolean

Whether the profile has LinkedIn Creator mode enabled

influencer

boolean

Whether the profile is a LinkedIn Influencer

premium

boolean

Whether the profile has a LinkedIn Premium subscription

isVerified

boolean

Whether the profile has a LinkedIn verification badge

creatorInfo

object

Creator mode information (only present if profile has creator mode)

Show CreatorInfo object

hashTags

array

Creator hashtags, e.g. [“#books”, “#climatechange”]

website

string

Creator website URL (null if not set)

experiences

array

Work experience history

Show Experience object

name

string

Company name

jobTitle

string

Job title/role

description

string

Role description

dateRange

string

Date range (e.g., “Sep 2016 - Sep 2019”)

locationName

string

Job location (e.g., “Paris, Île-de-France, France”)

employmentType

string

Employment type (e.g., “Freelance”, “Part-time”)

timePeriod

object

Structured time period with startDate and endDate

totalDuration

string

Duration string (e.g., “3 yrs 1 mo”)

company

object

Company details

Show Company object

name

string

Company name

url

string

Company LinkedIn URL

logo

string

Company logo image URL

educations

array

Education history

Show Education object

name

string

School/University name

description

string

Degree type and field of study combined

dateRange

string

Date range (e.g., “2016 - 2019”)

degreeName

string

Degree name (e.g., “MBA”, “MSEE”, “B. Tech”)

fieldOfStudy

string

Field of study (e.g., “Materials Science and Engineering”)

schoolLogo

string

School logo image URL

schoolUrl

string

School LinkedIn URL

timePeriod

object

Structured time period with startDate and endDate

volunteerCauses

array

Volunteer causes listed on the profile (string array, e.g., [“Education”, “Science and Technology”])

skills

array

Professional skills listed on the profile

Show Skill object

name

string

Skill name, e.g. “JavaScript”, “Leadership”

languages

array

Languages listed on the profile

Show Language object

name

string

Language name, e.g. “English”, “French”

proficiency

string

Proficiency level (may be empty)

certifications

array

Licenses and certifications

Show Certification object

name

string

Certification name

authority

string

Issuing authority

dateRange

string

Date range

Example Request

curl -X GET "https://api.fetchin.io/api/v1/profile?profileUrlOrUrn=https://www.linkedin.com/in/williamhgates" \
  -H "X-API-Key: your-api-key-here"

Example Response

{
  "id": "urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "firstName": "Bill",
  "lastName": "Gates",
  "title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
  "description": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
  "location": "Seattle, Washington, United States",
  "profilePictureUrl": "https://media.licdn.com/dms/image/...",
  "coverImageUrl": "https://media.licdn.com/dms/image/...",
  "publicIdentifier": "williamhgates",
  "profileId": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "countryCode": "US",
  "geoLocationName": "Seattle, Washington, United States",
  "geoCountryName": "United States",
  "geoUrn": "urn:li:fsd_geo:104116203",
  "connectionType": "OUT_OF_NETWORK",
  "creatorInfo": {
    "hashTags": ["#books", "#climatechange", "#healthcare", "#innovation", "#sustainability"],
    "website": "https://gatesnot.es/tgn"
  },
  "jobTitle": "Co-chair",
  "companyName": "Gates Foundation",
  "companyPublicId": "gates-foundation",
  "companyLinkedinUrl": "https://www.linkedin.com/company/gates-foundation/",
  "followerCount": 40076104,
  "connectionsCount": 8,
  "creator": true,
  "influencer": true,
  "premium": true,
  "isVerified": false,
  "experiences": [
    {
      "name": "Gates Foundation",
      "jobTitle": "Co-chair",
      "description": "",
      "dateRange": "2000 - Present",
      "timePeriod": {
        "startDate": { "year": 2000 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/gates-foundation/",
        "name": "Gates Foundation",
        "logo": "https://media.licdn.com/dms/image/..."
      }
    },
    {
      "name": "Microsoft",
      "jobTitle": "Co-founder",
      "description": "",
      "dateRange": "1975 - Present",
      "timePeriod": {
        "startDate": { "year": 1975 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/microsoft/",
        "name": "Microsoft",
        "logo": "https://media.licdn.com/dms/image/..."
      }
    }
  ],
  "educations": [
    {
      "name": "Harvard University",
      "description": "",
      "dateRange": "1973 - 1975",
      "schoolLogo": "https://media.licdn.com/dms/image/...",
      "schoolUrl": "https://www.linkedin.com/school/harvard-university/",
      "timePeriod": {
        "startDate": { "year": 1973 },
        "endDate": { "year": 1975 }
      }
    }
  ],
  "skills": [],
  "languages": [],
  "certifications": [],
  "volunteerCauses": []
}

Errors

See Error Handling for the full list of error codes and recommended handling.

400 MISSING_PARAMETER / INVALID_URN
401 INVALID_API_KEY
404 PROFILE_NOT_FOUND
429 RATE_LIMITED / QUOTA_EXHAUSTED
500 INTERNAL_ERROR
503 SERVICE_UNAVAILABLE

Notes

This endpoint consumes 1 credit from your monthly quota. Failed requests (errors) do not count against your quota.

Profile data is fetched in real-time from LinkedIn. Response times may vary.

Cache profile data for frequently accessed profiles to optimize quota usage.

Use Cases

Lead enrichment

Enhance your CRM with up-to-date LinkedIn profile data

Recruitment

Build candidate profiles from LinkedIn data

Research

Analyze professional backgrounds and career paths

Verification

Verify professional credentials and work history

Authorizations

X-API-Key

string

header

required

Query Parameters

profileUrlOrUrn

string

required

The LinkedIn profile to fetch. Accepts a profile URN (recommended for consistency, since a profile's public identifier can change over time while the URN does not; example urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc), a public identifier/slug (also fine; example williamhgates), or a full profile URL (example https://www.linkedin.com/in/williamhgates; a trailing slash is ignored). The slug is the last path segment of a profile URL, so pass just the slug, not the /in/ prefix.

Example:

"urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc"

Response

Successfully fetched profile

string

LinkedIn profile URN (unique identifier)

Example:

"urn:li:fsd_profile:ACoAAABCDEF"

firstName

string

lastName

string

title

string

Professional headline

description

string

About/summary section

location

string

profilePictureUrl

string

experiences

object[]

Show child attributes

educations

object[]

Show child attributes

volunteerCauses

string[]

Volunteer causes listed on the profile

skills

object[]

Show child attributes

languages

object[]

Show child attributes

certifications

object[]

Show child attributes

coverImageUrl

string

Profile banner/background image URL

publicIdentifier

string

LinkedIn public identifier (slug)

profileId

string

LinkedIn member identifier

countryCode

string

ISO country code

geoLocationName

string

Full geographic location string

geoCountryName

string

Country name

geoUrn

string

LinkedIn geo URN

connectionType

string

Relationship to the authenticated account

creatorInfo

object

Creator mode information

Show child attributes

jobTitle

string

Current job title

companyName

string

Current company name

companyPublicId

string

Current company LinkedIn slug

companyLinkedinUrl

string

Current company LinkedIn URL

followerCount

number

Number of followers

connectionsCount

number

Number of connections

creator

boolean

Whether Creator mode is enabled

influencer

boolean

Whether the profile is a LinkedIn Influencer

premium

boolean

Whether the profile has LinkedIn Premium

isVerified

boolean

Whether the profile has a verification badge

Get Post Reactions Get Profile Reactions

​Endpoint

​Authentication

​Parameters

​Response

​Example Request

​Example Response

​Errors

​Notes

​Use Cases

Lead enrichment

Recruitment

Research

Verification

Authorizations

Query Parameters

Response

Endpoint

Authentication

Parameters

Response

Example Request

Example Response

Errors

Notes

Use Cases