Get Profile Info

curl --request POST \
  --url https://api.linkupapi.com/v2/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "account_id": "<string>",
  "action": "<string>",
  "params": {
    "profile_url": "<string>",
    "identifier": "<string>",
    "profile_urn": "<string>",
    "sales_nav": true,
    "recruiter": true
  }
}
'

import requests

url = "https://api.linkupapi.com/v2/profiles"

payload = {
    "account_id": "<string>",
    "action": "<string>",
    "params": {
        "profile_url": "<string>",
        "identifier": "<string>",
        "profile_urn": "<string>",
        "sales_nav": True,
        "recruiter": True
    }
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account_id: '<string>',
    action: '<string>',
    params: {
      profile_url: '<string>',
      identifier: '<string>',
      profile_urn: '<string>',
      sales_nav: true,
      recruiter: true
    }
  })
};

fetch('https://api.linkupapi.com/v2/profiles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkupapi.com/v2/profiles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'account_id' => '<string>',
    'action' => '<string>',
    'params' => [
        'profile_url' => '<string>',
        'identifier' => '<string>',
        'profile_urn' => '<string>',
        'sales_nav' => true,
        'recruiter' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkupapi.com/v2/profiles"

	payload := strings.NewReader("{\n  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params\": {\n    \"profile_url\": \"<string>\",\n    \"identifier\": \"<string>\",\n    \"profile_urn\": \"<string>\",\n    \"sales_nav\": true,\n    \"recruiter\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v2/profiles")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params\": {\n    \"profile_url\": \"<string>\",\n    \"identifier\": \"<string>\",\n    \"profile_urn\": \"<string>\",\n    \"sales_nav\": true,\n    \"recruiter\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkupapi.com/v2/profiles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params\": {\n    \"profile_url\": \"<string>\",\n    \"identifier\": \"<string>\",\n    \"profile_urn\": \"<string>\",\n    \"sales_nav\": true,\n    \"recruiter\": true\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "public_id": "john-smith-42",
    "profile_urn": "ACoAABCgruIBcpBVBLKMJQD2Do7tIBxKFIQNvss",
    "profile_url": "https://www.linkedin.com/in/john-smith-42",
    "first_name": "John",
    "last_name": "Smith",
    "headline": "CEO @Acme | Love discussing automation, agentic tech, and data engineering",
    "location": "Greater Paris, France",
    "summary": "I have co-founded:\n- Acme (Email Finder & Verifier, www.acme.example)\n- Beta Labs (Model mapping, www.betalabs.example)\n\nIn total, over 50 jobs created.",
    "industry": "Internet",
    "experience": [
      {
        "company": "Acme",
        "title": "CEO",
        "description": "Acme is a SaaS to find and verify email addresses.",
        "start_date": "10/2022",
        "end_date": "",
        "company_url": "https://linkedin.com/company/acme",
        "company_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo_400_400/..."
      },
      {
        "company": "Beta Labs",
        "title": "Head of R&D",
        "description": "",
        "start_date": "5/2019",
        "end_date": "8/2022",
        "company_url": "https://linkedin.com/company/beta-labs",
        "company_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo_400_400/..."
      }
    ],
    "education": [
      {
        "school": "Sample University",
        "degree": "MSc",
        "field_of_study": "Management",
        "start_date": "2008",
        "end_date": "2011",
        "school_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo_400_400/..."
      },
      {
        "school": "Example Institute",
        "degree": "",
        "field_of_study": "",
        "start_date": "",
        "end_date": "",
        "school_logo_url": ""
      }
    ],
    "skills": ["Business Development", "Entrepreneurship", "Start-ups", "Team Management", "CRM"],
    "profile_picture_url": "https://media.licdn.com/dms/image/v2/.../profile-displayphoto-shrink_400_400/...",
    "isOpenToWork": false,
    "isHiring": true,
    "isPremium": true,
    "isInfluencer": false,
    "isCreator": false,
    "email": "john.smith@example.com",
    "phone": "0600000000",
    "website": "https://www.acme.example",
    "relationship": "1st degree",
    "connectionDate": "2026-05-12 12:55:48"
  },
  "metadata": {
    "action": "get",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Profile not found"
  },
  "metadata": {
    "action": "get",
    "account_id": "your-account-id",
    "credits_consumed": 0,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

POST

profiles

Get Profile Info

curl --request POST \
  --url https://api.linkupapi.com/v2/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "account_id": "<string>",
  "action": "<string>",
  "params": {
    "profile_url": "<string>",
    "identifier": "<string>",
    "profile_urn": "<string>",
    "sales_nav": true,
    "recruiter": true
  }
}
'

import requests

url = "https://api.linkupapi.com/v2/profiles"

payload = {
    "account_id": "<string>",
    "action": "<string>",
    "params": {
        "profile_url": "<string>",
        "identifier": "<string>",
        "profile_urn": "<string>",
        "sales_nav": True,
        "recruiter": True
    }
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account_id: '<string>',
    action: '<string>',
    params: {
      profile_url: '<string>',
      identifier: '<string>',
      profile_urn: '<string>',
      sales_nav: true,
      recruiter: true
    }
  })
};

fetch('https://api.linkupapi.com/v2/profiles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkupapi.com/v2/profiles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'account_id' => '<string>',
    'action' => '<string>',
    'params' => [
        'profile_url' => '<string>',
        'identifier' => '<string>',
        'profile_urn' => '<string>',
        'sales_nav' => true,
        'recruiter' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkupapi.com/v2/profiles"

	payload := strings.NewReader("{\n  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params\": {\n    \"profile_url\": \"<string>\",\n    \"identifier\": \"<string>\",\n    \"profile_urn\": \"<string>\",\n    \"sales_nav\": true,\n    \"recruiter\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v2/profiles")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params\": {\n    \"profile_url\": \"<string>\",\n    \"identifier\": \"<string>\",\n    \"profile_urn\": \"<string>\",\n    \"sales_nav\": true,\n    \"recruiter\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkupapi.com/v2/profiles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params\": {\n    \"profile_url\": \"<string>\",\n    \"identifier\": \"<string>\",\n    \"profile_urn\": \"<string>\",\n    \"sales_nav\": true,\n    \"recruiter\": true\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "public_id": "john-smith-42",
    "profile_urn": "ACoAABCgruIBcpBVBLKMJQD2Do7tIBxKFIQNvss",
    "profile_url": "https://www.linkedin.com/in/john-smith-42",
    "first_name": "John",
    "last_name": "Smith",
    "headline": "CEO @Acme | Love discussing automation, agentic tech, and data engineering",
    "location": "Greater Paris, France",
    "summary": "I have co-founded:\n- Acme (Email Finder & Verifier, www.acme.example)\n- Beta Labs (Model mapping, www.betalabs.example)\n\nIn total, over 50 jobs created.",
    "industry": "Internet",
    "experience": [
      {
        "company": "Acme",
        "title": "CEO",
        "description": "Acme is a SaaS to find and verify email addresses.",
        "start_date": "10/2022",
        "end_date": "",
        "company_url": "https://linkedin.com/company/acme",
        "company_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo_400_400/..."
      },
      {
        "company": "Beta Labs",
        "title": "Head of R&D",
        "description": "",
        "start_date": "5/2019",
        "end_date": "8/2022",
        "company_url": "https://linkedin.com/company/beta-labs",
        "company_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo_400_400/..."
      }
    ],
    "education": [
      {
        "school": "Sample University",
        "degree": "MSc",
        "field_of_study": "Management",
        "start_date": "2008",
        "end_date": "2011",
        "school_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo_400_400/..."
      },
      {
        "school": "Example Institute",
        "degree": "",
        "field_of_study": "",
        "start_date": "",
        "end_date": "",
        "school_logo_url": ""
      }
    ],
    "skills": ["Business Development", "Entrepreneurship", "Start-ups", "Team Management", "CRM"],
    "profile_picture_url": "https://media.licdn.com/dms/image/v2/.../profile-displayphoto-shrink_400_400/...",
    "isOpenToWork": false,
    "isHiring": true,
    "isPremium": true,
    "isInfluencer": false,
    "isCreator": false,
    "email": "john.smith@example.com",
    "phone": "0600000000",
    "website": "https://www.acme.example",
    "relationship": "1st degree",
    "connectionDate": "2026-05-12 12:55:48"
  },
  "metadata": {
    "action": "get",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Profile not found"
  },
  "metadata": {
    "action": "get",
    "account_id": "your-account-id",
    "credits_consumed": 0,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

Overview

Fetches detailed profile data for a specified user. You can identify the target profile using a profile URL, a public identifier, or a profile URN. WhatsApp: pass params.phone_number to get a contact’s profile, with the same fields as Get My Profile (WhatsApp).

This endpoint consumes 1 credit per request. Ignore this if you’re on per-seat pricing: usage is unlimited.

Request

string

required

Your API key for authentication.

string

required

The unique identifier of the account to use.

string

required

Must be "get".

object

Show params properties

string

required

Profile URL. Accepts a classic URL (/in/...) or a Sales Nav lead URL (/sales/lead/...). Required if identifier and profile_urn are not provided.

string

Public identifier (vanity name). Alternative to profile_url.

string

Profile URN. Alternative to profile_url.

boolean

default:false

Also return open_link (Open Profile) and inmail_eligible. Requires a Sales Navigator seat. Auto-enabled for a Sales Nav lead URL.

boolean

default:false

Read the candidate from the account’s Recruiter seat (pass the candidate’s profile_urn). See Recruiter below.

Response

boolean

Indicates whether the request was successful.

object

The profile data of the target user.

Show data properties

string

Public identifier (vanity name).

string

Unique identifier of the profile. Treat it as an opaque string and pass it back exactly as returned.

string

Canonical profile URL.

string

First name.

string

Last name.

string

Profile headline.

string

Location text.

string

About / bio section.

string

Industry associated with the profile.

array

Work experience entries. Each item: company, title, description, start_date and end_date formatted as M/YYYY (e.g. "10/2025"; end_date is "" for current roles), company_url, company_logo_url.

array

Education entries. Each item: school, degree, field_of_study, start_date, end_date (years, e.g. "2018"), school_logo_url.

array

List of skills (array of strings).

string

URL of the profile picture.

boolean

Profile displays the “Open to work” badge.

boolean

Profile displays the “Hiring” badge.

boolean

The person has a LinkedIn Premium subscription.

boolean

LinkedIn Influencer badge.

boolean

Creator mode is on.

string

Network distance between the connected account and this profile: "1st degree", "2nd degree", "3rd+ degree" or "Out of network". Same vocabulary as connection_level in Search People.

string

Date the two profiles connected (YYYY-MM-DD HH:MM:SS). Empty unless relationship is "1st degree".

string

Email from the contact info section. Only visible for 1st degree connections that share it, otherwise "".

string

Phone from the contact info section, same visibility as email.

string

Website from the contact info section, same visibility as email.

boolean

Reachable via Open Profile (free InMail). Only with sales_nav: true.

boolean

InMail can be sent (no restriction). Only with sales_nav: true.

string

Reason an InMail cannot be sent, "NO_RESTRICTION" otherwise. Only with sales_nav: true.

object

Show metadata properties

string

The action that was performed ("get").

string

The account ID used for the request.

integer

Number of credits consumed (1).

string

ISO 8601 timestamp of the response.

{
  "success": true,
  "data": {
    "public_id": "john-smith-42",
    "profile_urn": "ACoAABCgruIBcpBVBLKMJQD2Do7tIBxKFIQNvss",
    "profile_url": "https://www.linkedin.com/in/john-smith-42",
    "first_name": "John",
    "last_name": "Smith",
    "headline": "CEO @Acme | Love discussing automation, agentic tech, and data engineering",
    "location": "Greater Paris, France",
    "summary": "I have co-founded:\n- Acme (Email Finder & Verifier, www.acme.example)\n- Beta Labs (Model mapping, www.betalabs.example)\n\nIn total, over 50 jobs created.",
    "industry": "Internet",
    "experience": [
      {
        "company": "Acme",
        "title": "CEO",
        "description": "Acme is a SaaS to find and verify email addresses.",
        "start_date": "10/2022",
        "end_date": "",
        "company_url": "https://linkedin.com/company/acme",
        "company_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo_400_400/..."
      },
      {
        "company": "Beta Labs",
        "title": "Head of R&D",
        "description": "",
        "start_date": "5/2019",
        "end_date": "8/2022",
        "company_url": "https://linkedin.com/company/beta-labs",
        "company_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo_400_400/..."
      }
    ],
    "education": [
      {
        "school": "Sample University",
        "degree": "MSc",
        "field_of_study": "Management",
        "start_date": "2008",
        "end_date": "2011",
        "school_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo_400_400/..."
      },
      {
        "school": "Example Institute",
        "degree": "",
        "field_of_study": "",
        "start_date": "",
        "end_date": "",
        "school_logo_url": ""
      }
    ],
    "skills": ["Business Development", "Entrepreneurship", "Start-ups", "Team Management", "CRM"],
    "profile_picture_url": "https://media.licdn.com/dms/image/v2/.../profile-displayphoto-shrink_400_400/...",
    "isOpenToWork": false,
    "isHiring": true,
    "isPremium": true,
    "isInfluencer": false,
    "isCreator": false,
    "email": "john.smith@example.com",
    "phone": "0600000000",
    "website": "https://www.acme.example",
    "relationship": "1st degree",
    "connectionDate": "2026-05-12 12:55:48"
  },
  "metadata": {
    "action": "get",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Profile not found"
  },
  "metadata": {
    "action": "get",
    "account_id": "your-account-id",
    "credits_consumed": 0,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

Recruiter

With recruiter: true, pass the profile_urn (urn:li:ts_profile:…) of a Search People Recruiter result. You get the same shape as a search result, plus contact info when LinkedIn exposes it, summary, follower count and the seat’s own counters on that person. include_activity: true adds their recent activity.

{ "account_id": "your-account-id", "action": "get", "params": { "recruiter": true, "profile_urn": "urn:li:ts_profile:AEMAA…" } }

The Recruiter lookup only knows profile_urns (the bare AEMAA… id works too). A public identifier, a profile URL or a classic ACoAA… URN is refused with INVALID_PARAMS (400), no credit, nothing sent to LinkedIn. To read a profile by its public identifier, call this action with the LinkedIn account (the seat’s parent_account_id) instead.

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "In Recruiter mode (a Recruiter seat, or recruiter:true), profiles/get takes a candidate's profile_urn (urn:li:ts_profile:…) from profiles/search_people_recruiter, not a public identifier or profile URL. To read a profile by its public identifier or URL, call profiles/get with the LinkedIn account (account_id 69c127c37cae0494dd827286)."
  },
  "metadata": { "action": "get", "credits_consumed": 0, "timestamp": "2026-10-07T12:00:00Z" }
}

Getting Started

Accounts

Profiles

Messaging

Network

Content

Recruiting

Credits

Logs

Email Enrichment

Webhooks (Real-Time)

Get Profile Info

Overview

Request

Response

Recruiter