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. This header and the host are the only changes 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)

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

The 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

The 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 history, most recent first. Every position comes back in one call, with no pagination, even for members with dozens of past employers or many roles at one employer. When a section came back incomplete, 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

Always "OUT_OF_NETWORK" in the answers we have seen. It says nothing about you: no LinkedIn account of yours is in the call.

creatorInfo
object

Creator mode information

jobTitle
string

Title of the member's primary role (the entry flagged current in experiences). The member sets it, and an end date does not clear it: if the member has not updated their profile since that role ended, jobTitle still shows it while the matching experience shows ongoing: false.

companyName
string

Employer for the role in jobTitle. currentPosition comes from the top of the member's profile instead, so it can be null while jobTitle/companyName have values.

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 has a recognised-voice badge. Absent (not false) when it doesn't, as on most profiles: treat an absent key as false. The response has no display label for the badge, because the source translates the label for each viewer.

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

True when the member has an open profile: anyone can message them without connecting or spending a paid message credit. Unrelated to openToWork, and separate from premium (some members without premium have an open profile). An absent openProfile means unknown: on some calls the key is missing and partial.sections lists openProfile. If you request the profile again, the key comes back in most cases. A memorialized account (inRemembrance true) has openProfile false, since nobody can message it. openProfile is the only status boolean whose absence means unknown.

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's self-declared industry, e.g. "Information Technology & Services". It comes from the list LinkedIn shows on profiles, which is not the list company pages use, so 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 wrote their profile in, e.g. "es_ES". The free text can be in another language: see title and description for the language you get. 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>

Always "Person". We take only a LinkedIn profile URL, so a company page never comes back.

Available options:
Person
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. Not the same as volunteerCauses, which lists the causes they say they care about.

partial
object

Present only when a read failed and part of the profile is missing. Fetchin builds a profile from several reads, and when one fails, the array that read fills holds fewer items than the profile shows. Use this field to tell whether a short list is complete.

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.