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
}
}
'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
}
}
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
}
})
};
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
]
]),
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 }\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 }\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 }\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,
"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": "One of profile_url, identifier, or profile_urn is required."
},
"metadata": {
"action": "get",
"account_id": "your-account-id",
"credits_consumed": 0,
"timestamp": "2026-03-24T12:00:00Z"
}
}
Profiles
Get Profile Info
Retrieve the profile information of any user.
POST
/
v2
/
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
}
}
'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
}
}
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
}
})
};
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
]
]),
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 }\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 }\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 }\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,
"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": "One of profile_url, identifier, or profile_urn is required."
},
"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.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
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.Response
boolean
Indicates whether the request was successful.
object
The profile data of the target user.
Show data properties
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.
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
{
"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,
"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": "One of profile_url, identifier, or profile_urn is required."
},
"metadata": {
"action": "get",
"account_id": "your-account-id",
"credits_consumed": 0,
"timestamp": "2026-03-24T12:00:00Z"
}
}
Was this page helpful?