Get profile information

Fetch profile details using profile URL or URN. Consumes 1 credit, or 2 with fullProfile=true (the second credit when at least one of the two extra pages was read); 1 rate-limit unit either way.

get/api/v1/profile

Request

Base URL: https://api.fetchin.io
URL: https://api.fetchin.io/api/v1/profile
Auth: API key in header X-API-Key

Query parameters

profileUrlOrUrnstring required

Example:urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc

The professional 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.

fullProfileboolean

Also read two further pages of the member's profile. The detailed experience page adds experiences[].workplaceType (where each role was performed, on the roles where the member stated it) and relatedProfiles (the profiles the source suggests alongside this one); the profile-details panel adds verifications (what the member has verified). Costs 2 credits instead of 1 and still 1 rate-limit unit. The second credit is charged when at least one of the two extra pages was read, and partial.sections then names whichever fields are missing; it costs 1 only when neither page could be read, and the rest of the profile is unaffected either way. An organization URL costs 1 (it has neither page). The balance is checked against 2 before the call runs, so with 1 credit left the call returns 402. The experience list is read up to 50 top-level entries (successive roles at one employer count as one); past that, partial.sections names workplaceType and retrying will not change it. Accepts true/1 and false/0 in any letter case; omitted or empty means false; any other value, or the parameter sent twice, returns 400 INVALID_PARAMETER at no cost.

Response

Successfully fetched profile

idstring

Profile URN (unique identifier)

firstNamestring

lastNamestring

Profile last name. Some members restrict their full surname to their own contacts; for those profiles this is the publicly displayed initial (e.g. "D.") and lastNameInitialOnly is true. The full surname is not available through any request in that case.

lastNameInitialOnlyboolean

Present and true only when lastName is an initial because the member restricts it. Absent otherwise, never false.

titlestring

Professional headline. A member can publish their profile in several languages and the source does not translate between them. This is the English version when the member published one, otherwise the version in their primaryLocale. Deterministic: two calls return the same language. Every version they did publish is in titleLocalized / descriptionLocalized.

titleLocalizedobject

title in each language the member published, keyed by locale ("fr_FR", "en_US").

descriptionstring

About/summary section. A member can publish their profile in several languages and the source does not translate between them. This is the English version when the member published one, otherwise the version in their primaryLocale. Deterministic: two calls return the same language. Every version they did publish is in titleLocalized / descriptionLocalized. Line breaks are returned exactly as the source stores them: for some profiles the source holds this text with its line breaks already removed, and they are not reconstructed by guesswork.

descriptionLocalizedobject

description in each language the member published, keyed by locale.

locationstring

profilePictureUrlstring

Profile picture URL, largest size available. Always a string: when the member has no photo of their own it holds a generic placeholder image and profilePictureUrls is absent.

volunteerCausesstring[]

Volunteer causes listed on the profile

coverImageUrlstring

Profile banner/background image URL

publicIdentifierstring

Public identifier (slug)

profileIdstring

Member identifier

countryCodestring

ISO country code

geoLocationNamestring

Full geographic location string

geoCountryNamestring

Country name

geoUrnstring

Geo URN

connectionTypestring

Relationship to the authenticated account

jobTitlestring

Title of the member DESIGNATED PRIMARY role (the same entry flagged current in experiences). A designation, not a date test: if the member has not updated their profile since that role ended, jobTitle still reflects it while the matching experience shows ongoing:false.

companyNamestring

Employer of that same designated role. Same caveat as jobTitle. Derived from the position itself, whereas currentPosition reflects the block the member chooses to DISPLAY at the top of their profile - so currentPosition can be null while jobTitle/companyName are set.

companyPublicIdstring

Current company public identifier slug

companyLinkedinUrlstring

Current company profile URL

followerCountnumber

Number of followers

connectionsCountnumber

Number of connections

creatorboolean

Whether Creator mode is enabled

influencerboolean

Whether the profile carries the platform's long-standing editorial recognition. Distinct from topVoice: a profile can have one without the other.

topVoiceboolean

Present and true when the profile carries a recognised-voice badge. ABSENT (not false) when it does not, which is the case for most profiles — treat an absent key as falsy. The badge's display label is not returned because the source translates it per reading session.

premiumboolean

Whether the profile has Premium

isVerifiedboolean

Whether the profile has a verification badge

memberIdstring

Numeric internal member id (e.g. "251749025"). Distinct from id/profileId, which carry the urn:li:fsd_profile:… form.

openToWorkboolean

Whether the profile shows the public #OPEN_TO_WORK photo frame. Reflects the publicly visible badge only; recruiter-only 'open to work' is not exposed.

hiringboolean

Whether the profile shows the public #HIRING photo frame. A profile picture carries one frame at most, so hiring and openToWork are never both true.

inRemembranceboolean

Whether the account has been officially memorialized ('In Remembrance'). Only a memorialized account returns true: a regular profile whose headline mentions the member has passed away returns false.

openProfileboolean

Whether the member runs an open profile: anyone can message them directly without being one of their connections, and without spending a paid message credit. Unrelated to openToWork, and not the same as premium (some non-premium members are reachable this way). An ABSENT openProfile means unknown, never false: on a small share of calls it cannot be determined, the key is omitted and partial.sections includes openProfile; requesting the profile again normally returns it. A memorialized account (inRemembrance true) always returns false, since nobody can message it. It is the only status boolean that can be absent on a person profile.

urlstring

Canonical public URL of the professional profile page

pronounstring

Publicly displayed pronouns (e.g. "she/her"). Omitted when the member doesn't display pronouns.

industrystring

The member self-declared industry, e.g. "Information Technology & Services". Uses the industry vocabulary the profile page itself displays, which is NOT the same list as the industry field on the company endpoint - do not join the two. Omitted when the member lists none.

industryUrnstring

Stable identifier for industry, e.g. "urn:li:fsd_industry:96".

primaryLocalestring

The language the member AUTHORED their profile in, e.g. "es_ES". It does not by itself say which language the free text beside it is in - see title and description. For language-independent values use geoUrn, industryUrn or companyId.

supportedLocalesstring[]

Every language the member published their profile in, e.g. ["fr_FR","en_US"]. A member who wrote their profile once gets a single-entry array, so more than one entry is the signal that titleLocalized / descriptionLocalized have something to choose from.

entityType'Person' | 'Company'

"Person" for a member profile. "Company" when an organization identifier was supplied: a company, school or showcase URL is accepted here for backward compatibility and returns a REDUCED record (organization name in firstName, tagline in title, empty experiences/educations). Prefer GET /api/v1/company for organizations.

Example response

{
  "id": "urn:li:fsd_profile:ACoAAABCDEF",
  "experiences": [
    {
      "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392598211)",
      "company": {
        "companyId": "8736",
        "urn": "urn:li:fsd_company:8736"
      }
    }
  ],
  "educations": [
    {
      "educationUrn": "urn:li:fsd_profileEducation:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,157656829)"
    }
  ],
  "currentPosition": {
    "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392598211)",
    "title": "Co-chair",
    "name": "Gates Foundation",
    "companyId": "8736",
    "companyUrn": "urn:li:fsd_company:8736",
    "publicIdentifier": "gates-foundation",
    "url": "https://www.linkedin.com/company/gates-foundation/"
  },
  "currentSchool": {
    "educationUrn": "urn:li:fsd_profileEducation:(ACoAABESIloBBibfTXhrzlOSTVNOHzLIIbQoDWw,363452424)",
    "name": "ESILV - Ecole Supérieure d'Ingénieurs Léonard de Vinci",
    "schoolId": "42867",
    "schoolUrn": "urn:li:fsd_school:42867",
    "companyId": "15142508",
    "publicIdentifier": "esilvparis",
    "url": "https://www.linkedin.com/school/esilvparis/"
  },
  "memberId": "251749025",
  "birthDate": {
    "month": 7,
    "day": 4
  },
  "websites": [
    {
      "url": "https://www.gatesnotes.com"
    }
  ],
  "url": "https://www.linkedin.com/in/williamhgates/",
  "pronoun": "she/her",
  "relatedProfiles": [
    {
      "url": "https://www.linkedin.com/in/jane-doe/"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.