Skip to main content
GET
curl

Authorizations

Authorization
string
header
required

Your API key: Authorization: Bearer <your API key>. Authorization: Token <your API key> works too.

Headers

X-Data-Provider
enum<string>
default:fetchin
required

names the provider: fetchin. With the host, the only change from the provider's own request.

Available options:
fetchin

Query Parameters

profileUrlOrUrn
string
required

The profile's LinkedIn URL, e.g. https://www.linkedin.com/in/williamhgates. The only Fetchin parameter Datacircle passes on, and only as a profile URL: Fetchin's public identifier and URN forms, and fullProfile, are refused with a 400, not charged.

Response

Fetchin's answer plus datacircle_meta: the profile ($0.001485)

Fetchin's answer: the profile object as Fetchin sends it, plus datacircle_meta.

datacircle_meta
object
required

Datacircle's only addition to the provider's answer

id
string

Profile URN (unique identifier)

firstName
string

Profile first name.

lastName
string

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.

lastNameInitialOnly
boolean

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

title
string

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.

titleLocalized
object

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

description
string

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.

descriptionLocalized
object

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

location
string

Where the member is, as the profile shows it.

profilePictureUrl
string

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.

profilePictureUrls
object[]

Every size of the profile picture, smallest first, one entry per distinct size (how many varies: a small original comes in fewer sizes); the last entry is the image profilePictureUrl points to (the framed picture when the member displays a photo frame). ABSENT, not empty and not null, when the member has no photo of their own, which is how to tell a real photo from the placeholder in profilePictureUrl. Not returned for organization records.

experiences
object[]

Complete work experience history, ordered most recent first. Every position is returned in a single call - there is no pagination to follow, including for members with dozens of past employers and for members holding many successive roles at the same one. If a section could not be completed, the top-level partial object names it.

educations
object[]

The schools, newest first.

volunteerCauses
string[]

Volunteer causes listed on the profile

skills
object[]

Professional skills listed on the profile. Complete list, returned in the same single call as the rest of the profile.

languages
object[]

The languages the member lists.

certifications
object[]

Licenses and certifications.

coverImageUrl
string

Profile banner/background image URL

coverImageUrls
object[]

Every size of the banner image, smallest first. Banners are not square, so use both width and height. Absent when the member has no banner, in which case coverImageUrl is absent too.

publicIdentifier
string

Public identifier (slug)

profileId
string

Member identifier

countryCode
string

ISO country code

geoLocationName
string

Full geographic location string

geoCountryName
string

Country name

geoUrn
string

Geo URN

connectionType
string

Relationship to the authenticated account

creatorInfo
object

Creator mode information

jobTitle
string

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.

companyName
string

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.

companyPublicId
string

Current company public identifier slug

companyLinkedinUrl
string

Current company profile URL

currentPosition
object | null

Explicit "current company" block from the top of the profile page. Object when the member displays it, null when they don't (an ongoing primary position may still exist in experiences).

currentSchool
object | null

Explicit "education" block from the top of the profile page. Object when the member displays it, null when they don't.

followerCount
number

Number of followers

connectionsCount
number

Number of connections

creator
boolean

Whether Creator mode is enabled

influencer
boolean

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

topVoice
boolean

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.

premium
boolean

Whether the profile has Premium

isVerified
boolean

Whether the profile has a verification badge

memberId
string

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

openToWork
boolean

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.

hiring
boolean

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.

inRemembrance
boolean

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.

openProfile
boolean

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.

joinDate
object

Approximate account creation date (month + year).

birthDate
object

The member's birthday, only when their privacy settings make it visible to us; absent when they hide it or never entered it. Members choose who can see it, so one who limits it to a narrower audience may appear on some calls and not on others. Included in every call at no extra cost. Always a month and a day; the year only when the member shares it, which is rare.

websites
object[]

The websites listed in the member's contact info, only when their privacy settings make them visible to us, in the order the member listed them. Absent (never an empty array) when there are none to show. Included in every call at no extra cost. Not the same as creatorInfo.website, the single link a creator pins to their profile.

url
string

Canonical public URL of the professional profile page

pronoun
string

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

recommendations
object[]

Recommendations received by the member. Best-effort: omitted when this section could not be fetched, empty array when the member has none.

testScores
object[]

Test scores listed on the profile

industry
string

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.

industryUrn
string

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

primaryLocale
string

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.

supportedLocales
string[]

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
enum<string>

"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.

Available options:
Person,
Company
publications
object[]

Publications listed on the profile, in display order.

projects
object[]

Projects listed on the profile, in display order.

patents
object[]

Patents listed on the profile, in display order.

honors
object[]

Honors and awards listed on the profile, in display order.

organizations
object[]

Organizations the member belongs to, in display order.

courses
object[]

Courses listed on the profile, in display order.

volunteerExperiences
object[]

Volunteering ROLES: what the member did and for whom, in display order. Distinct from volunteerCauses, which is only the list of causes they say they care about.

partial
object

Present ONLY when part of the response is knowingly incomplete; its absence means nothing was dropped. A profile is assembled from several upstream reads, and when one cannot be completed the affected array is shorter than the member real data - previously indistinguishable from a genuinely short list.

recommendationsGiven
object[]

Recommendations the member WROTE for other people. Best-effort, exactly like recommendations: an empty array means they wrote none, while an ABSENT key means the fetch failed and partial will say so. Note the named person here is the RECIPIENT, whereas in recommendations it is the author.