Individual Lookup

Fetch one LinkedIn profile from a profile URL. Synchronous, returns the profile directly.

POST /profile

Costs 0.1 credit per call (10 profiles for 1 credit). Set full_profile to true for the complete profile — education, full work history, open-to-work status, skills, certifications — which costs 0.3 credit per call.

The field is person_linkedin_url. The older profile_url name is no longer accepted and returns a 422.

The separate /full_profile route has been removed. It took the same inputs, ran the same flow and charged the same 0.3 credits, so full_profile: true here is a drop-in replacement.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
person_linkedin_url	string	The LinkedIn profile URL to fetch data from.
full_profile	boolean	Optional. Default false (0.1 credit). true returns the full profile (0.3 credit).

Response

The person record sits directly under data. The same field names are used on every route that returns a person, so one piece of client code reads them all.

Field	Type	Description
person_name	string	Full name.
first_name	string	First name.
last_name	string	Last name.
current_title	string	Current job title.
headline	string	The headline on the profile.
person_linkedin_url	string	The profile URL.
organization_name	string	The company the person works at now.
company_linkedin_url	string	That company's LinkedIn page.
city	string	City.
state	string	State or region.
country	string	Country name.
country_code	string	Two-letter country code, lower case.
about	string	The About section.
open_to_work	boolean	Whether the person is open to work. null when the profile does not say.
follower_count	number	Followers.
connection_count	number	Connections.
work_experience	array	Past and present roles. Filled on a full profile.
education_history	array	Schools. Filled on a full profile.
skills	array	Listed skills.
profile_picture_url	string	Profile photo.
linkedin_id	string	LinkedIn's own identifier for the profile.
extra	object	Anything the source returned that has no name above. Present only when there is something to put in it.

See Response Format for the fields every endpoint returns.

Example

Input

{
  "api_key": "your_api_key",
  "person_linkedin_url": "https://www.linkedin.com/in/williamhgates/",
  "full_profile": false
}

Output — Basic

{
  "status": "success",
  "data": {
    "person_name": "Bill Gates",
    "first_name": null,
    "last_name": null,
    "current_title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "headline": null,
    "person_linkedin_url": "https://www.linkedin.com/in/williamhgates",
    "organization_name": "Gates Foundation",
    "company_linkedin_url": null,
    "city": "Seattle",
    "state": "Washington",
    "country": "United States",
    "country_code": "us",
    "about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft.",
    "open_to_work": null,
    "follower_count": 40527042,
    "connection_count": null,
    "work_experience": null,
    "education_history": null,
    "skills": null,
    "profile_picture_url": null,
    "linkedin_id": "williamhgates",
    "extra": {
      "posts": [
        {
          "title": "\"AIDS-free\" generation is no empty promise",
          "link": "https://www.linkedin.com/pulse/aids-free-generation-empty-promise-bill-gates-hbvue",
          "created_at": "2026-07-12T00:00:00.000Z"
        }
      ]
    }
  },
  "credits_used": 0.1,
  "credits_remaining": 4822.9,
  "success": true
}

Output — Full profile

{
  "status": "success",
  "data": {
    "person_name": "Bill Gates",
    "first_name": "Bill",
    "last_name": "Gates",
    "current_title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "person_linkedin_url": "https://www.linkedin.com/in/williamhgates",
    "organization_name": "Gates Foundation",
    "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation/",
    "city": "Seattle",
    "state": "Washington",
    "country": "United States",
    "country_code": "us",
    "about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft.",
    "open_to_work": false,
    "follower_count": 40527040,
    "connection_count": 8,
    "work_experience": [
      {
        "company_name": "Gates Foundation",
        "current_title": "Co-chair",
        "location": null,
        "start_date": "2000",
        "end_date": null,
        "is_current": true,
        "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation/",
        "description": null,
        "employment_type": null
      }
    ],
    "education_history": [
      {
        "school_name": "Harvard University",
        "degree": null,
        "field_of_study": null,
        "start_date": "1973",
        "end_date": "1975",
        "school_linkedin_url": null,
        "extra": { "period": "1973 - 1975" }
      }
    ],
    "skills": [],
    "profile_picture_url": null,
    "linkedin_id": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc"
  },
  "credits_used": 0.3,
  "credits_remaining": 4822.7,
  "success": true
}

Output — Still running

{
  "status": "processing",
  "data": null,
  "credits_used": 0,
  "credits_remaining": 4823,
  "message": "The lookup is still running and is being collected in the background. Call again shortly and the record will be returned.",
  "success": true
}

Output — Not found

{
  "status": "not_found",
  "data": null,
  "credits_used": 0,
  "credits_remaining": 4823,
  "message": "No record was returned for this input.",
  "success": true
}

Error

{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "person_linkedin_url: Field required"
  },
  "success": false
}

To enrich every contact in a list in one call instead, use List Lookup.